为什么要使用Lombok
在Java开发中,getter、setter、equals、hashCode、toString等方法是非常常见的,但这些方法通常不包含任何业务逻辑,仅仅是数据访问或对象比较的简单实现。而Lombok可以让我们通过注解自动生成这些方法,极大地减少了样板代码的数量,让代码更加简洁。
了解Lombok
Lombok是一个Java工具库,其主要目的是通过提供简单的注解来简化Java代码的编写,从而提高开发效率和代码的可读性、可维护性。
集成Lombok
1.下载Lombok插件
2.添加maven依赖
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.30</version>
<scope>provided</scope>
</dependency>
Lombok常用注解
@Getter/@Setter
自动产生 getter/setter方法
@Getter
@Setter
public class User {
private Integer id;
private String name;
}
效果等同于
public class User {
private Integer id;
private String name;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
@ToString
自动重写 toString () 方法,会印出所有变量
@ToString
public class User {
private Integer id;
private String name;
}
效果等同于
public class User {
private Integer id;
private String name;
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
'}';
}
}
@EqualsAnd HashCode
自动生成 equals(Object other) 和 hashcode() 方法,包括所有非静态变量和非 transient 的变量
@EqualsAndHashCode
public class User {
private Integer id;
private String name;
}
效果等同于
public class User {
private Integer id;
private String name;
@Override
public boolean equals(Object o) {
if (this == o) {
return true;
}
if (!(o instanceof User user)) {
return false;
}
return Objects.equals(id, user.id) && Objects.equals(name, user.name);
}
@Override
public int hashCode() {
return Objects.hash(id, name);
}
}
如果某些变量不想要加进判断 ,可以通过 exclude 排除 ,也可以使用 of 指定某些字段
@EqualsAndHashCode(exclude = "name")
public class User {
private Integer id;
private String name;
}
效果等同于
public class User {
private Integer id;
private String name;
@Override
public boolean equals(Object o) {
if (this == o) {
return true;
}
if (!(o instanceof User user)) {
return false;
}
return Objects.equals(id, user.id);
}
@Override
public int hashCode() {
return Objects.hash(id);
}
}
@NoArgsConstructor, @AllArgsConstructor, @RequiredArgsConstructorz
这三个注解的作用都是在自动生成该类的构造器,差别在于生成的构造器的参数不一样
@NoArgsConstructor
生成一个没有参数的构造器
@NoArgsConstructor
public class User {
private Integer id;
private String name;
}
效果等同于
public class User {
private Integer id;
private String name;
public User() {
}
}
@AllArgsConstructor
生成一个包含所有参数的构造器
@AllArgsConstructor
public class User {
private Integer id;
private String name;
}
效果等同于
public class User {
private Integer id;
private String name;
public User(Integer id, String name) {
this.id = id;
this.name = name;
}
}
注意,很多情况下使用@AllArgsConstructor要配合@NoArgsConstructor,因为当我们写了构造器后Java不会帮我们生成无参构造器,而很多地方,例如Spring Data JPA会需要每个类都一定要有一个无参数的构造器
@RequiredArgsConstructor
生成一个包含final 修饰词的变量的构造器
@RequiredArgsConstructor
public class User {
private final Integer id;
private String name;
}
效果等同于
public class User {
private final Integer id;
private String name;
public User(Integer id) {
this.id = id;
}
}
@Data
相当于一个整合包,只要加了 @Data 这个注解,等于同时加了以下注解
- @Getter/@Setter
- @ToString
- @EqualsAnd HashCode
- @RequiredArgsConstructor
@Data
public class User {
private Integer id;
private String name;
}
效果等同于
public class User {
private Integer id;
private String name;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public User(Integer id, String name) {
this.id = id;
this.name = name;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
'}';
}
@Override
public boolean equals(Object o) {
if (this == o) {
return true;
}
if (!(o instanceof User user)) {
return false;
}
return Objects.equals(getId(), user.getId()) && Objects.equals(getName(), user.getName());
}
}
@Value
也是一个整合包,但是他会把所有的变量都设成 final 的,其他的就跟 @Data 一样 ,等于同时加了以下注解
- @Getter (注意没有setter)
- @ToString
- @EqualsAnd HashCode
- @RequiredArgsConstructor
@Value
public class User {
private Integer id;
private String name;
}
效果等同于
public class User {
private final Integer id;
private final String name;
public Integer getId() {
return id;
}
public String getName() {
return name;
}
public User(final Integer id, final String name) {
this.id = id;
this.name = name;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
'}';
}
@Override
public boolean equals(Object o) {
if (this == o) {
return true;
}
if (!(o instanceof User user)) {
return false;
}
return Objects.equals(getId(), user.getId()) && Objects.equals(getName(), user.getName());
}
@Override
public int hashCode() {
return Objects.hash(getId(), getName());
}
}
相较于之下,@Data 适合用在 POJO 或 DTO 上 ,@Value 适合加在只读的类上
值得注意的是 ,Lombok 的注解 @Value 和另一个 Spring 的注解 @Value 撞名,在 导入时不要导入错了
@Builder
自动生成流式set值写法,不用写一堆setter
@Builder
public class User {
private Integer id;
private String name;
public static void main(String[] args) {
User user = User.builder().id(1).name("John").build();
}
}
效果等同于
public class User {
private Integer id;
private String name;
public void setId(Integer id) {
this.id = id;
}
public void setName(String name) {
this.name = name;
}
public static void main(String[] args) {
User user = new User();
user.setId(1);
user.setName("John");
}
}
虽然只要加上 @Builder 注解,我们就能够用流式写法快速设定对象的值 ,但是 setter 还是必须要写不能省略的 ,因为 Spring 或是其他框架有很多地方都会用到对象的 getter/setter 对他们取值/赋值
所以通常是 @Data 和 @Builder 会一起用在同个类上 ,既方便我们流式写代码 ,也方便框架做事
此外,关于@Builder注解还有一个坑,感兴趣的可以了解一下
@Slf4j
自动生成该类的log静态常量
注意,在使用@Slf4j时需先加上maven依赖
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>2.0.12</version>
</dependency>
@Slf4j
public class User {
public static void main(String[] args) {
log.info("running...");
}
}
效果等同于
public class User {
private static final Logger log = LoggerFactory.getLogger(User.class);
public static void main(String[] args) {
log.info("running...");
}
}
SpringBoot默认支持的就是 slf4j + logback 的日志框架,因此Lombok中log系列注解最常用的就是@Slf4j
简单JavaBean的构建
我们可以通过以下代码简单构造一个JavaBean
@Data
@Slf4j
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class User {
public Integer id;
public String name;
}
Lombok的优点与缺点
优点
1.减少样板代码:Lombok通过注解自动生成这些方法,极大地减少了样板代码的数量,让代码更加简洁。
2.提高开发效率:由于Lombok能够自动生成这些方法,开发者不再需要手动编写它们,从而可以专注于实现业务逻辑。这不仅可以加快开发速度,还可以减少出错的可能性,因为Lombok生成的代码通常比手动编写的代码更加准确和可靠。
3.保持代码一致性:Lombok生成的代码风格是统一的,这有助于保持代码的一致性,提高代码的可维护性。
4.易于集成和使用:Lombok的集成非常简单,只需要将其添加到项目的依赖中,并在IDE中安装相应的插件即可。使用Lombok也非常方便,只需要在类上添加相应的注解,Lombok就会在编译时自动生成对应的代码。
缺点
1.侵入性太强:强制让同事在IDE中安装对应插件,更重要的是,如果我们定义的一个jar包中使用了Lombok,那么要求所有依赖这个jar包的应用都必须安装插件;
2.代码可读性、调试性低:因为Lombok会自动生成很多代码,但这些代码是要在编译阶段才会生成,所以开发过程中,很多代码是缺失的;还有使用了lombok,想要看某个属性的set/get方法被哪些类调用,会很不方便;
3.坑,盲目使用对自动生成的代码不够了解,会容易产生意想不到的结果
4.影响jdk升级:如果项目中使用了lombok,会导致如果lombok官方没有及时升级版本到对应的jdk,使用lombok的代码也无法升级到新的jdk版本;