在Spring开发中将DTO 映射到 Entity 的三种常用方式

已于 2025-03-16 18:34:33 修改
阅读量313 收藏 7
点赞数 4
分类专栏： Java 文章标签： java spring spring boot spring cloud
于 2025-02-27 07:25:14 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/yuxzlucy/article/details/145893452
版权

在 Spring 开发中，将 DTO（数据传输对象）映射到 Entity（实体类）是常见需求，特别是在分层架构中（如 Controller、Service、Repository）。以下是基于 UserEntity, RoleEntity, UserDTO, UserController, UserService, 和 UserRepository 的示例，展示几种常用的 DTO 到 Entity 映射方式，包括手动映射、Spring 的 BeanUtils、以及 MapStruct 等工具的使用场景和实现。

示例背景

假设我们有以下类：

  • UserEntity：用户实体类
  • RoleEntity：角色实体类
  • UserDTO：用户数据传输对象
  • UserController：控制器
  • UserService：服务层
  • UserRepository：数据访问层

1. 数据模型定义

数据模型是关系数据库表到Java代码的映射。

UserEntity

import lombok.Data;
import javax.persistence.*;
import java.time.LocalDateTime;
import java.util.HashSet;
import java.util.Set;

@Entity
@Table(name = "users")
@Data
public class UserEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false, unique = true)
    private String username;

    @Column(nullable = false)
    private String password;

    private String email;

    @ManyToMany(fetch = FetchType.EAGER)
    @JoinTable(
        name = "user_roles",
        joinColumns = @JoinColumn(name = "user_id"),
        inverseJoinColumns = @JoinColumn(name = "role_id")
    )
    private Set<RoleEntity> roles = new HashSet<>();

    private LocalDateTime createdAt;
}

RoleEntity

import lombok.Data;
import javax.persistence.*;

@Entity
@Table(name = "roles")
@Data
public class RoleEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false, unique = true)
    private String name;

    private String description;
}

2. 传输数据模型定义

传输数据模型是来自前端界面用户输入的数据到Java代码的映射。

UserDTO

import lombok.Data;
import javax.validation.constraints.NotBlank;
import java.util.Set;

@Data
public class UserDTO {
    private Long id;

    @NotBlank(message = "用户名不能为空")
    private String username;

    @NotBlank(message = "密码不能为空")
    private String password;

    private String email;

    private Set<String> roles; // 角色名称集合
}

3. 常用映射方式

方法 1：手动映射

手动映射是最简单直接的方式，适合字段较少或需要自定义逻辑的场景。

UserService 示例

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    @Autowired
    private PasswordEncoder passwordEncoder;

    public UserEntity createUser(UserDTO userDTO) {
        UserEntity userEntity = new UserEntity();
        userEntity.setUsername(userDTO.getUsername());
        userEntity.setPassword(passwordEncoder.encode(userDTO.getPassword())); // 加密密码
        userEntity.setEmail(userDTO.getEmail());
        userEntity.setCreatedAt(LocalDateTime.now());

        // 处理角色（假设角色已存在数据库）
        if (userDTO.getRoles() != null && !userDTO.getRoles().isEmpty()) {
            Set<RoleEntity> roles = new HashSet<>();
            for (String roleName : userDTO.getRoles()) {
                RoleEntity role = new RoleEntity();
                role.setName(roleName);
                roles.add(role); // 这里简化，实际应从数据库查询
            }
            userEntity.setRoles(roles);
        }

        return userRepository.save(userEntity);
    }
}

优点：

  • 完全控制映射逻辑。
  • 适合复杂业务逻辑。

缺点：

  • 代码量多，容易出错，维护成本高。

方法 2：使用 Spring 的 BeanUtils

Spring 的 BeanUtils 可以快速拷贝相同字段名的属性，减少手动赋值的工作量。

UserService 示例

import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    @Autowired
    private PasswordEncoder passwordEncoder;

    public UserEntity createUser(UserDTO userDTO) {
        UserEntity userEntity = new UserEntity();
        BeanUtils.copyProperties(userDTO, userEntity); // 拷贝相同字段名的属性

        // 处理密码加密和额外字段
        userEntity.setPassword(passwordEncoder.encode(userDTO.getPassword()));
        userEntity.setCreatedAt(LocalDateTime.now());

        // 处理角色
        if (userDTO.getRoles() != null && !userDTO.getRoles().isEmpty()) {
            Set<RoleEntity> roles = new HashSet<>();
            for (String roleName : userDTO.getRoles()) {
                RoleEntity role = new RoleEntity();
                role.setName(roleName);
                roles.add(role); // 实际应查询数据库
            }
            userEntity.setRoles(roles);
        }

        return userRepository.save(userEntity);
    }
}

优点：

  • 减少手动赋值的代码量。
  • 简单易用。

缺点：

  • 仅支持字段名完全匹配的拷贝。
  • 无法处理复杂映射（如 Set<String> 到 Set<RoleEntity>）。

