象山县住房建设局网站网络推广如何收费

精心整理了最新的面试资料和简历模板，有需要的可以自行获取

点击前往百度网盘获取
点击前往夸克网盘获取

---

Spring Boot整合MapStruct教程

1. 什么是MapStruct？

MapStruct是一个基于注解的Java代码生成器，用于对象属性映射的自动化实现。相比手动编写映射代码，它可以：

• 自动生成类型安全的映射实现类
• 减少样板代码
• 编译时生成代码（无运行时性能损耗）
• 支持复杂映射场景（嵌套对象、类型转换等）

2. 环境准备

• JDK 1.8+
• Spring Boot 3.x
• Maven/Gradle
• IDE（推荐IntelliJ IDEA）

3. 整合步骤

3.1 添加依赖

在pom.xml中添加：

<!-- 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>

如果使用Lombok，需要确保mapstruct-processor在lombok之后配置

3.2 创建实体与DTO

// User.java
@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {private Long id;private String username;private String email;private LocalDateTime createTime;
}// UserDTO.java
@Data
@NoArgsConstructor
@AllArgsConstructor
public class UserDTO {private String username;private String email;private String formattedDate;
}

3.3 创建Mapper接口

@Mapper(componentModel = "spring")
public interface UserMapper {@Mapping(source = "createTime", target = "formattedDate", dateFormat = "yyyy-MM-dd HH:mm")UserDTO toDto(User user);@Mapping(source = "formattedDate", target = "createTime",dateFormat = "yyyy-MM-dd HH:mm")User toEntity(UserDTO dto);
}

注解说明：

• @Mapper(componentModel = "spring")：生成Spring可注入的Mapper实现类
• @Mapping：定义字段映射规则
• 支持自动类型转换（如String <-> Date）

3.4 配置注解处理器（重要！）

在Maven的pom.xml中添加构建配置：

<build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><configuration><annotationProcessorPaths><path><groupId>org.mapstruct</groupId><artifactId>mapstruct-processor</artifactId><version>1.5.5.Final</version></path><!-- 如果有Lombok需要添加 --><path><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>${lombok.version}</version></path></annotationProcessorPaths></configuration></plugin></plugins>
</build>

3.5 使用Mapper

@RestController
public class UserController {@Autowiredprivate UserMapper userMapper;@GetMapping("/user")public UserDTO getUser() {User user = new User(1L, "john", "[e-mail]", LocalDateTime.now());return userMapper.toDto(user);}
}

4. 验证结果

生成的实现类在target/generated-sources/annotations/目录下，编译后会生成类似：

@Generated
@Component
public class UserMapperImpl implements UserMapper {@Overridepublic UserDTO toDto(User user) {// 自动生成的映射逻辑}@Overridepublic User toEntity(UserDTO dto) {// 自动生成的映射逻辑}
}

5. 高级用法

5.1 自定义转换方法

@Mapper(componentModel = "spring")
public interface UserMapper {default String statusToCode(Status status) {return status.name().toLowerCase();}
}

5.2 多对象合并

@Mapping(source = "user.name", target = "name")
@Mapping(source = "address.city", target = "city")
UserInfo merge(User user, Address address);

5.3 嵌套映射

@Mapper(uses = AddressMapper.class)
public interface UserMapper {UserDTO toDto(User user);
}

6. 常见问题

Q: 为什么我的Mapper接口实现类没有生成？
A: 检查：

1. 是否添加了mapstruct-processor依赖
2. Maven是否执行了mvn clean compile
3. IDE是否启用了注解处理

Q: 如何与Lombok配合使用？
A: 确保在pom.xml中Lombok配置在MapStruct之前

Q: 如何处理字段名称不一致的情况？
A: 使用@Mapping注解显式指定映射关系

7. 总结

通过整合MapStruct可以：

• 减少80%以上的手动映射代码
• 提升代码可维护性
• 保持类型安全
• 轻松处理复杂映射场景

建议在DTO/VO转换、微服务间数据传输等场景优先使用MapStruct。

---

提示：实际开发中推荐结合Spring Boot Validation进行数据校验，构建更健壮的应用程序。