Java對象轉(zhuǎn)換的方案分享

第Java對象轉(zhuǎn)換的方案分享目錄前言為什么模型要分這么多層？模型之間的轉(zhuǎn)換建議不要用的方式常用的方式使用方式定義對象BeanCopier最簡單的使用方式創(chuàng)建可復(fù)用的BeanCopier工具類MapStruct引入mapstruct簡單Demo常見用法性能測試測試代碼測試結(jié)果最后

前言

系統(tǒng)變的復(fù)雜，系統(tǒng)的層次劃分越來越細(xì)，邊界也越來越明確。然后每一層之間一般都有自己要處理的領(lǐng)域?qū)ο螅y(tǒng)稱為pojo一般在model或者domain包下(類的后綴不能為pojo)。

常見的一些模型類型：

PO、DO：持久層對象，一般和數(shù)據(jù)庫直接打交道。DTO：數(shù)據(jù)傳輸對象，系統(tǒng)之間的交互，再服務(wù)層提供服務(wù)的時候輸出到其它系統(tǒng)。VO：視圖對象，用于前端模型展示。當(dāng)然有時候前端也可以看做另外一個系統(tǒng)，使用DTO模型；BO：業(yè)務(wù)邏輯對象，比較少用...

為什么模型要分這么多層？

在復(fù)雜一點的業(yè)務(wù)中，業(yè)務(wù)建模是非常有必要的，一定要抽象出業(yè)務(wù)上常用的領(lǐng)域模型，統(tǒng)一技術(shù)和非技術(shù)同學(xué)的語言。

建完模型之后，在技術(shù)的系統(tǒng)中，為了方便維護(hù)代碼，分離關(guān)注點，也會進(jìn)行再次分層，讓每一層解決特定的問題。模型的分層是隨著系統(tǒng)的分層而來的；試想所有的模型屬性在一個對象中，這個對象你看的懂嗎？

舉個實際的案例：

數(shù)據(jù)層一般用DO現(xiàn)在要透出數(shù)據(jù)給其他系統(tǒng)，DO中一般都會有創(chuàng)建人，創(chuàng)建時間，修改人，修改時間，當(dāng)前對象所處的環(huán)境等信息；但是外部的系統(tǒng)需要環(huán)境、創(chuàng)建人信息嗎？很多時候不需要，站在數(shù)據(jù)安全的角度，一般只透出必要的字段就可以；這些要輸出要外部系統(tǒng)的必要字段，一般定義在DTO中。到前端系統(tǒng)，前端系統(tǒng)展示上所需的邏輯和輸出到外部系統(tǒng)的又有點不太一樣，前端系統(tǒng)可能要創(chuàng)建人，創(chuàng)建時間，但是不要另外一些東西，或者一些敏感的配置不能透出給前端，這個時候一般也會再定義一個新的對象。

簡單說就是當(dāng)我們的系統(tǒng)要輸出能力到外部系統(tǒng)的時候，不同系統(tǒng)要的數(shù)據(jù)不一樣，數(shù)據(jù)安全要求我們不能透出這么多的數(shù)據(jù)，一定要做一層處理。另外給另外一個系統(tǒng)關(guān)注的數(shù)據(jù)，而不是一股腦的全部都給對方，對方處理起來也方便。

模型之間的轉(zhuǎn)換

建議不要用的方式

手寫get\set；雖然性能高，但是費勁并且眼花繚亂，一不小心就寫錯了，難以維護(hù)，復(fù)用度不高BeanUtils，apacha和spring包下都有對應(yīng)的類，但是底層用到的都是反射，性能比較差，大流量的情況下一般不用直接fastjson，gc會很頻繁，而且性能比較差

常用的方式

cglib的beanCopier，開銷在創(chuàng)建BeanCopier，一般在創(chuàng)建類的時候提前創(chuàng)建好一個，在代碼運行的時候直接進(jìn)行copy，性能接近原生。mapstruct性能和原生代碼一樣，支持復(fù)雜的轉(zhuǎn)化場景，實現(xiàn)原理同lombok編譯的時候生成對應(yīng)的代碼。

以上從技術(shù)分類的角度來看：

反射：fastjson，beanutil都不建議用get\set：beancoper通過字節(jié)碼進(jìn)行g(shù)etset，mapstruct編譯的時候生成getset。性能相對較好。

使用方式

