属性拷贝你还在用BeanUtils?

属性拷贝你还在用BeanUtils?

从PO, DTO到Domain Driven Design这篇文章提到各种实体类, 工作中我们往往因为领域的问题要在DO,BO,VO,DTO之间来回转换.

最初

年轻时候的我是这样做的.

块编辑

可以看出我这套块编辑的操作还是挺骚的. 但还是感觉麻烦.

于是我找了几个常用的三方工具

  • org.apache.commons.beanutils.BeanUtils.copyProperties
  • org.apache.commons.beanutils.PropertyUtils.copyProperties
  • org.springframework.beans.BeanUtils.copyProperties
  • org.springframework.cglib.beans.BeanCopier.copy
  • org.mapstruct

本文主推使用mapstruct做属性复制,请看下文

通常选择一个工具我们要从性能和实用性方面两个角度去考量.

性能检测

为了足够硬核,我们实践检验效果.通过一组测试来检查5个方法的性能表现.

测试代码如下:

@Slf4j
public class CopyDemoTest {

    public UserMainBO bo;

    public static int count = 1000000;

    @Before
    public void init(){
        bo = new UserMainBO();
        bo.setId(1L);
    }

    @Test
    public void mapstruct() {
        UserMainVOMapping INSTANCE = Mappers.getMapper( UserMainVOMapping.class );
        log.info("star------------");
        for (int i = 1; i <=count; i++) {
            // log.debug(i+"");
            UserMainVO vo = INSTANCE.toVO(bo);
        }
        log.info("end------------");
    }

    @Test
    public void beanCopier() {
        log.info("star------------");
        BeanCopier copier = BeanCopier.create(UserMainBO.class, UserMainVO.class, false);
        for (int i = 1; i <=count; i++) {
            // log.debug(i+"");
            UserMainVO vo = new UserMainVO();
            copier.copy(bo, vo, null);
        }
        log.info("end------------");
    }

    @Test
    public void springBeanUtils(){
        log.info("star------------");
        for (int i = 1; i <=count; i++) {
            // log.debug(i+"");
            UserMainVO vo = new UserMainVO();
            BeanUtils.copyProperties(bo, vo);
        }
        log.info("end------------");
    }

    @Test
    public void apacheBeanUtils() throws InvocationTargetException, IllegalAccessException {
        for (int i = 1; i <=count; i++) {
            // log.debug(i+"");
            UserMainVO vo = new UserMainVO();
            org.apache.commons.beanutils.BeanUtils.copyProperties(bo, vo);
        }
        log.info("end------------");
    }

    @Test
    public void apachePropertyUtils() throws NoSuchMethodException, InvocationTargetException, IllegalAccessException {
        log.info("star------------");
        for (int i = 1; i <=count; i++) {
            // log.debug(i+"");
            UserMainVO vo = new UserMainVO();
            PropertyUtils.copyProperties(bo, vo);
        }
        log.info("end------------");
    }

}
tools/count 1000/次 10000/次 100000/次 1000000/次
apache.BeanUtils 550ms 1085ms 4287ms 32088ms
apache.PropertyUtils 232ms 330ms 2080ms 20681ms
cglib.BeanCopier 73ms 106ms 102ms 99ms
mapstruct 91ms 5ms 7ms 12ms
spring.BeanUtils 5ms 188ms 336ms 844ms

如图所示, 可看出其性能一次是:

mapstruct > BeanCopier > spring.BeanUtils > apache.PropertyUtils > apache.BeanUtils

mapstruct 相当的顶, 性能遥遥领先.

分析

我们看下源码

apache.BeanUtils

while(var13.hasNext()) {
    Entry<String, Object> entry = (Entry)var13.next();
    String name = (String)entry.getKey();
    if (this.getPropertyUtils().isWriteable(dest, name)) {
       // 核心逻辑
        this.copyProperty(dest, name, entry.getValue());
    }
}

apache.PropertyUtils

value = this.getSimpleProperty(orig, name);
if (dest instanceof DynaBean) {
    ((DynaBean)dest).set(name, value);
} else {
    // 核心逻辑
    this.setSimpleProperty(dest, name, value);
}

Apache 主要集中了各种丰富的功能(日志、转换、解析等等),导致性能变差。

而Spring BeanUtils则是直接通过反射来读取和写入

for(int var9 = 0; var9 < var8; ++var9) {
    PropertyDescriptor targetPd = var7[var9];
    Method writeMethod = targetPd.getWriteMethod();
    if (writeMethod != null && (ignoreList == null || !ignoreList.contains(targetPd.getName()))) {
        PropertyDescriptor sourcePd = getPropertyDescriptor(source.getClass(), targetPd.getName());
        if (sourcePd != null) {
            Method readMethod = sourcePd.getReadMethod();
            if (readMethod != null && ClassUtils.isAssignable(writeMethod.getParameterTypes()[0], readMethod.getReturnType())) {
                try {
                    if (!Modifier.isPublic(readMethod.getDeclaringClass().getModifiers())) {
                        readMethod.setAccessible(true);
                    }

                    Object value = readMethod.invoke(source);
                    if (!Modifier.isPublic(writeMethod.getDeclaringClass().getModifiers())) {
                        writeMethod.setAccessible(true);
                    }

                    writeMethod.invoke(target, value);
                } catch (Throwable var15) {
                    throw new FatalBeanException("Could not copy property '" + targetPd.getName() + "' from source to target", var15);
                }
            }
        }
    }
}

