1. 背景
之前在專欄中講過“不推薦使用屬性拷貝工具”，推薦直接定義轉換類和方法使用 IDEA 插件自動填充 get / set 函數。
不推薦的主要理由是：
- 有些屬性拷貝工具性能有點差
- 有些屬性拷貝工具有“BUG”
- 使用屬性拷貝工具容易存在一些隐患（後面例子會講到）
2. 示例
首先公司内部就遇到過 commons 包的 BeanUtils 進行屬性拷貝性能較差的真實案例，然後該同僚換成了 Spring 的 BeanUtils 性能好了很多，感興趣大家可以使用性能測試架構或者基準測試架構去對比，這裡就不對比了。
接下來我們看 Spring 的 BeanUtils 的屬性拷貝會存在啥問題：
import lombok.Data;
import java.util.List;
@Datapublic class A { private String name;
private List<Integer> ids;} @Datapublic class B { private String name;
private List<String> ids;} import org.springframework.beans.BeanUtils;
import java.util.Arrays;
public class BeanUtilDemo { public static void main(String[] args) { A first = new A(); first.setName("demo"); first.setIds(Arrays.asList(1, 2, 3));
B second = new B(); BeanUtils.copyProperties(first, second); for (String each : second.getIds()) {// 類型轉換異常 System.out.println(each); } }} 大家運作上述示例時，會發生類型轉換異常。
打斷點可以看到，屬性拷貝之後 B 類型的 second 對象中 ids 仍然為 Integer 類型：
如果不轉換為字元串，直接進行列印，并不會報錯。
使用CGlib 在不定義Converter 的情況下也會遇到類似問題：
import org.easymock.cglib.beans.BeanCopier;
import java.util.Arrays;
public class BeanUtilDemo { public static void main(String[] args) { A first = new A(); first.setName("demo"); first.setIds(Arrays.asList(1, 2, 3));
B second = new B(); final BeanCopier beanCopier = BeanCopier.create(A.class, B.class, false); beanCopier.copy(first,second,null);
for (String each : second.getIds()) {// 類型轉換異常 System.out.println(each); } }} 同樣，問題在運作時才暴露出來。
接下來我們看下 mapstruct：
import org.mapstruct.Mapper;import org.mapstruct.factory.Mappers;
@Mapperpublic interface Converter { Converter INSTANCE = Mappers.getMapper(Converter.class);
B aToB(A car);} import java.util.Arrays;
public class BeanUtilDemo { public static void main(String[] args) { A first = new A(); first.setName("demo"); first.setIds(Arrays.asList(1, 2, 3));
B second = Converter.INSTANCE.aToB(first); for (String each : second.getIds()) {// 正常 System.out.println(each); } }} 可以成功的将 A 中
List<Integer>
轉為 B 中的
List<String>
類型。
我們看下編譯生成的 Converter 實作類：
import java.util.ArrayList;import java.util.List;import javax.annotation.Generated;import org.springframework.stereotype.Component;@Generated( value = "org.mapstruct.ap.MappingProcessor", comments = "version: 1.3.1.Final, compiler: javac, environment: Java 1.8.0_202 (Oracle Corporation)")@Componentpublic class ConverterImpl implements Converter { @Override public B aToB(A car) { if ( car == null ) { return null; } B b = new B(); b.setName( car.getName() ); b.setIds( integerListToStringList( car.getIds() ) ); return b; } protected List<String> integerListToStringList(List<Integer> list) { if ( list == null ) { return null; } List<String> list1 = new ArrayList<String>( list.size() ); for ( Integer integer : list ) { list1.add( String.valueOf( integer ) ); } return list1; }} 自動幫我們進行了轉換，我們可能沒有意識到類型并不一緻。
如果我們在 A 類中添加一個 String number 屬性，在 B 類中添加一個 Long number 屬性，使用 mapstruect 當 number 設定為非數字類型時就會報
.NumberFormatException
。
@Override public B aToB(A car) { if ( car == null ) { return null; }
B b = new B();
b.setName( car.getName() ); if ( car.getNumber() != null ) { // 問題出在這裡 b.setNumber( Long.parseLong( car.getNumber() ) ); } b.setIds( integerListToStringList( car.getIds() ) );
return b; } 使用 cglib 預設則不會映射 number 屬性，B 中的 number 為 null。
如果手動定義轉換器，使用 IDEA 插件(如 generateO2O)自動轉換：
public final class A2BConverter {
public static B from(A first) { B b = new B(); b.setName(first.getName()); b.setIds(first.getIds()); return b; }} 在編碼階段就可以非常明确地發現這個問題：
3. 結論
由于 Java 的泛型其實是編譯期檢查，編譯後泛型擦除，導緻運作時
List<Integer>
和
List<String>
都是 List 類型，可以正常指派。這就導緻在使用很多屬性映射工具時，編譯時不容易明顯的錯誤。
mapstruct 自定義了注解處理器，在編譯階段可以讀取映射雙方的泛型類型，進而進行映射。但是這種映射也很可怕，有時候我們由于粗心等原因定義錯了類型，自動幫助我們進行了轉換，會帶了很多副作用。
之前對各種屬性映射工具的性能進行了簡單的對比，結果如下：
是以慎用屬性轉換工具，如果可能建議自定義轉換類，使用 IDEA插件自動填充，效率也挺高， A 或 B 中任何屬性類型不比對，甚至删除一個屬性，編譯階段即可報錯，而且直接調用 get set 的效率也是非常高的。