本篇內(nèi)容主要講解“Java對象復(fù)制工具類有哪些”，感興趣的朋友不妨來看看。本文介紹的方法操作簡單快捷，實(shí)用性強(qiáng)。下面就讓小編來帶大家學(xué)習(xí)“Java對象復(fù)制工具類有哪些”吧!
成都創(chuàng)新互聯(lián)從2013年開始，公司以成都網(wǎng)站設(shè)計、網(wǎng)站建設(shè)、系統(tǒng)開發(fā)、網(wǎng)絡(luò)推廣、文化傳媒、企業(yè)宣傳、平面廣告設(shè)計等為主要業(yè)務(wù)，適用行業(yè)近百種。服務(wù)企業(yè)客戶成百上千家，涉及國內(nèi)多個省份客戶。擁有多年網(wǎng)站建設(shè)開發(fā)經(jīng)驗(yàn)。為企業(yè)提供專業(yè)的網(wǎng)站建設(shè)、創(chuàng)意設(shè)計、宣傳推廣等服務(wù)。 通過專業(yè)的設(shè)計、獨(dú)特的風(fēng)格，為不同客戶提供各種風(fēng)格的特色服務(wù)。
日常編程中，我們會經(jīng)常會碰到對象屬性復(fù)制的場景，就比如下面這樣一個常見的三層 MVC 架構(gòu)。
當(dāng)我們在上面的架構(gòu)下編程時，我們通常需要經(jīng)歷對象轉(zhuǎn)化，比如業(yè)務(wù)請求流程經(jīng)歷三層機(jī)構(gòu)后需要把 DTO 轉(zhuǎn)為DO然后在數(shù)據(jù)庫中保存。
當(dāng)需要從數(shù)據(jù)查詢數(shù)據(jù)頁面展示時，查詢數(shù)據(jù)經(jīng)過三層架構(gòu)將會從 DO 轉(zhuǎn)為 DTO，最后再轉(zhuǎn)為 VO，然后在頁面中展示。
當(dāng)業(yè)務(wù)簡單的時候，我們手寫代碼，通過 getter/setter復(fù)制對象屬性，十分簡單。但是一旦業(yè)務(wù)變的復(fù)雜，對象屬性變得很多，那么手寫代碼就會成為程序員的噩夢。
不但手寫十分繁瑣，非常耗時間，并且還可能容易出錯。
阿粉之前就經(jīng)歷過一個項(xiàng)目，一個對象中大概有四五十個字段屬性，那時候阿粉還剛?cè)腴T，什么都不太懂，寫了半天 getter/setter復(fù)制對象屬性。
話外音：一個對象屬性這么多，顯然是不太合理的，我們設(shè)計過程應(yīng)該將其拆分。
直到后來，了解到了對象屬性復(fù)制工具類，使用之后，發(fā)現(xiàn)是真香，再也不用手寫代碼。再后來，碰到越來越多工具類，雖然核心功能都是一樣的，但是還是存在很多差異。新手看到可能會一臉懵逼，不知道如何選擇。
在介紹這些工具類之前，我們來看下一個好用的屬性復(fù)制工具類，需要有哪些特性：
下面我們開始介紹工具類。
首先介紹是第一位應(yīng)該是 Java 領(lǐng)域?qū)傩詮?fù)制的最有名的工具類「Apache BeanUtils」，這個工具類想必很多人或多或少用過或則見過。
沒用過也沒關(guān)系，我們來展示這個類的用法，用法非常簡單。
首先我們引入依賴，這里使用最新版本：
重慶分公司
重慶分公司
commons-beanutils
commons-beanutils
1.9.4
假設(shè)我們項(xiàng)目中有如下類：
此時我們需要完成 DTO 對象轉(zhuǎn)化到 DO 對象，我們只需要簡單調(diào)用BeanUtils#copyProperties 方法就可以完成對象屬性的復(fù)制。
StudentDTO studentDTO = new StudentDTO();
studentDTO.setName("阿粉");
studentDTO.setAge(18);
studentDTO.setNo("6666");
List subjects = new ArrayList<>();
subjects.add("math");
subjects.add("english");
studentDTO.setSubjects(subjects);
studentDTO.setCourse(new Course("CS-1"));
studentDTO.setCreateDate("2020-08-08");
StudentDO studentDO = new StudentDO();
BeanUtils.copyProperties(studentDO, studentDTO);
不過，上面的代碼如果你這么寫，我們會碰到第一個問題，BeanUtils默認(rèn)不支持 String轉(zhuǎn)為 Date 類型。
為了解決這個問題，我們需要自己構(gòu)造一個 Converter 轉(zhuǎn)換類，然后使用 ConvertUtils注冊，使用方法如下：
ConvertUtils.register(new Converter() {
@SneakyThrows
@Override
public Date convert(Class type, Object value) {
if (value == null) {
return null;
}
if (value instanceof String) {
String str = (String) value;
return (Date) DateUtils.parseDate(str, "yyyy-MM-dd");
}
return null;
}
}, Date.class);
此時，我們觀察 studentDO與 studentDTO對象屬性值：
從上面的圖我們可以得出BeanUtils一些結(jié)論：
雖然 BeanUtils使用起來很方便，不過其底層源碼為了追求完美，加了過多的包裝，使用了很多反射，做了很多校驗(yàn)，所以導(dǎo)致性能較差，所以并阿里巴巴開發(fā)手冊上強(qiáng)制規(guī)定避免使用 Apache BeanUtils。
Spring 屬性復(fù)制工具類類名與 Apache 一樣，基本用法也差不多。我先來看下 Spring BeanUtils基本用法。
同樣，我們先引入依賴，從名字我們可以看出，BeanUtils位于 Spring-Beans 模塊，這里我們依然使用最新模塊。
org.springframework
spring-beans
5.2.8.RELEASE
這里我們使用 DTO 與 DO 復(fù)用上面的例子，轉(zhuǎn)換代碼如下：
// 省略上面賦值代碼，與上面一致
StudentDO studentDO = new StudentDO();
BeanUtils.copyProperties(studentDTO, studentDO);
從用法可以看到，Spring BeanUtils 與 Apache 有一個最大的不同，兩者源對象與目標(biāo)對象參數(shù)位置不一樣，阿粉之前沒注意，用了 Spring 工具類，但是卻是按照 Apache 的用法使用。
此時對比studentDO與 studentDTO對象：
從上面的對比圖我們可以得到一些結(jié)論：
除了這個方法之外，Spring BeanUtils 還提供了一個重載方法：
public static void copyProperties(Object source, Object target, String... ignoreProperties)
使用這個方法，我們可以忽略某些不想被復(fù)制過去的屬性：
BeanUtils.copyProperties(studentDTO, studentDO,"name");
這樣，name 屬性就不會被復(fù)制到 DO 對象中。
雖然 Spring BeanUtils 與 Apache BeanUtils 功能差不多，但是在性能上 Spring BeanUtils 還是完爆 Apache BeanUtils。主要原因還是在于 Spring 并沒有與 Apache 一樣使用反射做了過多校驗(yàn)，另外 Spring BeanUtils 內(nèi)部使用了緩存，加快轉(zhuǎn)換的速度。
所以兩者選擇，還是推薦使用 Spring BeanUtils。
上面兩個是阿粉日常工作經(jīng)常使用，而下面的這些都是阿粉最近才開始接觸的，比如 Cglib BeanCopier。這個使用方法，可能比上面兩個類稍微復(fù)雜一點(diǎn)，下面我們來看下具體用法：
首先我們引入 Cglib 依賴：
cglib
cglib
3.3.0
畫外音：如果你工程內(nèi)還有 Spring-Core 的話，如果查找
BeanCopier這個類，可以發(fā)現(xiàn)兩個不同的包的同名類。一個屬于 Cglib，另一個屬于 Spring-Core。
其實(shí) Spring-Core 內(nèi)
BeanCopier實(shí)際就是引入了 Cglib 中的類，這么做的目的是為包了保證 Spring 使用長度 Cglib 相關(guān)類的穩(wěn)定性，防止外部 Cglib 依賴不一致，導(dǎo)致 Spring 運(yùn)行異常。
轉(zhuǎn)換代碼如下：
// 省略賦值語句
StudentDO studentDO = new StudentDO();
BeanCopier beanCopier = BeanCopier.create(StudentDTO.class, StudentDO.class, false);
beanCopier.copy(studentDTO, studentDO, null);
使用方法相比 BeanUtils， BeanCopier 稍微多了一步。 對比studentDO與 studentDTO對象：
從上面可以得到與 Spring Beanutils 基本一致的結(jié)論：
上面我們使用 Beanutils，遇到這種字段名，類型不一致的這種情況，我們沒有什么好辦法，只能手寫硬編碼。
不過在 BeanCopier 下，我們可以引入轉(zhuǎn)換器，進(jìn)行類型轉(zhuǎn)換。
// 注意最后一個屬性設(shè)置為 true
BeanCopier beanCopier = BeanCopier.create(StudentDTO.class, StudentDO.class, true);
// 自定義轉(zhuǎn)換器
beanCopier.copy(studentDTO, studentDO, new Converter() {
@Override
public Object convert(Object source, Class target, Object context) {
if (source instanceof Integer) {
Integer num = (Integer) source;
return num.toString();
}
return null;
}
});
不過吐槽一下這個轉(zhuǎn)換器，一旦我們自己打開使用轉(zhuǎn)換器，所有屬性復(fù)制都需要我們自己來了。比如上面的例子中，我們只處理當(dāng)源對象字段類型為 Integer，這種情況，其他都沒處理。我們得到 DO 對象將會只有 name 屬性才能被復(fù)制。
Cglib BeanCopier 的原理與上面兩個 Beanutils 原理不太一樣，其主要使用 字節(jié)碼技術(shù)動態(tài)生成一個代理類，代理類實(shí)現(xiàn)get 和 set方法。生成代理類過程存在一定開銷，但是一旦生成，我們可以緩存起來重復(fù)使用，所有 Cglib 性能相比以上兩種 Beanutils 性能比較好。
Dozer ，中文直譯為挖土機(jī)，這是一個「重量級」屬性復(fù)制工具類，相比于上面介紹三個工具類，Dozer 具有很多強(qiáng)大的功能。
畫外音：重量級/輕量級其實(shí)只是一個相對的說法，由于 Dozer 相對 BeanUtils 這類工具類來說，擁有許多高級功能，所以相對來說這是一個重量級工具類。
阿粉剛碰到這個工具類，就被深深折服，真的太強(qiáng)大了，上面我們期望的功能，Dozer 都給你實(shí)現(xiàn)了。
下面我們來看下使用方法，首先我們引入 Dozer 依賴：
net.sf.dozer
dozer
5.4.0
使用方法如下：
// 省略屬性的代碼
DozerBeanMapper mapper = new DozerBeanMapper();
StudentDO studentDO =
mapper.map(studentDTO, StudentDO.class);
System.out.println(studentDO);
Dozer 需要我們新建一個DozerBeanMapper，這個類作用等同與 BeanUtils，負(fù)責(zé)對象之間的映射，屬性復(fù)制。
畫外音：下面的代碼我們可以看到，生成
DozerBeanMapper實(shí)例需要加載配置文件，隨意生成代價比較高。在我們應(yīng)用程序中，應(yīng)該使用單例模式，重復(fù)使用DozerBeanMapper。
如果屬性都是一些簡單基本類型，那我們只要使用上面代碼，可以快速完成屬性復(fù)制。
不過很不幸，我們的代碼中有字符串與 Date 類型轉(zhuǎn)化，如果我們直接使用上面的代碼，程序運(yùn)行將會拋出異常。
所以這里我們要用到 Dozer 強(qiáng)大的配置功能，我們總共可以使用下面三種方式：
其中，API 的方式比較繁瑣，目前大部分使用 XML 進(jìn)行，另外注解功能的是在 Dozer 5.3.2 之后增加的新功能，不過功能相較于 XML 來說較弱。
下面我們使用 XML 配置方式，配置 DTO 與 DO 關(guān)系，首先我們新建一個 dozer/dozer-mapping.xml 文件：
http://dozer.sourceforge.net/schema/beanmapping.xsd">
com.just.doone.example.domain.StudentDTO
com.just.doone.example.domain.StudentDO
no
number
createDate
createDate
然后修改我們的 Java 代碼,增加讀取 Dozer 的配置文件：
DozerBeanMapper mapper = new DozerBeanMapper();
List mappingFiles = new ArrayList<>();
// 讀取配置文件
mappingFiles.add("dozer/dozer-mapping.xml");
mapper.setMappingFiles(mappingFiles);
StudentDO studentDO = mapper.map(studentDTO, StudentDO.class);
System.out.println(studentDO);
運(yùn)行之后，對比studentDO與 studentDTO對象：
從上面的圖我們可以發(fā)現(xiàn)：
除了上述這些相對簡單的屬性以外，Dozer 還支持很多額外的功能，比如枚舉屬性復(fù)制，Map 等集合屬性復(fù)制等。
有些小伙伴剛看到 Dozer 的用法，可能覺得這個工具類比較繁瑣，不像 BeanUtils 工具類一樣一行代碼就可以解。
其實(shí) Dozer 可以很好跟 Spring 框架整合，我們可以在 Spring 配置文件提前配置，后續(xù)我們只要引用 Dozer 的相應(yīng)的 Bean ，使用方式也是一行代碼。
Dozer 與 Spring 整合，我們可以使用其 DozerBeanMapperFactoryBean，配置如下：
DozerBeanMapperFactoryBean支持設(shè)置屬性比較多，可以自定義設(shè)置類型轉(zhuǎn)換，還可以設(shè)置其他屬性。
另外還有一種簡單的方法，我們可以在 XML 中配置 DozerBeanMapper：
dozer/dozer-Mapperpping.xml
Spring 配置完成之后，我們在代碼中可以直接注入:
@Autowired
Mapper mapper;
public void objMapping(StudentDTO studentDTO) {
// 直接使用
StudentDO studentDO =
mapper.map(studentDTO, StudentDO.class);
}
Dozer 注解方式相比 XML 配置來說功能很弱，只能完成字段名不一致的映射。
上面的代碼中，我們可以在 DTO 的 no 字段上使用 @Mapping 注解，這樣我們在使用 Dozer 完成轉(zhuǎn)換時，該字段屬性將會被復(fù)制。
@Data
public class StudentDTO {
private String name;
private Integer age;
@Mapping("number")
private String no;
private List subjects;
private Course course;
private String createDate;
}
雖然目前注解功能有點(diǎn)薄弱，不過后看版本官方可能增加新的注解功能，另外 XML 與注解可以一起使用。
最后 Dozer 底層本質(zhì)上還是使用了反射完成屬性的復(fù)制，所以執(zhí)行速度并不是那么理想。
orika也是一個跟 Dozer 類似的重量級屬性復(fù)制工具類，也提供諸如 Dozer 類似的功能。但是 orika 無需使用繁瑣 XML 配置，它自身提供一套非常簡潔的 API 用法，非常容易上手。
首先我們引入其最新的依賴：
ma.glasnost.orika
orika-core
1.5.4
基本使用方法如下：
// 省略其他設(shè)值代碼
// 這里先不要設(shè)值時間
// studentDTO.setCreateDate("2020-08-08");
MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
MapperFacade mapper = mapperFactory.getMapperFacade();
StudentDO studentDO = mapper.map(studentDTO, StudentDO.class);
這里我們引入兩個類 MapperFactory 與 MapperFacade，其中 MapperFactory 可以用于字段映射，配置轉(zhuǎn)換器等，而 MapperFacade 的作用就與 Beanutils 一樣，用于負(fù)責(zé)對象的之間的映射。
上面的代碼中，我們故意注釋了 DTO 對象中的 createDate 時間屬性的設(shè)值，這是因?yàn)槟J(rèn)情況下如果沒有單獨(dú)設(shè)置時間類型的轉(zhuǎn)換器，上面的代碼將會拋錯。
另外，上面的代碼中，對于字段名不一致的屬性，是不會復(fù)制的，所以我們需要單獨(dú)設(shè)置。
下面我們就設(shè)置一個時間轉(zhuǎn)換器，并且指定一下字段名：
MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
ConverterFactory converterFactory = mapperFactory.getConverterFactory();
converterFactory.registerConverter(new DateToStringConverter("yyyy-MM-dd"));
mapperFactory.classMap(StudentDTO.class, StudentDO.class)
.field("no", "number")
// 一定要調(diào)用下 byDefault
.byDefault()
.register();
MapperFacade mapper = mapperFactory.getMapperFacade();
StudentDO studentDO = mapper.map(studentDTO, StudentDO.class);
上面的代碼中，首先我們需要在 ConverterFactory 注冊一個時間類型的轉(zhuǎn)換器，其次我們還需要再 MapperFactory 指定不同字段名的之間的映射關(guān)系。
這里我們要注意，在我們使用 classMap 之后，如果想要相同字段名屬性默認(rèn)被復(fù)制，那么一定調(diào)用 byDefault方法。
簡單對比一下 DTO 與 DO 對象：
上圖可以發(fā)現(xiàn) orika 的一些特性：
另外 orika 還支持集合映射：
MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
List persons = new ArrayList<>();
List personDtos = mapperFactory.getMapperFacade().mapAsList(persons, PersonDto.class);
最后聊下 orika 實(shí)現(xiàn)原理，orika 與 dozer 底層原理不太一樣，底層其使用了 javassist 生成字段屬性的映射的字節(jié)碼，然后直接動態(tài)加載執(zhí)行字節(jié)碼文件，相比于 Dozer 的這種使用反射原來的工具類，速度上會快很多。
不知不覺，一口氣已經(jīng)寫了 5 個屬性復(fù)制工具類，小伙伴都看到這里，那就不要放棄了，堅(jiān)持看完，下面將介紹一個與上面這些都不太一樣的工具類「MapStruct」。
上面介紹的這些工具類，不管使用反射，還是使用字節(jié)碼技術(shù)，這些都需要在代碼運(yùn)行期間動態(tài)執(zhí)行，所以相對于手寫硬編碼這種方式，上面這些工具類執(zhí)行速度都會慢很多。
那有沒有一個工具類的運(yùn)行速度與硬編碼這種方式差不多那?
這就要介紹 MapStruct 這個工具類，這個工具類之所以運(yùn)行速度與硬編碼差不多，這是因?yàn)樗诰幾g期間就生成了 Java Bean 屬性復(fù)制的代碼，運(yùn)行期間就無需使用反射或者字節(jié)碼技術(shù)，所以確保了高性能。
另外，由于編譯期間就生成了代碼，所以如果有任何問題，編譯期間就可以提前暴露，這對于開發(fā)人員來講就可以提前解決問題，而不用等到代碼應(yīng)用上線了，運(yùn)行之后才發(fā)現(xiàn)錯誤。
下面我們來看下，怎么使用這個工具類，首先我們先引入這個依賴：
org.mapstruct
mapstruct
1.3.1.Final
其次，由于 MapStruct 需要在編譯器期間生成代碼，所以我們需要 maven-compiler-plugin插件中配置：
org.apache.maven.plugins
maven-compiler-plugin
3.8.1
1.8
1.8
org.mapstruct
mapstruct-processor
1.3.1.Final
接下來我們需要定義映射接口，代碼如下：
@Mapper
public interface StudentMapper {
StudentMapper INSTANCE = Mappers.getMapper(StudentMapper.class);
@Mapping(source = "no", target = "number")
@Mapping(source = "createDate", target = "createDate", dateFormat = "yyyy-MM-dd")
StudentDO dtoToDo(StudentDTO studentDTO);
}
我們需要使用 MapStruct 注解 @Mapper 定義一個轉(zhuǎn)換接口，這樣定義之后，StudentMapper 的功能就與 BeanUtils 等工具類一樣了。
其次，由于我們 DTO 與 DO 對象中存在字段名不一致的情況，所以我們還在在轉(zhuǎn)換方法上使用 @Mapping 注解指定字段映射。另外我們 createDate 字段類型不一致，這里我們還需要指定時間格式化類型。
上面定義完成之后，我們就可以直接使用 StudentMapper 一行代碼搞定對象轉(zhuǎn)換。
// 忽略其他代碼
StudentDO studentDO = StudentMapper.INSTANCE.dtoToDo(studentDTO);
如果我們對象使用 Lombok 的話，使用 @Mapping指定不同字段名，編譯期間可能會拋出如下的錯誤：
這個原因主要是因?yàn)?Lombok 也需要編譯期間自動生成代碼，這就可能導(dǎo)致兩者沖突，當(dāng) MapStruct 生成代碼時，還不存在 Lombok 生成的代碼。
解決辦法可以在 maven-compiler-plugin插件配置中加入 Lombok，如下：
org.apache.maven.plugins
maven-compiler-plugin
3.8.1
1.8
1.8
org.mapstruct
mapstruct-processor
1.3.1.Final
org.projectlombok
lombok
1.18.12
輸出 DO 與 DTO 如下：
從上圖中我們可以得到一些結(jié)論：
上面介紹的例子介紹一些簡單字段映射，如果小伙伴在工作總共還碰到其他的場景，可以先查看一下這個工程，查看一下有沒有結(jié)局解決辦法：https://github.com/mapstruct/mapstruct-examples
上面我們已經(jīng)知道 MapStruct 在編譯期間就生成了代碼，下面我們來看下自動生成代碼：
public class StudentMapperImpl implements StudentMapper {
public StudentMapperImpl() {
}
public StudentDO dtoToDo(StudentDTO studentDTO) {
if (studentDTO == null) {
return null;
} else {
StudentDO studentDO = new StudentDO();
studentDO.setNumber(studentDTO.getNo());
try {
if (studentDTO.getCreateDate() != null) {
studentDO.setCreateDate((new SimpleDateFormat("yyyy-MM-dd")).parse(studentDTO.getCreateDate()));
}
} catch (ParseException var4) {
throw new RuntimeException(var4);
}
studentDO.setName(studentDTO.getName());
if (studentDTO.getAge() != null) {
studentDO.setAge(String.valueOf(studentDTO.getAge()));
}
List list = studentDTO.getSubjects();
if (list != null) {
studentDO.setSubjects(new ArrayList(list));
}
studentDO.setCourse(studentDTO.getCourse());
return studentDO;
}
}
}
從生成的代碼來看，里面并沒有什么黑魔法，MapStruct 自動生成了一個實(shí)現(xiàn)類 StudentMapperImpl，里面實(shí)現(xiàn)了 dtoToDo，方法里面調(diào)用 getter/setter設(shè)值。
從這個可以看出，MapStruct 作用就相當(dāng)于幫我們手寫getter/setter設(shè)值，所以它的性能會很好。
到此，相信大家對“Java對象復(fù)制工具類有哪些”有了更深的了解，不妨來實(shí)際操作一番吧！這里是創(chuàng)新互聯(lián)網(wǎng)站，更多相關(guān)內(nèi)容可以進(jìn)入相關(guān)頻道進(jìn)行查詢，關(guān)注我們，繼續(xù)學(xué)習(xí)！
