当前位置：首页 > news >正文

Lombok使用总结

news 2025/12/12 2:24:42

文章目录

- 介绍
- Lombok原理
- 常用注解
- - @Data
  - @Getter
  - @Setter
  - @ToString
  - @EqualsAndHashCode
  - @NoArgsConstructor
  - @AllArgsConstructor
  - @RequiredArgsConstructor
  - @Accessors(chain = true)
- 遇到的问题
- - 谨慎使用@Data
  - - 问题
    - 总结
  - @Builder和@Data不能共用
  - - 解决

介绍

官网：https://projectlombok.org/

Lombok项目是一个java库，它可以自动插入到编辑器和构建工具中，增强java的性能。不需要再写getter、setter或equals方法，只要有一个注解，你的类就有一个功能齐全的构建器、自动记录变量等等。
可以精简我们的代码的，让开发人员把精力放在业务上。

Lombok原理

Java的编译分为以下⼏个阶段：

解析与填充符号表->注解处理->分析与字节码⽣成->⽣成⼆进制class⽂件。

Lombok 使⽤的是 JDK 6 实现的 JSR 269: Pluggable Annotation Processing API (编译期的注解处理器)，它是在编译期时把 Lombok 的注解代码，转换为常规的 Java ⽅法⽽实现注⼊。
在编译期阶段，当 Java 源码被抽象成语法树 (AST) 之后，Lombok 会根据⾃⼰的注解处理器动态的修改AST，增加新的代码 (节点)，在这⼀切执⾏之后，再通过分析⽣成了最终的字节码 (.class) ⽂件，这就是Lombok 的执⾏原理

常用注解

@Data

为我们的实体类自动生成get、set、hashcode、equals 、toString方法与不带参数的构造方法。
它是一个混合注释，它包含了@Getter @Setter @RequiredArgsConstructor @ToString @EqualsAndHashCode的功能。

@Getter

生成get方法

@Setter

生成set方法

@ToString

生成toString方法

@EqualsAndHashCode

生成equals和hashCode方法

@NoArgsConstructor

生成无参构造

@AllArgsConstructor

生成有参构造

@RequiredArgsConstructor

生成有参构造，对于标有@NonNull注解的字段，还将生成一个显式的null检查

@Accessors(chain = true)

指定set方法通过this返回自己本身，以便于进行级联操作的执行。

遇到的问题

总结日常开发使用过程中遇到的问题

谨慎使用@Data

问题

子类不能完全代表父类
@EqualsAndHashCode注解里有个字段callSuper，它的默认值是false，意思是在重写时，不会将父类的字段写到equals里；而@Data这个注解由于包含了@EqualsAndHashCode，所以它也有这个特性，即子类强制实现了重写equals和hashCode，并且只重写了自己的属性，这时，问题就来了，当两个对象比较时，如果子类属性相同而父类属性不同，结果也为true，这是非常严重的bug。

总结

在使用@Data时，我们尽量把 @EqualsAndHashCode(callSuper = true)加上，因为你不加，它相当于是false；或者杜绝使用@Data，而用@Getter,@Setter,@ToString代替它。
具体还要取决于您的类层次结构，需要根据具体情况进行检查。

@Builder和@Data不能共用

由于添加@Builder会将@Data让类缺失无参构造器，因为很多框架都会调⽤⽆参构造去创建对象，所以会报错。

解决

方法一，
在无参构造函数上加上@Tolerate即可解决，目的是让Lombok在⽣成类的时候，对指定的构造函数不感知。

方法二，
直接使用无参构造器+有参构造器的方式，类上添加注解@RequiredArgsConstructor 来构建有参，添加注解@NoArgsConstructor来构建无参构造器，即可解决。