这是一个非常实战的问题!把数据库里的"原始食材"(DO/Entity)加工成前端想要的"精美菜肴"(VO),是后端开发每天都要做的事情。
在 Java 后端,我们通常有 "笨办法" 和 "聪明办法" 两种处理方式。
✋ 笨办法:手动 Setter(适合字段少、逻辑复杂)
这是最基础的方法,就是老老实实地写代码,一个字段一个字段地拷贝。虽然繁琐,但控制力最强。
场景: 比如你要把数据库里的 status: 1 转换成前端能看懂的 statusText: "正常",或者把时间戳格式化成 "2026-05-15"。
java
// 假设这是从数据库查出来的 Entity (对应 DO)
User user = userRepository.findById(1L);
// 1. 创建 VO 对象
UserVO vo = new UserVO();
// 2. 手动拷贝字段
vo.setId(user.getId());
vo.setUsername(user.getUsername());
// 3. 【关键点】在这里做数据转换/脱敏
// 比如:密码绝对不能给前端
// 比如:把状态码转成文字
if (user.getStatus() == 1) {
vo.setStatusText("账号正常");
} else {
vo.setStatusText("已冻结");
}
// 比如:格式化时间
vo.setRegisterTimeStr(DateUtils.format(user.getCreateTime()));
return vo;
- 优点:想怎么改就怎么改,逻辑清晰。
- 缺点 :如果字段有 20 个,你得写 20 行
set/get代码,像个搬运工,容易手酸出错。
🧠 聪明办法:使用工具类(适合字段多、结构简单)
在实际工作中,为了偷懒(划掉)提高效率,我们会用专门的库来自动帮我们"搬运"数据。最推荐的是 MapStruct。
1. MapStruct(性能之王,强烈推荐)
它会在你编译代码的时候,自动生成那些繁琐的 setter 代码。既不用手写,速度又快。
-
第一步:定义规则(接口)
java// 告诉 MapStruct 怎么转换 @Mapper public interface UserConverter { // 实例化这个转换器 UserConverter INSTANCE = Mappers.getMapper(UserConverter.class); // 核心方法:把 User 转成 UserVO @Mapping(source = "status", target = "statusText", qualifiedByName = "statusConvert") UserVO toVO(User user); // 自定义特殊转换逻辑 @Named("statusConvert") default String statusConvert(Integer status) { return status == 1 ? "正常" : "冻结"; } } -
第二步:一行代码搞定
javaUser user = userRepository.findById(1L); // 啪!一下就好了,比手动写快多了 UserVO vo = UserConverter.INSTANCE.toVO(user);
2. Spring BeanUtils(简单粗暴,但有坑)
Spring 自带的工具,用起来很爽,但它是靠"运行时的反射"实现的,速度稍微慢一点点(一般项目感觉不到)。
java
UserVO vo = new UserVO();
// 只要字段名一样,它自动帮你拷过去
BeanUtils.copyProperties(user, vo);
// 注意:如果有不一样的字段(比如 time -> timeStr),拷完后还得手动补一刀
vo.setTimeStr(DateUtils.format(user.getTime()));
🛠️ 进阶技巧:在哪里转换?
你可能会问:"这代码写在 Controller 里还是 Service 里?"
最佳实践是:封装一个专门的 Converter 类。
不要在 Service 里写一堆 new UserVO(),也不要在 Controller 里写逻辑。你可以创建一个 UserConvert 类,把所有转换逻辑都丢进去。
这样,你的 Service 层看起来会非常干净:
java
@Service
public class UserService {
@Autowired
private UserRepository userRepository;
public UserVO getUserDetail(Long id) {
// 1. 查库
User user = userRepository.findById(id);
// 2. 转换(甩给转换器,Service 只负责业务,不负责脏活累活)
return UserConvert.INSTANCE.toVO(user);
}
}
📌 总结
- 刚开始学 / 字段很少时 :直接手动 Setter。虽然笨,但你能清楚地看到每一个字段是怎么变过去的,不容易晕。
- 正式工作 / 字段很多时 :一定要学 MapStruct。这是大厂标配,能让你少写几百行垃圾代码。
- 核心原则 :VO 是为了展示服务的。如果数据库里的数据太丑(比如乱码密码、难懂的状态码),一定要在转 VO 的那一瞬间把它"洗白"!