六，Spring Boot 容器中 Lombok 插件的详细使用，简化配置，提高开发效率

@

1. Lombok 介绍

Lombok 作用：

1. 简化 Java Bean开发，可以使用 Lombok 的注解让代码更加简洁。
2. Java项目中，很多没有技术含量但又必须存在的代码；比如：Pojo 的 getter/setter/toString ；异常处理：I/O流的关闭操作等等。
3. Java项目中，很多没有技术含量但又必须存在的代码：比如：这些代码既没有技术含量，又影响着代码的美观，Lombok 应运而生。

Spring Boot 和 IDEA 官方支持

1. IDEA 2020已经内置了 Lombok插件
2. Spring Boot 2.1.x之后的版本也在 Stater中内置了 Lombok 依赖

2. Lombok 常用注解

@Data：注解在类上，提供类所有属性的getting和setting方法，此外还提供了equals,canEqual,hashCode,toString方法
@Setter: 注解在属性上，为属性提供 setting 方法，注解在类上，则为类中的所有属性提供 set()方法。
@Getter: 注解在属性上，为属性提供 getting 方法注解在类上，则为类中的所有属性提供 get()方法。
@Log4j：注解在类上：为类提供了一个属性名为: log 的 log4j的日志对象
@NoArgsConstructor: 注解在类上，为类提供一个无参的构造方法,(一定会提供)
@AllArgsConstructor: 注解在类上，为类提供一个全参的构造方法
@Cleanup: 可以关闭流
@Builder: 被注解的类加个构造者模式
@Synchronized: 加同步锁 
@SneakyThrows: 等同于try/catcher捕获异常
@NonNull:如果给参数加个这个注解，参数为null会抛出空指针异常
@Value: 注解和@Value类似，区别在于它会把所有成员变量默认定义为 private final 修饰，并且不会生产set()方法 

下面我们测试，使用几个，在开发中比较常用的注解 。

首先想要使用上 Lombok 需要导入相关 jar 依赖，也可以不用特别导入，直接使用 Spring Boot 自带内置的即可。

   <!--        引入 lombok ，使用版本仲裁-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.rainbowsea</groupId>
    <artifactId>springboot_lombok</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!--    导入SpringBoot 父工程-规定写法-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.3</version>
    </parent>


    <dependencies>
        <!--    导入web项目场景启动器：会自动导入和web开发相关的jar包所有依赖【库/jar】-->
        <!--    后面还会在说明spring-boot-starter-web 到底引入哪些相关依赖-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!--        引入 lombok ，使用版本仲裁-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    </dependencies>

</project>

2.1 @ToString

@ToString： // 在编译时，生成 toString，注意：默认情况下，会生成一个无参构造器。

package com.rainbowsea.springboot.bean;


import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;




@ToString  // 在编译时，生成 toString，注意：默认情况下，会生成一个无参构造器
public class Furn {
    private Integer id = 100;
    private String name = "张三";
    private Double price = 999.0;


}

使用 lombok 注解简化代码，可以通过 idea 自带的反编译功能 target，看Furn.class的源码，就
可以看到生成的完整代码。

如果目录当中没有 target 目录显示，可以进行如下操作：

2.2 @Setter

@Setter 注解： 注解在属性上，为属性提供 setting 方法，注解在类上，则为类中的所有属性提供 set()方法。

首先，我们先注解使用在属性上。

package com.rainbowsea.springboot.bean;


import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;


public class Furn {

    @Setter // 注解在属性上，编译生成一个，该属性的 set()方法：默认情况下，会生成一个无参构造器
    private Integer id = 100;

    private String name = "张三";
    private Double price = 999.0;


}

添加到类上，为类中所有的属性都添加，set() 方法。

2.3 @Data

@Data ：注解在类上，提供类所有属性的getting和setting方法，此外还提供 equals，canEqual，hashCode，toString方法， @RequiredArgsConstructor

