mapStruct 使用踩坑指南

一、缓存机制

经常因为变更字段(通常会这样),导致启动失败。需要清理生成的文件。

css 复制代码
/Users/uzong/IdeaProjects/uzong-crm/uzong-crm-manager/src/main/java/com/uzong/crm/manager/GroupManager.java:14:67
java: 找不到符号
  符号:   方法 getId()
  位置: 类型为com.uzong.crm.infra.database.idto.customerIdTO的变量 existsGroup

如果是 maven 管理。需要执行 maven clean

如果使用热部署插件,执行重新加载的时候,也需要执行 maven clean ,让缓存失效。

二、基础类型定制方法慎用

基础类型定义了一个特殊方法。当 customerId(long) 为0的时候,转换成null。

javascript 复制代码
default String mapCustomerId(Long customerId) {
    return customerId != null && customerId != 0L ? String.valueOf(customerId) : null;
}

然后在 mapping 中使用

less 复制代码
@Mappings({
        @Mapping(target = "customerId", expression = "java(mapCustomerId(mdto.getcustomerId()))")
})
CustomerVO mdtoToVO(CustomerMDTO mdto);

最终效果:

所有 Long 类型的字段,都采用了这个方法。影响面被大大扩大!

比如:long 类型在执行映射的时候也采用了这个方法

less 复制代码
customerVO.setId( mapCustomerId( mdto.getId() ) );

三、Long类型默认值 0

scss 复制代码
CustomerCreateParam createRequestToParam(CustomerCreateRequest request);
@Mappings({
        @Mapping(source = "customerId", target = "customerId", defaultValue = "0L")
})
CustomerUpdateParam updateRequestToParam(CustomerUpdateRequest request);

会生成代码:

kotlin 复制代码
Long.parseLong( request.getcustomerId() )

但执行代码会报错

php 复制代码
Exception in thread "main" java.lang.NumberFormatException: For input string: "0L"
        at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65)
        at java.lang.Long.parseLong(Long.java:589)
        at java.lang.Long.parseLong(Long.java:631)

如果设置 0,编译通不过!

arduino 复制代码
/Users/uzong/IdeaProjects/uzong-crm/uzong-crm-web/src/main/java/com/uzong/crm/web/converter/CustomerEndPointConverter.java:56:25
java: Can't map "0" to "Long customerId". Reason: L/l mandatory for long types.

目前是踩过的一些坑,后续可以继续补充。

相关推荐
计算机学姐4 分钟前
基于SpringBoot的运动服装销售系统【2026最新】
java·vue.js·spring boot·后端·spring·tomcat·mybatis
葵野寺5 分钟前
【RelayMQ】基于 Java 实现轻量级消息队列(五)
java·开发语言·java-rabbitmq
007php00713 分钟前
Go 面试题: new 和 make 是什么,差异在哪?
后端·算法·docker·容器·面试·职场和发展·golang
~kiss~1 小时前
MCP Go SDK学习一
开发语言·后端·golang
lovebugs1 小时前
Docker Java 开发者必须掌握的 Docker 命令大全
后端·docker·容器
COTAS2 小时前
K8S 知识框架和命令操作
java·容器·kubernetes
duration~2 小时前
SpringAI模型评估
java·spring boot·spring·ai编程
叫我阿柒啊2 小时前
从Java全栈开发到微服务架构:一次真实的面试实录
java·微服务·vue3·springboot·前端开发·后端开发·项目经验
james的分享2 小时前
Spring boot注解介绍
java·spring boot·后端
雨绸缪2 小时前
如何在 SAP PI 系统新增字段并传输给外部系统
后端