Java中DTO和VO的区别举例详解_Java

前言

dto（data transfer object）和 vo（value object / view object）是 java 开发中用于不同层次间数据传递的对象，但它们的设计目的和使用场景有本质区别。

一、概念定义

dto（data transfer object）

定义：用于在不同层或系统之间传输数据的对象
核心作用：减少远程调用次数，打包多个数据一次性传输
典型场景：service 层返回数据给 controller 层、微服务间调用

vo（value object / view object）

定义：用于前端展示的数据对象，封装页面需要的数据
核心作用：适配前端展示需求，隐藏后端敏感字段
典型场景：controller 层返回给前端

二、核心区别对比表

对比维度	dto (data transfer object)	vo (view object)
设计目的	减少网络调用，批量传输数据	适配前端展示需求
数据范围	可能包含多个聚合的数据	针对单个页面/组件定制
数据敏感度	可包含内部字段	必须隐藏敏感字段（密码、金额等）
使用层次	service ↔ controller、微服务间调用	controller ↔ 前端
字段格式化	通常是原始数据类型	包含格式化后的数据（如日期、金额显示格式）
变更频率	相对稳定	随前端需求频繁变化

三、详细说明与代码示例

场景：用户订单详情查询

数据库实体（do - data object）

@entity
@table(name = "t_user")
public class userdo {
    private long id;
    private string username;
    private string password; // 敏感字段
    private string email;
    private string phone;
    private localdatetime createtime;
    private localdatetime updatetime;
    private integer status; // 0-注销 1-正常 2-冻结
}

dto（service 层返回）

@data
public class userorderdto {
    // 用户基本信息
    private long userid;
    private string username;
    private string email; // 可能包含敏感信息
    
    // 订单列表（跨聚合数据）
    private list<orderdto> orders;
    
    // 统计信息
    private integer totalordercount;
    private bigdecimal totalamount;
    
    // 原始数据类型
    private localdatetime usercreatetime;
}

使用场景：service 层查询用户和订单数据，打包返回给 controller

@service
public class userorderservice {
    public userorderdto getuserwithorders(long userid) {
        userdo user = userdao.findbyid(userid);
        list<orderdo> orders = orderdao.findbyuserid(userid);
        
        // 转换并聚合数据
        userorderdto dto = new userorderdto();
        dto.setuserid(user.getid());
        dto.setusername(user.getusername());
        dto.setemail(user.getemail()); // 直接暴露原始邮箱
        dto.setorders(convertorders(orders));
        dto.settotalordercount(orders.size());
        return dto;
    }
}

vo（controller 层返回前端）

@data
public class userordervo {
    // 前端展示字段（脱敏）
    private long userid;
    private string username;
    private string maskedemail; // 脱敏：a****@gmail.com
    
    // 订单数据（按需展示）
    private list<ordervo> orders;
    
    // 格式化后的数据
    private string formattedtotalamount; // "¥9,999.00"
    private string usercreatetimedesc; // "2025-01-15 12:00"
    
    // 前端状态（计算得出）
    private string userstatustext; // "正常" 而非 1
    
    // 不包含：password, phone, raw status
}

使用场景：controller 层转换 dto 为 vo，适配前端展示

@restcontroller
@requestmapping("/api/users")
public class userordercontroller {
    
    @resource
    private userorderservice userorderservice;
    
    @getmapping("/{userid}/orders")
    public resultvo<userordervo> getuserorders(@pathvariable long userid) {
        userorderdto dto = userorderservice.getuserwithorders(userid);
        
        // dto → vo 转换（关键一步！）
        userordervo vo = new userordervo();
        vo.setuserid(dto.getuserid());
        vo.setusername(dto.getusername());
        
        // 1. 脱敏处理
        vo.setmaskedemail(maskemail(dto.getemail())); // a****@gmail.com
        
        // 2. 数据格式化
        vo.setformattedtotalamount(formatcurrency(dto.gettotalamount()));
        vo.setusercreatetimedesc(formatdatetime(dto.getusercreatetime()));
        
        // 3. 状态转换
        vo.setuserstatustext(convertstatustotext(user.getstatus())); // "正常"
        
        // 4. 按需过滤字段
        vo.setorders(converttoordervo(dto.getorders()));
        
        return resultvo.success(vo);
    }
}

