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.

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

相关推荐
铁皮饭盒2 小时前
bun直接tsx,优雅!
javascript·后端
Cosolar2 小时前
藏在 Claude Code 里的极致浪漫:完整 187 条 Spinner Verbs 全收录
后端·程序员·代码规范
Csvn3 小时前
Linux 防火墙管理 — firewalld 实战
后端
Csvn3 小时前
`functools.lru_cache` —— 一行代码搞定缓存加速
后端·python
leeyi4 小时前
Multi-Agent:让多个 AI 分工协作完成复杂任务
后端·aigc·agent
长栎4 小时前
你的策略模式是 Map<String, Strategy>?那不过是最廉价的 if-else 替代品
后端
长栎4 小时前
你写的 abstract class 里全是钩子方法——模板模式不是让你填空,是让你别越界
后端
ping某4 小时前
语法树,到底是一棵什么形状的树?
后端
_柳青杨4 小时前
一文吃透 Node.js 事件循环:从原理到 Node 20+ 重大变更
javascript·后端
Alson_Code4 小时前
人机协作项目文档--HITL-AgentScope
后端·aigc·ai编程