Java中VO和DTO转换的两种高效实现方法

背景：领域模型中的对象分类

在规范的项目架构中，根据数据流转的不同阶段，通常涉及以下四类实体：

1. VO (View Object)：视图对象，用于展示层。封装指定页面或组件所需的所有展示数据。
2. DTO (Data Transfer Object)：数据传输对象。源自J2EE设计模式，用于展示层与服务层之间、或微服务间的粗粒度数据传输，旨在减少远程调用次数，降低网络负载。
3. DO (Domain Object)：领域对象。反映业务实体的状态，通常包含业务逻辑。
4. PO (Persistent Object)：持久化对象。与关系型数据库表结构一一映射，对应数据表字段。

一般的数据流向为：数据库读取生成PO → 转换为领域模型DO → 转换为对外服务的DTO。

各对象设计注意点

• PO：通常由ORM框架自动生成，需严格遵循数据库表结构。
• DO：常以Model结尾，可能包含枚举类型等复杂字段。
• DTO：作为API契约，属性定义应注重安全性、易读性与可扩展性。明确其层级关系（包含或平级），避免后期维护灾难。
• VO：贴近前端需求，灵活配置即可。

转换痛点

在实际编码中，VO、From、DTO和DO之间的属性往往高度重合。当属性多达数十个时，逐个编写 setXXX() 不仅冗长乏味，还容易遗漏。利用成熟的Bean映射工具可以显著简化这一过程。

方法一：使用 Spring Framework (推荐)

Spring 核心包自带属性拷贝工具，无需引入额外依赖，适合大多数同名属性的场景。

第1步：添加依赖

确保项目中引入了Spring Beans模块。Maven依赖如下：

<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-beans</artifactId>
  <version>5.3.x.RELEASE</version></dependency>

注：如果使用Spring Boot Starter，该依赖通常已自动包含在内。

第2步：定义源对象与目标对象

假设我们需要将前端入参 TestDemoFrom 转换为返回前端的 TestDemoDTO。两者属性名称一致：

public class TestDemoFrom {
    private String name;
    private Map<String,String> citys;
    private Date gmtStart;
    private Boolean flag;
    private Integer age;
    private List<String> types;
    // 省略 getter/setter/tostring
}

public class TestDemoDTO {
    private String name;
    private Map<String,String> citys;
    private Date gmtStart;
    private Boolean flag;
    private Integer age;
    private List<String> types;
    // 省略 getter/setter/tostring
}

第3步：执行转换操作

使用 BeanUtils.copyProperties(source, target) 即可完成赋值：

public class ConvertTest {
    public static void main(String[] args) {
        // 1. 准备源数据
        TestDemoFrom source = new TestDemoFrom();
        source.setName("ExampleUser");
        source.setAge(25);
        source.setFlag(true);
        source.setCitys(Map.of("C01", "Beijing"));
        
        // 2. 创建目标对象
        TestDemoDTO target = new TestDemoDTO();
        
        // 3. 核心转换：一行代码搞定
        org.springframework.beans.BeanUtils.copyProperties(source, target);
        
        // 验证结果
        System.out.println(target.toString());
    }
}

注意事项

• 属性匹配机制：基于属性名匹配，必须保证两边Getter/Setter名相同。
• 类型限制：若同名属性类型不一致，将不会被拷贝。
• 覆盖行为：该方法直接修改目标对象现有实例的属性值。如果目标对象为空，建议先实例化再拷贝；或者直接使用MapStruct/AutoValue生成器来直接返回新对象。

方法二：使用 Dozer 开源库

对于属性名不一致、需要类型深度转换或有更复杂映射规则的场景，可以使用专业映射工具 Dozer。

第1步：引入 Dozer 依赖

<dependency>
  <groupId>net.sf.dozer</groupId>
  <artifactId>dozer</artifactId>
  <version>5.5.1</version></dependency>

第2步：配置并使用 Mapper

Dozer支持XML配置文件映射复杂差异，也支持编程式默认映射。简单用法示例：

import org.dozer.DozerBeanMapper;
import java.util.ArrayList;
import java.util.List;

public class DozerConvertTest {
    public void convert() {
        // 1. 初始化Mapper
        DozerBeanMapper mapper = new DozerBeanMapper();
        
        // 2. 准备源数据
        TestDemoFrom fromObj = new TestDemoFrom();
        fromObj.setName("DozerUser");
        fromObj.setAge(30);
        
        // 3. 执行转换
        // map(source, destinationClass) 会自动创建目标对象的实例
        TestDemoDTO toObj = mapper.map(fromObj, TestDemoDTO.class);
        
        System.out.println(toObj.getName()); // 输出: DozerUser
    }
}

总结

处理Java对象间的转换是后端开发的日常高频任务。对于简单的同名属性复制，优先选择Spring内置的 BeanUtils，零依赖且性能良好；如果遇到异构对象深度转换或复杂的命名映射需求，可引入 Dozer 或使用更现代的 MapStruct 编译器插件。掌握这些工具能有效消除样板代码，让项目逻辑更加清晰。

以上就是Java中VO和DTO转换实现的详细内容，更多关于Java对象映射的资料请关注本站其它相关文章！