特别说明: @Data 中的 @RequiredArgsConstructor
在我们写controller 或是 Service层的时候，需要注入很多的 mapper接口或者另外的service接口，这时候就会写很多
的@Autowired注解，代码看起来很乱。Lombok 提供了一个注解:
@RequiredArgsConstructor(onConstructor=@_(@AutoWired))
写在类上可以代替@Autowired注解，需要注意的时在注入时，需要用final定义，或者使用 @notnull注解

package com.rainbowsea.springboot.bean;


import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;



@Data// 注解等价使用了，如下注解: @Getter,@Setter,@RequiredArgsConstructor @ToString,@EqualsAndHas
public class Furn {

    private Integer id = 100;

    private String name = "张三";
    private Double price = 999.0;


}

2.4 @AllArgsConstructor

@AllArgsConstructor：在编译时，会生成全参数构造器

package com.rainbowsea.springboot.bean;


import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;



@AllArgsConstructor // 在编译时，会生成全参数构造器
public class Furn {

    private Integer id = 100;

    private String name = "张三";
    private Double price = 999.0;


}

注意：这里：我们会发现一点，就是有全参数构造器，但是，却没有生成一个默认的“无参数构造器”

2.5 @NoArgsConstructor

@NoArgsConstructor： 在编译时，会生成无参构造器（一定会生成），不会受到其它的

package com.rainbowsea.springboot.bean;


import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;


@NoArgsConstructor //在编译时，会生成无参构造器（一定会生成），不会受到其它的
public class Furn {

    private Integer id = 100;

    private String name = "张三";
    private Double price = 999.0;


}

特别说明：

特别说明，虽然上面的@Data,@ToString注解等等，默认情况下都会生成一个无参构造器，但是当你使用了多个注解的时候，可能会覆盖掉无参构造器。 但是当我们有其它多个构造器生成时，你如果你希望仍然有无参构造器就需要使用 @NoArgsConstructor 注解了，因为 @NoArgsConstructor是一定会生成一个无参构造器的（无参构造器很重要，因为框架的使用是涉及到反射机制的，而反射机制，需要一个无参构造器，否则你就无法进行反射获取 bean对象，框架也就无法使用了）。

如下：测试。我们添加上 @Data注解和 @AllArgsConstructor 注解。可以明显的发现，默认的无参数构造器被覆盖掉了

所以我们需要添加上：@NoArgsConstructor注解，因为@NoArgsConstructor注解，在编译时，会生成无参构造器（一定会生成），不会受到其它的影响，被覆盖。如图

3. 在 idea 中 安装 lombok插件

不装插件也可以用基本的注解比如：@Data,@Getter...
但是不能使用其扩展功能，比如日志输出...，所以我们还是安装一下，也比较简单。
直接去插件商城，搜索: Lombok 即可

package com.rainbowsea.springboot.controller;


import com.rainbowsea.springboot.bean.Furn;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;


@Slf4j
@RestController  // @Controller + @ResponseBody
public class HiController {


    @Autowired
    private Furn furn;


    @RequestMapping("/hi") // 设置请求映射路径
    public String hi(){
        log.info("furn-"+furn);

        // 占位符方式输出
        log.info("furn={} myfurn={}",furn,furn);


        return  "hi word";
        // 使用 slf4j日志输出
    }
}

运行测试：

4. 总结：

1. 熟悉常用的 Lombok 注解，提供开发效率。
2. 基本上@注解都会生成一个默认的无参构造器，但是当存在多个注解的时候，这个默认的无参构造器，可能会被覆盖掉，从而导致无法不会被生成。但是，框架的上的使用，基本上都是需要使用上反射 机制的，而反射机制是必须要有一个无参构造器 才可以进行反射，获取到对应的 Bean对象。给框架使用。所以，一般的 bean 对象都会添加上一个@NoArgsConstructor注解该在编译时，会生成无参构造器（一定会生成），不会受到其它的

6. 最后：

“在这个最后的篇章中，我要表达我对每一位读者的感激之情。你们的关注和回复是我创作的动力源泉，我从你们身上吸取了无尽的灵感与勇气。我会将你们的鼓励留在心底，继续在其他的领域奋斗。感谢你们，我们总会在某个时刻再次相遇。”