BeanCopier

public abstract void copy(Object var1, Object var2, Converter var3);

BeanCopier动态生成一个要代理类的子类,其实就是通过字节码方式转换成性能最好的get和set方式,只需考虑创建BeanCopier的开销.

mapstruct

这里我们打开UserMainVOMapping的实现类可以看出,其相当硬核.直接用maven 在编译期间生产对应的实现类.

3059vn.gif

看到这里有的观众老爷就会说了:"那这个性能差的也不多啊, 我为什么要用mapsturct?" 请接着往下看

实用性

mapstruct的接口

@Mapper(componentModel = "spring")
public interface UserMainVOMapping {

    @Mappings({
            @Mapping(source = "testB", target = "testV")
    })
    UserMainVO toVO(UserMainBO userMainBO);

    List<UserMainVO> toVOList(List<UserMainBO> list);

    PageInfo<UserMainBO> toVOPage(PageInfo<UserMainBO> page);
}

这里我们可以看出一下几个特征

  • 直接定义接口就可以实现属性复制
  • 属性对应可以 n source -> 1tager
  • 集合形式也可以转
  • 特殊实体类只要属性相同也可以转
  • 可以通过@Mapping 指定属性复制路径

足见其功能的强大

mapstruct的使用

maven 配置

这里只介绍 maven形式配置, gradle 和 ant 请参考官网


<properties>
 <org.mapstruct.version>1.3.1.Final</org.mapstruct.version>
</properties>

<dependencies>
        <dependency>
            <groupId>org.mapstruct</groupId>
            <artifactId>mapstruct-processor</artifactId>
            <version>${org.mapstruct.version}</version>
            <scope>provided</scope>
        </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>${lombok.version}</version>
                    </path>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>${org.mapstruct.version}</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

注意这里配置一下lombok, 否则启动会冲突

Mapping 接口编写

@Mapper(componentModel = "spring")
public interface UserMainVOMapping {

    @Mappings({
            @Mapping(source = "testB", target = "testV")
    })
    UserMainVO toVO(UserMainBO userMainBO);

    List<UserMainVO> toVOList(List<UserMainBO> list);

    PageInfo<UserMainBO> toVOPage(PageInfo<UserMainBO> page);
}

使用类示意

@RestController
public class UserController {

    @Resource
    private UserMainVOMapping userMainVOMapping;
    @Resource
    private UserMainDOService userMainDOService;

    @GetMapping("/userMain/page")
    public ResultVO page(int page, int pageSize, String nickname)   {
        PageInfo<UserMainBO> userPage = userMainDOService.page(page, pageSize, nickname, false);
        UserMainVOMapping INSTANCE = Mappers.getMapper( UserMainVOMapping.class);
        return new ResultVO(ResultEnum.SUCCESS, INSTANCE.toVOPage(userPage));
    }

    @GetMapping("/userMain/page2")
    public ResultVO page2(int page, int pageSize, String nickname)   {
        PageInfo<UserMainBO> userPage = userMainDOService.page(page, pageSize, nickname, false);
        return new ResultVO(ResultEnum.SUCCESS, userMainVOMapping.toVOPage(userPage));
    }

    @GetMapping("moreToOne")
    public UserMainVO moreToOne(){
        UserMainBO userMainBO = new UserMainBO();
        userMainBO.setId(1L);
        userMainBO.setTestB("test");
        SubBO subBO = new SubBO();
        subBO.setA("A");
        userMainBO.setSub(subBO);
        return userMainVOMapping.toVO(userMainBO);
    }
}

注意

  1. 可以在Mapping类上加@Mapper(componentModel = "spring"), 通过注入的方式引入Mapper接口

  2. 可以通过Mappers.getMapper( UserMainVOMapping.class) 的方式获取Mapper接口

总结

  1. 众多属性拷贝工具中mapstruct相对比较好
  2. mapstruct书写性能极高
  3. mapstruct书写非常方便
  4. mapstruct非常灵活可用来定义各种类型的属性copy

这期差不多就这些了.如果对你有用的话,欢迎评论,交流,关注,点赞.

谢谢大家啦~

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 204,793评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 87,567评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,342评论 0赞 338
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,825评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,814评论 5赞 368
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,680评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,033评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,687评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 42,175评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,668评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,775评论 1赞 332
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,419评论 4赞 321
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,020评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,206评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,092评论 2赞 351
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,510评论 2赞 343