在我的博客阅读本文

1. 前言

今早进公司打开idea，弹出更新提示，简单看了下，原来是idea的lombok插件更新了，惊喜的发现update log上写着Add support for @SuperBuilder。

为什么说是惊喜呢？因为之前也有用到这个的场景，去官网认认真真看完了@SuperBuilder的用法以及描述，刚准备大展拳脚，结果发现idea上怎么写都识别不出来，后来去插件的github上看了一下，在issue中发现很多请求插件更新支持@SuperBuilder注解，而插件作者大概的回复就是已经在开发计划中了，不要催，催也不能提高进度。不得已，在自己的项目中只能冗余一些代码，而不能基于lombok更加优雅简洁的去写。

虽然插件已经更新支持，但是一直没有实际使用导致我都忘了很多用法了，这篇文章基于官网文档，用来记录与复习相关用法。

2. 关于@SuperBuilder

2.1. 首先了解@Builder

看到这篇文章的你肯定已经用过这个注解，这里简单陈述一下基本用法，如果你已经了解，可以略过此部分。

2.1.1. 引入依赖(Maven结构)

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.8</version>
    <scope>provided</scope>
</dependency>
123456

2.1.2. 创建一个类

/**
 * Ming
 *
 * @author sq.ma
 * @date 2019/10/9 上午9:37
 */
@Builder
public class Ming {
    private Integer age;
    private String name;
}
1234567891011

这里使用@Builder注解，就可以在创建新实例的时候这样写：

Ming mingA = Ming.builder().build();
Ming mingB = Ming.builder()
  	.age(11)
  	.build();
Ming mingD = Ming.builder()
  	.age(11)
  	.name("小明")
  	.build();
12345678

可以看到，我们只要写一个@Builder注解，有如下好处：

• 一个注解代替若干参数情况下的构造函数，缩减了构造类的代码量
• 通过Builder构造的方式，即.属性名(值)这样的方式，比直接使用构造函数的方式更加具备可读性，比频繁使用set方法的方式更加简洁。

2.2. 了解@SuperBuilder

2.2.1. @SuperBuilder解决了什么样的问题

在上文(2.1)中，我们了解了@Builder的使用，那么我们将例子中的Ming这个类的成员属性放到父类当中：

/**
 * @author sq.ma
 * @date 2019/10/9 上午10:01
 */
public class Person {
    private Integer age;
    private String name;
}

@Builder
public class Ming extends Person{
}
123456789101112

这个时候，我们之前的调用的.builder都会报错，这是因为@Builder并不支持父类成员属性的构造，@SuperBuilder注解的出现，就是用来解决这个问题。

/**
 * @author sq.ma
 * @date 2019/10/9 上午10:01
 */
@SuperBuilder
public class Person {
    private Integer age;
    private String name;
}

@SuperBuilder
public class Ming extends Person{
}
12345678910111213

这样子类就可以正常获取到父类的成员属性进行builder构造了。

2.2.2. @SuperBuilder(toBuilder = true)用法

toBuilder属性默认关闭，如果开启，则所有的父类应该也要开启，效果如下：

Ming mingD = Ming.builder()
      .age(11)
      .name("小明")
      .build();
Ming mingF = mingD.toBuilder().name("猪").build();
System.err.println(mingD.toString());
System.err.println(mingF.toString());
1234567

通过设置true，所有的类实例会拥有toBuilder方法，这是一个类似深拷贝的一个方法，不会改变原有实例的属性，生成一个新的实例。在toBuilder中有赋值的属性则会改变为赋值属性，没有赋值的以调用的实例中的值为准。

2.2.3. @SuperBuilder(buildMethodName = "execute", builderMethodName = "helloWorld", toBuilder = true) 用法

这个用法其实没什么意思，就是自定义方法名，不展开赘述。

2.2.4. @Builder.ObtainVia(XXX) 用法

这个是Filed或parameter的注解，我们看下源码

@Target({FIELD, PARAMETER})
@Retention(SOURCE)
public @interface ObtainVia {
		/**
		 * @return Tells lombok to obtain a value with the expression {@code this.value}.
		 */
		String field() default "";
		
		/**
		 * @return Tells lombok to obtain a value with the expression {@code this.method()}.
		 */
		String method() default "";
		
		/**
		 * @return Tells lombok to obtain a value with the expression {@code 			   SelfType.method(this)}; requires {@code method} to be set.
		 */
		boolean isStatic() default false;
}
123456789101112131415161718

其中，

• field是告诉lombok赋值时从哪个属性取值
• method是告诉lombok赋值时调用什么方法
• isStatic是跟在method后的，默认为false，代表相应的method是否是静态

需要注意的是这几个方法只有在ToBuilder = true的时候有效，最好不要混合使用(有先后顺序问题)

2.2.5. 注意补充构造方法

2019-10-10 更新

使用@Builder或@SuperBuilder注解时，不会默认创建空参构造函数，如果你有额外使用空参构造函数或全参构造函数的需求，需要在子类和父类都加上以下注解：

@AllArgsConstructor //全参构造函数
@NoArgsConstructor //空参构造函数
12

3. 参考文献

@SuperBuilder - lombok官网