方法 3：使用 MapStruct

MapStruct 是目前最推荐的方式，它通过注解生成高效的映射代码，支持复杂映射和自定义逻辑。

3.1 添加 MapStruct 依赖

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>1.5.5.Final</version>
</dependency>
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>1.5.5.Final</version>
    <scope>provided</scope>
</dependency>

3.2 定义映射接口 (UserMapper.java)

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.Named;
import org.mapstruct.factory.Mappers;

import java.time.LocalDateTime;
import java.util.Set;
import java.util.stream.Collectors;

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

    UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);

    @Mapping(target = "password", source = "password") // 密码需额外处理
    @Mapping(target = "createdAt", expression = "java(java.time.LocalDateTime.now())")
    @Mapping(target = "roles", source = "roles", qualifiedByName = "mapRoles")
    UserEntity toEntity(UserDTO userDTO);

    @Mapping(target = "roles", source = "roles", qualifiedByName = "mapRoleNames")
    UserDTO toDto(UserEntity userEntity);

    @Named("mapRoles")
    default Set<RoleEntity> mapRoles(Set<String> roleNames) {
        if (roleNames == null) return null;
        return roleNames.stream()
            .map(name -> {
                RoleEntity role = new RoleEntity();
                role.setName(name);
                return role; // 实际应从数据库查询
            })
            .collect(Collectors.toSet());
    }

    @Named("mapRoleNames")
    default Set<String> mapRoleNames(Set<RoleEntity> roles) {
        if (roles == null) return null;
        return roles.stream()
            .map(RoleEntity::getName)
            .collect(Collectors.toSet());
    }
}

3.3 UserService 示例

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    @Autowired
    private UserMapper userMapper;

    @Autowired
    private PasswordEncoder passwordEncoder;

    public UserDTO createUser(UserDTO userDTO) {
        UserEntity userEntity = userMapper.toEntity(userDTO);
        userEntity.setPassword(passwordEncoder.encode(userDTO.getPassword())); // 加密密码
        UserEntity savedEntity = userRepository.save(userEntity);
        return userMapper.toDto(savedEntity);
    }
}

优点：

  • 自动生成映射代码，减少手动工作。
  • 支持复杂映射和自定义逻辑。
  • 与 Spring 集成良好，可注入依赖。

缺点：

  • 需额外引入依赖和学习成本。

4. 完整示例

UserRepository

import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<UserEntity, Long> {
}

UserController

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.validation.Valid;

@RestController
@RequestMapping("/api/users")
public class UserController {

    @Autowired
    private UserService userService;

    @PostMapping
    public ResponseEntity<UserDTO> createUser(@Valid @RequestBody UserDTO userDTO) {
        UserDTO createdUser = userService.createUser(userDTO);
        return ResponseEntity.ok(createdUser);
    }
}

注意事项

  • 角色处理：上述示例中角色直接创建为新对象，实际开发中应从数据库查询已有角色（如通过 RoleRepository）。
  • 密码加密：始终在服务层对密码进行加密处理。
  • 双向映射：MapStruct 支持 Entity 到 DTO 的反向映射，方便返回数据。

5. 选择建议

方式适用场景优点缺点
手动映射小型项目或复杂逻辑灵活，易调试代码冗余，维护成本高
BeanUtils字段名一致的简单映射简单，代码少不支持复杂映射
MapStruct中大型项目，复杂映射高效，自动生成，支持扩展需学习和配置依赖

推荐：对于中小型项目，BeanUtils 结合少量手动逻辑即可；对于大型项目或需要长期维护的系统，强烈推荐使用 MapStruct，因其扩展性和可维护性更强。

