為什么不推薦使用BeanUtils屬性轉換工具示例詳解

更新時間：2020年07月17日 11:07:13 作者：明明如月學長

這篇文章主要介紹了為什么不推薦使用BeanUtils屬性轉換工具，本文通過示例代碼給大家詳細介紹，對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下

什么是BeanUtils工具

BeanUtils工具是一種方便我們對JavaBean進行操作的工具，是Apache組織下的產品。

BeanUtils工具一般可以方便javaBean的哪些操作？

1）beanUtils 可以便于對javaBean的屬性進行賦值。

2）beanUtils 可以便于對javaBean的對象進行賦值。

3）beanUtils可以將一個MAP集合的數(shù)據(jù)拷貝到一個javabean對象中。

1 背景

之前在專欄中講過“不推薦使用屬性拷貝工具”，推薦直接定義轉換類和方法使用 IDEA 插件自動填充 get / set 函數(shù)。

不推薦的主要理由是：

有些屬性拷貝工具性能有點差
有些屬性拷貝工具有“BUG”
使用屬性拷貝工具容易存在一些隱患（后面例子會講到）

2 示例

首先公司內部就遇到過 commons 包的 BeanUtils 進行屬性拷貝性能較差的真實案例，然后該同事?lián)Q成了 Spring 的 BeanUtils 性能好了很多，感興趣大家可以使用性能測試框架或者基準測試框架去對比，這里就不對比了。

接下來我們看 Spring 的 BeanUtils 的屬性拷貝會存在啥問題：

import lombok.Data;

import java.util.List;

@Data
public class A {
 private String name;

 private List<Integer> ids;
}

@Data
public 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);
 }
 }
}

大家運行上述示例時，會發(fā)生類型轉換異常。

打斷點可以看到，屬性拷貝之后 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;

@Mapper
public 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 實現(xiàn)類：

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)"
)
@Component
public 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 設置為非數(shù)字類型時就會報 .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;
 }
}

在編碼階段就可以非常明確地發(fā)現(xiàn)這個問題：