LomBok常用注解及详细介绍

r囧r小猫 2024-03-03 00:49 69阅读 0赞

## LomBok常用注解及详细介绍 ##

### 前言 ###

*  [Lombok][]是一个作用于编辑器和构建工具的 Java 库，可以对编写的 Java 代码进行增强，比如说不用再写实体类的 getter 方法，equals 方法而是自动生成，自动生成日志输出变量等等，减少重复模板的代码。

### LomBok常用注解图 ###

*  ![在这里插入图片描述][883a3bf007e24926a5e560990f8a6212.png]

### pom.xml文件中添加LomBok依赖 ###

*      <dependencies>
                
                <dependency>
                    <groupId>org.projectlombok</groupId>
                    <artifactId>lombok</artifactId>
                    <version>1.18.20</version>
                </dependency>
            </dependencies>

### 常用注解 ###

#### **@Getter/@Setter** ####

*  **自动生成getter/setter**
 *  ![在这里插入图片描述][111d8d721af74a8eb951c02ba25dc5b6.png]

#### @ToString ####

*  自动重写 `toString()` 方法，会印出所有变量
 *  ![在这里插入图片描述][30f2730f0952445f89045010f782f313.png]

#### @EqualsAndHashCode ####

*  自动生成 `equals(Object other)` 和 `hashcode()` 方法，包括所有非静态变量和非 transient 的变量
 *  ![在这里插入图片描述][5992d52157e64f319d94945c99cfe98c.png]
 *  如果某些变量不想要加进判断，可以透过 exclude 排除，也可以使用 of 指定某些字段
 *  ![在这里插入图片描述][242fcec651e34ca08d3f04a7758601da.png]
 *  Q : 为什么只有一个整体的 @EqualsAndHashCode 注解，而不是分开的两个 @Equals 和 @HashCode？
 *  A : 在 Java 中有规定，当两个对象 equals 时，他们的 hashcode 一定要相同，反之，当 hashcode 相同时，对象不一定 equals。所以 equals 和 hashcode 要一起实现，免得发生违反 Java 规定的情形发生

#### @NoArgsConstructor, @AllArgsConstructor, @RequiredArgsConstructor ####

*  这三个很像，都是在自动生成该类的构造器，差别只在生成的构造器的参数不一样而已
 *  **@NoArgsConstructor** : 生成一个没有参数的构造器
 *  ![在这里插入图片描述][98135d065a754639a2cad3d2e0cf83ac.png]
 *  **@AllArgsConstructor** : 生成一个包含所有参数的构造器
 *  ![在这里插入图片描述][45249785bbc64be2bf3c68616ced4ea0.png]
 *  这里注意一个 Java 的小坑，当我们没有指定构造器时，Java 编译器会帮我们自动生成一个没有任何参数的构造器给该类，但是如果我们自己写了构造器之后，Java 就不会自动帮我们补上那个无参数的构造器了
 *  然而很多地方（像是 Spring Data JPA），会需要每个类都一定要有一个无参数的构造器，所以你在加上 @AllArgsConstructor 时，一定要补上@NoArgsConstrcutor，不然会有各种坑等着你
 *  @RequiredArgsConstructor : 生成一个包含 “特定参数” 的构造器，特定参数指的是那些有加上 final 修饰词的变量们
 *  补充一下，如果所有的变量都是正常的，都没有用 final 修饰的话，那就会生成一个没有参数的构造器
 *  ![在这里插入图片描述][4cdcc6e9cb9b4e0da954df9f8d71d1ea.png]

#### @Data ####

*  整合包，只要加了 @Data 这个注解，等于同时加了以下注解
    
     *  @Getter/@Setter
     *  @ToString
     *  @EqualsAndHashCode
     *  @RequiredArgsConstructor
 *  ![在这里插入图片描述][9377e48e10e043b084f68ab96861b12f.png]
 *  @Data 是使用频率最高的 lombok 注解，通常 @Data 会加在一个值可以被更新的对象上，像是日常使用的 DTO 们、或是 JPA 里的 Entity 们，就很适合加上 @Data 注解，也就是@Data for mutable class

