Lombok中@Builder注解的功能及示例简介说明

Builder注解的功能

@Builder注解常用于实体类上
      当在实体类上加入Builder注解上时,
	  则属性赋值则可以使用Builder模式
	  增加赋值set的便利性

Builder注解的使用步骤:
  1.引入相应的jar包
    <dependency>
	<groupId>org.projectlombok</groupId>
	<artifactId>lombok</artifactId>
	<version>1.18.12</version>
 </dependency>
 
 2.实体类上加入Builder注解

@Builder注解示例

//实体类
@Builder
@Getter
@ToString
public class User { 
    private String name;
    private Integer age;
}

public class TestBuilder {
    public static void main(String[] args) {
        
        // 使用Builder注解来创建一个User实例
        User test = User.builder()
                .age(18)
                .name("java265").build();
        System.out.println(test);
        
        /**
         * 修改原对象的属性值
         * 注意: 修改实体, 要在实体的@Builder注解里面设置toBuilder = true
         * toBuilder的默认值是false,这个可以自行去查看@Builder注解类的实现
         * 里面有这样一行代码:
         * boolean toBuilder() default false;
         */
        test = test.toBuilder()
                .age(22).build();
        System.out.println(test);
       
    }
}
 
----运行以上代码,将输出以下信息-----
User(name=java265, age=18)
User(name=java265, age=22)

@Builder注解后的源码

public class User {
    private String name;
    private Integer age;
 
    User(String name, Integer age) {
        this.name = name;
        this.age = age;
    }
 
    public static User.UserBuilder builder() {
        return new User.UserBuilder();
    }
 
    public String getName() {
        return this.name;
    }
 
    public Integer getAge() {
        return this.age;
    }
 
    public String toString() {
        return "User(name=" + this.getName() + ", age=" + this.getAge() + ")";
    }
 
    public static class UserBuilder {
        private String name;
        private Integer age;
 
        UserBuilder() {
        }
 
        public User.UserBuilder name(String name) {
            this.name = name;
            return this;
        }
 
        public User.UserBuilder age(Integer age) {
            this.age = age;
            return this;
        }
 
        public User build() {
            return new User(this.name, this.age);
        }
 
        public String toString() {
            return "User.UserBuilder(name=" + this.name + ", age=" + this.age + ")";
        }
    }
}

Builder实现原理

 1.创建 一个名UserBuilder的静态内部类
    和实体类相同的属性(称为构建器) 

在构建器中：
    对于目标类中的所有的属性,都会在构建器中创建对应的属性

在构建器中:
    创建一个无参的default构造方法

在构建器中:
    对于实体类中的每个参数,
	 都会对应创建类似于setter方法,
	  但是方法名是与该参数名是相同
	   且返回值是构建器本身(便于链式调用)

在构建器中:
    一个build方法
	调用此方法
	就会根据设置的值进行创建对象实例

在构建器中:
    同时也会生成一个toString()方法

在构建器中:
    会创建一个builder()方法
	用于创建构建器