lombok相关

8.7.30
@Builder无法设置父类属性，解决方法：
@Builder放在子类的全参构造方法上。里面给super穿全参。
例子如下
@Builder
public OfferVO(String projectId, String sn,
String title, String demander,
String demanderName, String demanderDepartment,
String buyer, String buyerName,
BigDecimal budgetAmount,
String budgetCurrency, String projectStatus,
String projectStatusLabel, String auditStatus,
String auditStatusLabel, String currentHandler,
Date startTime, Date endTime) {
super(projectId, sn, title, demander, demanderName, demanderDepartment, buyer, buyerName, budgetAmount, budgetCurrency, projectStatus, projectStatusLabel, auditStatus, auditStatusLabel, currentHandler);
this.startTime = startTime;
this.endTime = endTime;
}
————————————
18.7.22
@Builder存在的问题
只能创建本类的实例，无法链式的给父类的属性赋值。
使用时只能先构建本类实例，再通过set方法给父类的属性赋值。
这个貌似是设计师难以解决的问题，因为在编译阶段想要获取父类的属性还需要解析父类文件，解析过程以及递归寻找父类过程非常消耗时间，应该是超过了容忍的时间。因此没有做将父类属性链式赋值的功能。
参考：https://groups.google.com/forum/#!msg/project-lombok/-6b9dPH8qAw/0rzZW6ZAgJIJ

————————————
18.6.12
一、Lombok原理
lombok通过简单的注解标志就能够实现复杂的代码生成，他是怎么做到的？
lombok注解不是我们常见的runtime注解，而是source注解或者class注解，
在没有jsr之前我们可以通过反射在运行是获取注解值，但是这样效率很低，而且没办法做到编译检查，对开发人员一些不合的编码错误给出警告，
lombok本质上就是这样的一个实现了"JSR 269 API"的程序。在使用javac的过程中，它产生作用的具体流程如下：
1)javac对源代码进行分析，生成一棵抽象语法树(AST)
2)运行过程中调用实现了"JSR 269 API"的lombok程序
3)此时lombok就对第一步骤得到的AST进行处理，找到@Data注解所在类对应的语法树(AST)，然后修改该语法树(AST)，增加getter和setter方法定义的相应树节点
4)javac使用修改后的抽象语法树(AST)生成字节码文件，即给class增加新的节点（代码块）
参考：https://blog.csdn.net/v2sking/article/details/73431364