【微服务】mybatis typehandler使用详解
congge
02-25 6806
mybatis typehandler 使用详解
spring boot
weixin_67883701的博客
07-05 1817
spring boot
springboot~ObjectMapper~dto到entity的自动赋值
08-27
主要介绍了springboot~ObjectMapper~dto到entity的自动赋值,本文分三种情况给大家介绍，需要的朋友可以参考下
Spring Boot中的数据传输对象（DTO）
Eddie_920的博客
05-08 5596
探索在Spring Boot中使用数据传输对象（DTO）的好处，本文包括了手动创建DTO、使用ModelMapper和Lombok创建DTO的示例。
在spring中该如何使用DTO，以及DTO和Entity的关系
weixin_30484739的博客
03-31 6101
1. DTO是用于将后台的数据结构（javaBean）转换为对用户友好的表现方式的数据结构，同时也能防止后台数据直接传送到前台而存在的潜在危险。 2. 可以时候要哪个springbot框架提供的转换器接口：org.springframework.core.convert.converter.Converter，来实现实体类和DTO的转换 3.DTO是合理的分配应该是：一个entity对应两...
springboot的DTO是什么
weixin_42599908的博客
02-15 1519
在 Spring Boot 中，DTO 是数据传输对象(Data Transfer Object)的缩写，是用于在不同层之间传递数据的一个Java对象。DTO 通常包含在业务逻辑层和表示层之间传输的数据，以及用于映射到数据库实体的数据。DTO 的目的是将数据从一个对象传递到另一个对象，而不暴露底层的数据模型。 使用 DTO 可以帮助实现松耦合和单一职责原则，因为它允许在不同的层之间传输数据而不必暴...
实体与Dto（MODEL）之间的转换问题
zj20165149的博客
09-10 1912
文章目录实体与Dto（MODEL）之间的转换问题 实体与Dto（MODEL）之间的转换问题 在开发的过程中，实体之间相互赋值是很正常的事，但是我们一般的方法都通过set和get方法来进行的，如果要赋值的字段少那还行，但是需要赋值的字段超过10个，那就是个灾难，你会看到整屏代码中全是set和get方法。 两个实体属性的字段几乎完全相同 两个字实体有部分字段相同 源实体只有部分字段赋值，目标实体有完整的值 情况一： 用到最多的就是entity和dto之间的转换，使用Spring的工具类BeanUtils来解
Spring5，Service层对DTO文件进行数据格式校验.
dear_Alice_moon的专栏
02-08 1007
Spring5，Service层对DTO文件进行数据格式校验.
Swagger_Dto_to_Entity_Mapstruct
03-10
标题中的"Swagger_Dto_to_Entity_Mapstruct"是一个项目或教程，旨在展示如何使用MapStruct库在Java中将Swagger定义的数据传输对象（DTOs）映射到实体类。MapStruct是一个代码生成库，它极大地简化了对象到对象映射的...
近40000字带你走完Spring Boot工程开发流程
Java_LingFeng的博客
10-29 963
Spring Boot是Spring官方的一个产品，其本质上是一个基于Maven的、以Spring框架作为基础的进阶框架，很好的支持了主流的其它框架，并默认完成了许多的配置，其核心思想是“约定大于配置”。
使用Spring Boot开发员工管理REST API及源码解析
Spring Boot框架建立在Java平台之上，因此在开发Spring Boot应用程序时，需要使用Java语言。 7. CRUD API开发实践 在本文中，我们将具体实践如何使用Spring Boot开发一个员工管理API，这包括创建RESTful服务来执行...
springboot项目中dto、entity、vo有什么区别
weixin_73378557的博客
07-27 530
实体类大多数都是分为三个部分dto、entity、vo，在这里给讲解一下三个部分的区别和具体用处(在这里提醒一下这三种类只是一种代码的规范只用entity也行，但是看起来过于繁琐，不适用于代码各个层次的开发)。
springboot 项目 实体映射泛型
sccd2009的专栏
07-23 530
项目需求，可能多个不同的实体转成同样一个实体，将共同的部分抽象出来，实现不同实体的转化，打乱排序。
Spring学习 基础（三）MVC
qq_42767993的博客
03-09 1229
在Spring框架中，这些层通常由不同的Spring组件来实现，比如使用@Repository注解的类实现持久层，@Service注解的类实现业务层，@Controller或@RestController注解的类实现表示层。这种异常处理方式下，会给所有或者指定的 Controller 织入异常处理的逻辑（AOP），当 Controller 中的方法抛出异常的时候，由被@ExceptionHandler 注解修饰的方法进行处理。业务层协调应用程序的工作流程，处理用户请求，并对持久层发送的数据执行业务决策。
Mybatis-Plus之连表查询的基本实现
HackDaily
08-28 9799
对于连表查询，Mybatis-Plus官方并没有给出解决方法，依托Mybatis-Plus-Join可以实现连表查询，也支持一对一、一对多查询。
springboot入门-DTO数据传输层
最新发布
shanzhizi的专栏
04-26 591
在 Spring Boot 应用中，DTO（Data Transfer Object，数据传输对象） 是专门用于在不同层（如 Controller 层、Service 层、外部系统）之间传输数据的对象。它的核心目的是解耦数据模型和业务逻辑，避免直接暴露数据库实体（Entity）的结构，同时优化数据传输的效率和安全性。
springboot中DTO、VO、Entity相互转换
m0_51431448的博客
01-21 881
这个很简单，其实就是标识前端传递的参数字段是什么，就是允许我们后端接受的参数字段和前端传递的字段可以不一致，如果不一致我们后端就可以使用@JsonProperty进行映射。同样的我在VO中使用@JSONField注解，上面的例子是把DTO转为VO，VO中的@JSONField对应的就是DTO中的字段。在我们平时开发中，dto、vo、entity之间的相互转换是很频繁的操作，这篇就简单记录一下我在平时开发中转换的方法。VO：平时开发中，一般会定义VO（view object）来封装返回给前端的数据。
DTO与Entity相互转化
热门推荐
我的博客
08-22 1万+
import java.lang.reflect.Method; import java.util.concurrent.ConcurrentHashMap; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.cglib.beans.BeanCopier;
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值