1.使用范围
- 类:只能加在类上
2.介绍
此注解包含以下注解:@ToString、@EqualsAndHashCode、@Getter、@Setter、@RequiredArgsConstructor
3.属性
- staticConstructor:使生成的构造方法是私有的,默认值 “”
并且生成一个返回类型为当前对象的静态方法,方法名为 staticConstructor 值
这个静态方法参数会包含该类中含 @NonNull 注解的变量以及是 final 且不是 static 的变量
4.实例
@Data(staticConstructor = "newInstance")
public class 林允儿 {
private String nname;
public final static int age = 18;
@NonNull private String address;
}
编译后:
public class 林允儿 {
private String nname;
public static final int age = 18;
@NonNull
private String address;
private 林允儿(@NonNull String address) {
if (address == null)
throw new NullPointerException("address is marked non-null but is null");
this.address = address;
}
public static 林允儿 newInstance(@NonNull String address) {
return new 林允儿(address);
}
/** ---------- setter、getter 等方法省略 ---------- **/
5.注意事项
使用该注解可以不对 final 变量进行初始化,但是(有且强烈不建议在使用该注解的情况下显现的使用构造函数)
如果指定了 staticConstructor 值且不为默认值,那么手写的构造函数就有着严格的要求,否则编译不通过
1、有且只能创建参数个数必须是所有 final 变量 + 包含 @NonNull 注解的变量的个数,即覆盖由 @RequiredArgsConstructor 注解产生的构造函数
2、参数类型的顺序必须和 final 变量以及 @NonNull 注解的变量类型顺序一致
3、有且必须在构造函数中对 final 字段进行赋值
如果没有指定 staticConstructor 值,那么手写构造函数
1、可以创建参数个数随意的构造函数
2、final 参数必须初始化或者在构造函数中赋值
2、此注解并不会生成无参构造函数
而很多人认为会生成无参构造函数的是因为 @RequiredArgsConstructor 注解导致的