個人覺得，如果說對象比較簡單的時候，使用BeanCopier就可以了，因為spring的aop依賴cglib，默認(rèn)情況下就已經(jīng)引入了對應(yīng)的包了，不需要額外的依賴直接就可以用。

如果很復(fù)雜的模型之間的轉(zhuǎn)換，并且對性能有更極致的要求，考慮使用下MapStruct。

定義對象

UserDO

@Data

publicclassUserDO{

privateLongid;

privateStringname;

privateIntegergender;

privateStringpassword;

privateDategmtCreate;

privateDategmtModified;

}

UserDTO

@Data

publicclassUserDTO{

privateLongid;

privateStringname;

privateIntegergender;

}

BeanCopier

最簡單的使用方式

BeanCopierbeanCopier=BeanCopier.create(UserDO.class,UserDTO.class,false);bean.copy即可；

privatestaticvoidsimpleBeanCopy(){

BeanCopierbeanCopier=BeanCopier.create(UserDO.class,UserDTO.class,false);

UserDOuserDO=newUserDO();

userDO.setId(1L);

userDO.setName("aihe");

userDO.setGmtCreate(newDate());

userDO.setGender(0);

userDO.setPassword("xxxxxx");

UserDTOuserDTO=newUserDTO();

beanCopier.copy(userDO,userDTO,null);

Assert.assertEquals("名稱未成功拷貝",userDTO.getName(),"aihe");

Assert.assertEquals("Id未成功拷貝",1L,(long)userDTO.getId());

Assert.assertEquals("性別未成功拷貝",Integer.valueOf(0),userDTO.getGender());

}

創(chuàng)建可復(fù)用的BeanCopier工具類

packageme.aihe.daka;

importjava.util.Map;

importjava.util.concurrent.ConcurrentHashMap;

importnet.sf.cglib.beans.BeanCopier;

*@author:aihe

*@date:2025/9/129:21AM

*使用場景：

*功能描述：

