lombok 基础注解之 @RequiredArgsConstructor

最全的 lombok 注解详情（随着版本不定时更新）

一、注解介绍

作用于类，用于生成包含 final 和 @NonNull 注解的成员变量的构造方法

二、属性介绍

• staticName：使生成的构造方法是私有的
  并且生成一个参数为 final 变量和 @NonNull 注解变量，返回类型为当前对象的静态方法，方法名为 staticName 值
• access：设置构造方法的访问修饰符，如果设置了 staticName，那么将设置静态工厂方法的访问修饰符
  共有 PUBLIC、MODULE、PROTECTED、PACKAGE、PRIVATE、NONE
  MODULE 是 Java 9 的新特性，NONE 表示不生成构造方法也不生成静态方法，即停用注解功能
• onConstructor：列出的所有注解都放在生成的构造方法上
  JDK 7 之前的写法是 onConstructor = @__({@Deprecated})，而 JDK 8 之后的写法是 onConstructor_ = {@Deprecated}

三、实战演练

@RequiredArgsConstructor(staticName = "newInstance", access = AccessLevel.PROTECTED, onConstructor_ = {@Deprecated})
public class ChengXiao {
	private String name;
	
	private final int age;
	
	@NonNull
	private String phone;
}

编译后

public class ChengXiao {
	private String name;
	
	private final int age;
	
  	@NonNull
  	private String phone;
	
  	@Deprecated
  	private ChengXiao(int age, @NonNull String phone) {
    	if (phone == null)
    		throw new NullPointerException("phone is marked non-null but is null");
    	this.age = age;
    	this.phone = phone;
    }
    
  	protected static ChengXiao newInstance(int age, @NonNull String phone) {
  		return new ChengXiao(age, phone);
  	}
}

四、温馨提示

当类中没有 final 和 @NonNull 注解的成员变量时会生成一个无参构造方法（因为没有符合要求的参数），而很多人认为 @Data 会生成无参构造方法就是此导致的