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

@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-冻结
}

@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
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;
    }
}

@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
}

@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);
    }
}

// 错误：Controller 直接返回 DTO，暴露敏感信息
@RestController
public class UserController {
    public UserOrderDTO getUserOrders(Long userId) {
        return userOrderService.getUserWithOrders(userId); // ❌ 暴露了 password 等字段
    }
}

// 错误：VO 包含计算逻辑
@Data
public class UserOrderVO {
    private BigDecimal orderAmount;
    private BigDecimal discount;
    
    // ❌ VO 只应承载数据，不应有业务方法
    public BigDecimal getPayAmount() {
        return orderAmount.subtract(discount); // 计算应在后端完成
    }
}

// 错误：为每个方法都创建 DTO
public class UserOrderService {
    public UserOrderDTO1 method1() { ... }
    public UserOrderDTO2 method2() { ... }
    public UserOrderDTO3 method3() { ... } // 维护噩梦
}

// 分层转换
DAO层 → Service层 → Controller层 → 前端
  DO   →   DTO    →    VO      → JSON

// DTO 命名：业务 + DTO
UserDTO, OrderDTO, UserOrderDTO
 
// VO 命名：页面/组件 + VO
OrderListVO, OrderDetailVO, UserProfileVO

@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("(?<=.).(?=.*@)", "*");
    }
}

@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;
    }
}