四、常见误区与反例

❌ 误区 1：dto 和 vo 混用

// 错误：controller 直接返回 dto，暴露敏感信息
@restcontroller
public class usercontroller {
    public userorderdto getuserorders(long userid) {
        return userorderservice.getuserwithorders(userid); // ❌ 暴露了 password 等字段
    }
}

❌ 误区 2：vo 包含业务逻辑

// 错误：vo 包含计算逻辑
@data
public class userordervo {
    private bigdecimal orderamount;
    private bigdecimal discount;
    
    // ❌ vo 只应承载数据，不应有业务方法
    public bigdecimal getpayamount() {
        return orderamount.subtract(discount); // 计算应在后端完成
    }
}

❌ 误区 3：过度使用 dto 导致类爆炸

// 错误：为每个方法都创建 dto
public class userorderservice {
    public userorderdto1 method1() { ... }
    public userorderdto2 method2() { ... }
    public userorderdto3 method3() { ... } // 维护噩梦
}

✅ 正确做法：合理复用 dto，仅在字段差异大时创建新类

五、与其他对象的关系

在分层架构中，完整的对象体系如下：

完整对象体系

缩写	全称	作用位置	示例
do	data object	持久层 ↔ 数据库	`userdo`（对应数据库表）
dto	data transfer object	service ↔ controller	`userorderdto`（聚合数据）
vo	view object	controller ↔ 前端	`userordervo`（脱敏+格式化）
bo	business object	service 层内部	`orderbo`（处理业务逻辑）
po	persistant object	同 do（老叫法）	`userpo`
ao	application object	应用层参数	`loginao`（登录参数）

六、最佳实践总结

1. 转换时机明确

// 分层转换
dao层 → service层 → controller层 → 前端
  do   →   dto    →    vo      → json

2. 命名规范

// dto 命名：业务 + dto
userdto, orderdto, userorderdto
 
// vo 命名：页面/组件 + vo
orderlistvo, orderdetailvo, userprofilevo

3. 工具类辅助转换

@component
public class userconverter {
    
    // do → dto
    public userdto todto(userdo userdo) {
        userdto dto = new userdto();
        beanutils.copyproperties(userdo, dto);
        return dto;
    }
    
    // dto → vo（关键：脱敏+格式化）
    public uservo tovo(userdto userdto) {
        uservo vo = new uservo();
        vo.setuserid(userdto.getuserid());
        vo.setusername(userdto.getusername());
        vo.setmaskedemail(this.maskemail(userdto.getemail()));
        vo.setstatustext(this.convertstatus(userdto.getstatus()));
        return vo;
    }
    
    private string maskemail(string email) {
        // 脱敏逻辑
        return email.replaceall("(?<=.).(?=.*@)", "*");
    }
}

4. 统一返回结构

@data
public class resultvo<t> {
    private int code;      // 状态码
    private string message; // 提示信息
    private t data;        // 实际数据（vo/dto）
    
    public static <t> resultvo<t> success(t data) {
        resultvo<t> result = new resultvo<>();
        result.setcode(200);
        result.setmessage("success");
        result.setdata(data);
        return result;
    }
}

七、总结

规则	dto	vo
核心目标	传输效率（减少调用次数）	展示安全（适配前端+脱敏）
数据来源	可能跨多个聚合	通常基于单个 dto
是否脱敏	❌ 否	✅ 必须脱敏
是否格式化	❌ 原始数据	✅ 前端友好格式
位置	service → controller	controller → 前端