二、注解
Lombok提供注解方式来提高代码的简洁性,常用注解有:
@Data
@Setter @Getter
@NonNull
@Synchronized
@ToString
@EqualsAndHashCode
@Cleanup
@SneakyThrows
1、@Data
该注解相当于同时加上以下注解@Setter @Getter,@ToString,@EqualsAndHashCode，作用于类中 使用:
@Data
public class Person {
private String name;
private String address;
private String city;
private String state;
private String zip;
private Date brithday;
}
2、@NonNull
该注解快速判断属性是否为空,如果为空,则抛出java.lang.NullPointerException
3、@Synchronized
该注解自动添加到同步机制,有趣的是,生成的代码并不是直接锁方法,而是锁代码块， 作用范围是方法上
private DateFormat format = new SimpleDateFormat("MM-dd-YYYY");
@Synchronized
public String synchronizedFormat(Date date) {
return format.format(date);
}
4、 @ToString
该方法大家应该非常熟悉，但需要注意的是:@ToString有多个属性可以进一步设置:
callSuper 是否输出父类的toString方法,默认为false
includeFieldNames 是否包含字段名称,默认为true
exclude 排除生成tostring的字段
@Cleanup
注释可用于确保已分配的资源被释放,如IO的连接关闭。
public void testCleanUp() {
try {
@Cleanup ByteArrayOutputStream baos = new ByteArrayOutputStream();
baos.write(new byte[] {'Y','e','s'});
System.out.println(baos.toString());
} catch (IOException e) {
e.printStackTrace();
}
}
等价源码:
public void testCleanUp() {
try {
ByteArrayOutputStream baos = new ByteArrayOutputStream();
try {
baos.write(new byte[]{'Y', 'e', 's'});
System.out.println(baos.toString());
} finally {
baos.close();
}
} catch (IOException e) {
e.printStackTrace();
}
}
参考：https://blog.csdn.net/u010695794/article/details/70441432
5、@EqualsAndHashCode
生成hashCode()和equals()方法，默认情况下，它将使用所有非静态，非transient字段。但可以通过在可选的exclude参数中来排除更多字段。或者，通过在parameter参数中命名它们来准确指定希望使用哪些字段。
6、@NoArgsConstructor, @RequiredArgsConstructor, @AllArgsConstructor
@NoArgsConstructor生成一个无参构造方法。当类中有final字段没有被初始化时，编译器会报错，此时可用@NoArgsConstructor(force = true)，然后就会为没有初始化的final字段设置默认值 0 / false / null。对于具有约束的字段（例如@NonNull字段），不会生成检查或分配，因此请注意，正确初始化这些字段之前，这些约束无效。
@RequiredArgsConstructor会生成构造方法（可能带参数也可能不带参数），如果带参数，这参数只能是以final修饰的未经初始化的字段，或者是以@NonNull注解的未经初始化的字段
@RequiredArgsConstructor(staticName = "of")会生成一个of()的静态方法，并把构造方法设置为私有的
@AllArgsConstructor 生成一个全参数的构造方法
7、@Accessors
@Accessors 主要用于控制生成的getter和setter
主要参数介绍
fluent boolean值，默认为false。此字段主要为控制生成的getter和setter方法前面是否带get/set
chain boolean值，默认false。如果设置为true，setter返回的是此对象，方便链式调用方法
prefix 设置前缀 例如：@Accessors(prefix = "abc") private String abcAge 当生成get/set方法时，会把此前缀去掉
8、@Wither
提供了给final字段赋值的一种方法
//使用lombok注解的
import lombok.AccessLevel;
import lombok.NonNull;
import lombok.experimental.Wither;
public class WitherExample {
@Wither private final int age;
@Wither(AccessLevel.PROTECTED) @NonNull private final String name;
public WitherExample(String name, int age) {
if (name == null) throw new NullPointerException();
this.name = name;
this.age = age;
}
}
//等效代码
import lombok.NonNull;
public class WitherExample {
private final int age;
private @NonNull final String name;
public WitherExample(String name, int age) {
if (name == null) throw new NullPointerException();
this.name = name;
this.age = age;
}
public WitherExample withAge(int age) {
return this.age == age ? this : new WitherExample(age, name);
}
protected WitherExample withName(@NonNull String name) {
if (name == null) throw new java.lang.NullPointerException("name");
return this.name == name ? this : new WitherExample(age, name);
}
}
9、@Delegate
这个注解也是相当的牛逼，看下面的截图，它会该类生成一些列的方法，这些方法都来自与List接口
参考：https://www.jianshu.com/p/365ea41b3573
官网：https://projectlombok.org/features/experimental/all 这里是扩展的注解
10、1.@val @var
使用Lombok ，java也能够像javascript一样使用弱类型定义变量了
val注解变量申明是final类型 var注解变量是非final类型
11、@Value
@value是@data的不可变对象 （不可变对象的用处和创建：https://my.oschina.net/jasonultimate/blog/166810）
所有字段都是私有的，默认情况下是final的，并且不会生成setter。默认情况下，类本身也是final的，因为不可变性不能强制转化为子类。与@data一样，有用toString()、equals()和hashCode()方法也是生成的，每个字段都有一个getter方法，并且一个覆盖每个参数的构造器也会生成。
12、11.@SneakyThrows
把checked异常转化为unchecked异常，好处是不用再往上层方法抛出了，美其名曰暗埋异常
13、 14.@Log
可以生成各种log对象，方便多了

——
这里例子比较多：
参考：https://www.cnblogs.com/woshimrf/p/lombok-usage.html

————————————
18.6.27
@Builder 为类增加新增对象的方法
相当于不加@Builder的
public class Example<T> {
private T foo;
private final String bar;
private Example(T foo, String bar) {
this.foo = foo;
this.bar = bar;
}
public static <T> ExampleBuilder<T> builder() {
return new ExampleBuilder<T>();
}
public static class ExampleBuilder<T> {
private T foo;
private String bar;
private ExampleBuilder() {}
public ExampleBuilder foo(T foo) {
this.foo = foo;
return this;
}
public ExampleBuilder bar(String bar) {
this.bar = bar;
return this;
}
@java.lang.Override
public String toString() {
return "ExampleBuilder(foo = " + foo + ", bar = " + bar + ")";
}
public Example build() {
return new Example(foo, bar);
}
}
}
相当于
@Builder
public class Example {
private int foo;
private final String bar;
}
使用：
构造一个实例,属性不需要单独set
Example.builder().foo(1).bar(“test”).build()