如何通过 Annotation Processor 在编译阶段自动生成 MapStruct 或 Lombok 风格的样板代码

风明吖_4201

风明吖_4201

2026-04-14

671人浏览

原创

标准annotation processor无法替代lombok或mapstruct:lombok依赖javac内部api修改ast,mapstruct需泛型元数据与框架集成,而processor仅能读取element、生成新文件,无法修改原类语义或获取运行时类型信息。

如何通过 annotation processor 在编译阶段自动生成 mapstruct 或 lombok 风格的样板代码

Annotation Processor 不能直接替代 MapStruct 或 Lombok 的核心能力——MapStruct 依赖注解驱动的接口实现生成,Lombok 则深度耦合 javac 的 AST 修改机制;你用标准 javax.annotation.processing.Processor 无法安全地重写 @Data 或 @Mapper 的全部行为,尤其涉及字段访问控制、getter/setter 语义、泛型桥接、甚至字节码级增强时,会掉进 javac 插件边界和编译器兼容性坑里。

为什么自研 Processor 很难复刻 Lombok 的 @Data

Lombok 不是普通注解处理器:它通过 javac 的内部 API(如 com.sun.tools.javac.tree.JCTree)直接修改语法树,并在解析/分析阶段注入节点。标准 Processor 只能在 ROUND 中读取已解析的 Element,无法添加新方法、修改修饰符、或生成带泛型擦除逻辑的桥接方法。

  • 你无法在 process() 里让 javac “认为”某个类已有 public String getName() 方法——它只生成额外 .java 文件或 .class,不参与当前类的符号解析
  • @SneakyThrows 这类异常处理重写,需操作 try/catch AST 节点,标准 Processor 没有入口
  • Lombok 的 @Builder 支持 builder 类继承、泛型推导、默认值表达式,这些依赖对 TreePath 和 Types 的实时求值,标准 API 不暴露

MapStruct 的 @Mapper 为什么也不适合用普通 Processor 模仿

MapStruct 的关键在于:它生成的是完整、可调试、类型安全的 impl 类,且能精确响应 @Mapping、@AfterMapping、@Context 等组合语义;这些需要理解目标类的完整继承链、泛型实参映射、甚至 Spring Bean 名称绑定。

剧火AI
剧火AI

剧火AI是一款AI文本写作工具,AI短剧创作者的一站式创作Agent。

下载
  • 标准 Processor 拿不到 TypeMirror 的运行时泛型信息(如 List<userdto></userdto> 中的 UserDto),只能靠字符串解析,极易出错
  • 它无法感知 Spring 的 @Qualifier 或 CDI 的 @Named,而 MapStruct 的 componentModel = "spring" 依赖这些元数据生成 @Autowired 字段
  • MapStruct 会为 @MapperConfig 做跨 @Mapper 的配置继承,这要求 Processor 维护全局处理上下文,但 javac 不保证所有 @Mapper 在同一 round 被发现

如果你真要动手,唯一可行的轻量路径是“生成辅助类”而非“替换原类”

放弃模拟 @Data 或 @Mapper,转而用 Processor 生成独立工具类,比如为 POJO 自动生成 JSON Schema、DTO-to-Entity 转换器骨架、或字段校验注解的反射检查器——这类代码不侵入原类语义,只读不写,风险可控。

  • 用 RoundEnvironment.getElementsAnnotatedWith(MyGenerateSchema.class) 扫描目标类
  • 用 Filer.createSourceFile() 写出 MyPojoSchema.java,内容基于 Element.getEnclosedElements() 提取字段名+类型
  • 避免生成方法体逻辑(如深拷贝),只生成结构化数据或空方法存根;复杂逻辑留到运行时用 BeanUtils.copyProperties() 或手动调用
  • 务必在 @SupportedOptions 中声明 "debug=true",并用 Messager.printMessage() 输出生成路径,否则 debug 时根本不知道文件写哪了

真正想控制编译期代码生成,要么用 Lombok(接受它的黑盒性),要么用 MapStruct(接受它的约定优先),要么上 Gradle 编译插件或 Java Agent——标准 Annotation Processor 是个“只读快照”,不是“可编程编译器”。别在 process() 里硬刚 AST,那不是它的设计位置。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10257

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7382

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6492

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1124

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

928

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1356

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2709

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20011

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1195

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
零基础精通 PS 视频教程
零基础精通 PS 视频教程

共268课时 | 119.6万人学习

前端工程师必备技能—PS切图
前端工程师必备技能—PS切图

共11课时 | 2.2万人学习

麦子学院Photoshop切片视频教程
麦子学院Photoshop切片视频教程

共13课时 | 4.3万人学习