#### @Value ####

*  也是整合包，但是他会把所有的变量都设成 final 的，其他的就跟 @Data 一样，等于同时加了以下注解
    
     *  @Getter (注意没有setter)
     *  @ToString
     *  @EqualsAndHashCode
     *  @RequiredArgsConstructor
 *  ![在这里插入图片描述][ac005f2290d74487b34ff0ee6ab7ad04.png]
 *  上面那个 @Data 适合用在 POJO 或 DTO 上，而这个 @Value 注解，则是适合加在值不希望被改变的类上，像是某个类的值当创建后就不希望被更改，只希望我们读它而已，就适合加上 @Value 注解，也就是 @Value for immutable class
 *  另外注意一下，此 lombok 的注解 @Value 和另一个 Spring 的注解 @Value 撞名，在 import 时不要 import 错了

#### @Builder ####

*  自动生成流式 set 值写法，从此之后再也不用写一堆 setter 了
 *  ![在这里插入图片描述][cd9e218f7b7943cf9fc0201be5c58fe9.png]
 *  注意，虽然只要加上 @Builder 注解，我们就能够用流式写法快速设定对象的值，但是 setter 还是必须要写不能省略的，因为 Spring 或是其他框架有很多地方都会用到对象的 getter/setter 对他们取值/赋值
 *  所以通常是 @Data 和 @Builder 会一起用在同个类上，既方便我们流式写代码，也方便框架做事

#### @Slf4j ####

*  自动生成该类的 log 静态常量，要打日志就可以直接打，不用再手动 new log 静态常量了
 *  ![在这里插入图片描述][ee26c470f1e846dfaaac5415dc186d56.png]
 *  除了 @Slf4j 之外，lombok 也提供其他日志框架的变种注解可以用，像是 @Log、@Log4j…等，他们都是帮我们创建一个静态常量 log，只是使用的库不一样而已
 *      @Log //对应的log语句如下
        private static final java.util.logging.Logger log = java.util.logging.Logger.getLogger(LogExample.class.getName());
         
        @Log4j //对应的log语句如下
        private static final org.apache.log4j.Logger log = org.apache.log4j.Logger.getLogger(LogExample.class);
 *  SpringBoot默认支持的就是 slf4j + logback 的日志框架，所以也不用再多做啥设定，直接就可以用在 SpringBoot project上，log 系列注解最常用的就是 @Slf4j

[Lombok]: https://so.csdn.net/so/search?q=Lombok&spm=1001.2101.3001.7020
[883a3bf007e24926a5e560990f8a6212.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/b6a51d9cb1a24469a175f13f75c29519.png
[111d8d721af74a8eb951c02ba25dc5b6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/c5d0e09948d547a18badda48afba5820.png
[30f2730f0952445f89045010f782f313.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/e482017e319f4a5b8976d1772502bb7f.png
[5992d52157e64f319d94945c99cfe98c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/1afa097c12714bf38f9f6f9a259c9c62.png
[242fcec651e34ca08d3f04a7758601da.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/f64053772e4b42c8b377860f53afb437.png
[98135d065a754639a2cad3d2e0cf83ac.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/70d69e1ef0854dc1a94575d2f199af11.png
[45249785bbc64be2bf3c68616ced4ea0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/01d41c49d20944698d62518b3fba0101.png
[4cdcc6e9cb9b4e0da954df9f8d71d1ea.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/32f26955d9ac41d8ade42b627fb6b9d6.png
[9377e48e10e043b084f68ab96861b12f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/03b6e3e53e95401e8336cce89a47f904.png
[ac005f2290d74487b34ff0ee6ab7ad04.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/98ea521f3cf84eabb98548c99e724bcb.png
[cd9e218f7b7943cf9fc0201be5c58fe9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/e4473577d8ed43f9a893667e49cc7208.png
[ee26c470f1e846dfaaac5415dc186d56.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/03/fc902107865c46fdbb5072789465782e.png