publicclassBeanCopyUtils{

*beanCopier緩存

*由sourceClass和targetClass可以確定一個唯一的BeanCoper，因此使用二級Map；

privatestaticMapClass,MapClass,BeanCopierbeanCopierMap=newConcurrentHashMap();

*直接指定Bean對象進(jìn)行拷貝

*@paramsourceBean

*@paramtargetBean

*@paramS

*@paramT

publicstaticS,Tvoidcopy(SsourceBean,TtargetBean){

@SuppressWarnings("unchecked")

ClassSsourceClass=(ClassS)sourceBean.getClass();

@SuppressWarnings("unchecked")

ClassTtargetClass=(ClassT)targetBean.getClass();

BeanCopierbeanCopier=getBeanCopier(sourceClass,targetClass);

beanCopier.copy(sourceBean,targetBean,null);

*轉(zhuǎn)換方法

*@paramsourceBean原對象

*@paramtargetClass目標(biāo)類

*@paramS

*@paramT

*@return

publicstaticS,TTconvert(SsourceBean,ClassTtargetClass){

try{

assertsourceBean!=null;

TtargetBean=targetClass.newInstance();

copy(sourceBean,targetBean);

returntargetBean;

}catch(Exceptione){

thrownewRuntimeException(e);

privatestaticS,TBeanCopiergetBeanCopier(ClassSsourceClass,ClassTtargetClass){

MapClass,BeanCopiermap=beanCopierMap.get(sourceClass);

if(map==null||map.isEmpty()){

BeanCopiernewBeanCopier=BeanCopier.create(sourceClass,targetClass,false);

MapClass,BeanCopiernewMap=newConcurrentHashMap();

newMap.put(targetClass,newBeanCopier);

beanCopierMap.put(sourceClass,newMap);

returnnewBeanCopier;

BeanCopierbeanCopier=map.get(targetClass);

if(beanCopier==null){

BeanCopiernewBeanCopier=BeanCopier.create(sourceClass,targetClass,false);

map.put(targetClass,newBeanCopier);

returnnewBeanCopier;

returnbeanCopier;

}

同上：

UserDOuserDO=newUserDO();

userDO.setId(1L);

userDO.setName("aihe");

userDO.setGmtCreate(newDate());

userDO.setGender(0);

userDO.setPassword("xxxxxx");

UserDTOuserDTO=newUserDTO();

BeanCopyUtils.copy(userDO,userDTO);

Assert.assertEquals("名稱未成功拷貝",userDTO.getName(),"aihe");

Assert.assertEquals("Id未成功拷貝",1L,(long)userDTO.getId());

Assert.assertEquals("性別未成功拷貝",Integer.valueOf(0),userDTO.getGender());

MapStruct

案例集：/mapstruct/m

引入mapstruct

properties

project.build.sourceEncodingUTF-8/project.build.sourceEncoding

org.mapstruct.version1.5.2.Final/org.mapstruct.version

jectlombok.version1.18.20/jectlombok.version

/properties

dependencies

dependency

groupIdorg.mapstruct/groupId

artifactIdmapstruct/artifactId

version${org.mapstruct.version}/version

/dependency

dependency

groupIdorg.mapstruct/groupId

artifactIdmapstruct-processor/artifactId

version${org.mapstruct.version}/version

!--IntelliJdoesnotpickuptheprocessorifitisnotinthedependencies.

ThereisalreadyanopenissueforIntelliJsee/issue/IDEA-150621

scopeprovided/scope

/dependency

dependency

groupIdjectlombok/groupId

artifactIdlombok/artifactId

version${jectlombok.version}/version

scopeprovided/scope

/dependency

/dependencies

簡單Demo

定義Mapper

@Mapper

publicinterfaceUserDTOMapper{

UserDTOMapperMAPPER=Mappers.getMapper(UserDTOMapper.class);

//@Mapping(source="test",target="testing")

//@Mapping(source="test1",target="testing2")

UserDTOtoTarget(UserDOs);

}

使用：

publicstaticvoidmain(String[]args){

//simpleDemo();

UserDOuserDO=newUserDO();

userDO.setId(1L);

userDO.setName("aihe");

userDO.setGmtCreate(newDate());

userDO.setGender(0);

userDO.setPassword("xxxxxx");

UserDTOuserDTO=UserDTOMapper.MAPPER.toTarget(userDO);

Assert.assertEquals("名稱未成功拷貝",userDTO.getName(),"aihe");

Assert.assertEquals("Id未成功拷貝",1L,(long)userDTO.getId());

Assert.assertEquals("性別未成功拷貝",Integer.valueOf(0),userDTO.getGender());

}

常見用法

屬性類型相同，名稱不同的時候，使用@Mapping注解指定source和target字段名稱對應(yīng)關(guān)系，如果有多個這種屬性，那就指定多個@Mapping注解。忽略某個字段，在@Mapping的時候，加上ignore=true轉(zhuǎn)化日期格式，字符串到數(shù)字的格式，可以使用dateFormat，numberFormat如果有自定義轉(zhuǎn)換的需求，寫一個簡單的Java類即可，然后在方法上打上Mapstruct的注解@Named，在在@Mapper(uses=自定義的類)，然后@Mapping中用上qualifiedByName。

@Mapping(target="userNick1",source="userNick")

@Mapping(target="createTime",source="createTime",dateFormat="yyyy-MM-dd")

@Mapping(target="age",source="age",numberFormat="#0.00")

@Mapping(target="id",ignore=true)

@Mapping(target="userVerified",defaultValue="defaultValue-2")

UserDTOtoTarget(UserDOs);

性能測試

測試代碼

importjava.util.Date;

importcom.alibaba.fastjson.JSON;

importorg.junit.Before;

importorg.junit.Test;

*@author:aiheaihe.ah@

*@date:2025/9/129:47AM

*使用場景：

*功能描述：

publicclassBenchDemoTest{

*轉(zhuǎn)化對象

privateUserDOuserDO;

*轉(zhuǎn)化次數(shù)

privatefinalstaticintcount=1000000;

@Before

publicvoidbefore(){

userDO=newUserDO();

userDO.setId(1L);

userDO.setName("aihe");

userDO.setGmtCreate(newDate());

userDO.setGender(0);

userDO.setPassword("xxxxxx");

@Test

publicvoidmapstruct(){

longstartTime=System.currentTimeMillis();

for(inti=1;i=count;i++){

UserDTOuserDTO=UserDTOMapper.MAPPER.toTarget(userDO);

System.out.println("mapstructtime"+(System.currentTimeMillis()-startTime));

@Test

publicvoidbeanCopier(){

longstartTime=System.currentTimeMillis();

for(inti=1;i=count;i++){

UserDTOtargetBean=newUserDTO();

BeanCopyUtils.copy(userDO,targetBean);

System.out.println("beanCopiertime"+(System.currentTimeMillis()-startTime));

@Test