Lombok 使用详解

目录

Lombok

Bean 的对比

Lombok的安装与依赖导入

Lombok注解详解

@Getter和@Setter

@ToString

@EqualsAndHashCode

@NonNull

@NoArgsConstructor, @RequiredArgsConstructor, @AllArgsConstructor

@Data

@Builder

@Log

val

@Cleanup

Lombok有什么坏处?

侵入性高

代码可读性,可调试性低

有BUG

影响升级

破坏封装性

总结


在 Java 应用程序中存在许多重复相似的、生成之后几乎不对其做更改的代码,但是我们还不得不花费很多精力编写它们来满足 Java 的编译需求

比如,在 Java 应用程序开发中,我们几乎要为所有 Bean 的成员变量添加 get() ,set() 等方法,这些相对固定但又不得不编写的代码浪费程序员很多精力,同时让类内容看着更杂乱,我们希望将有限的精力关注在更重要的地方。

Lombok 已经诞生很久了,甚至在 Spring Boot Initalizr 中都已加入了 Lombok 选项,

这里我们将 Lombok 做一下详细说明:

Lombok

官网的介绍:Project Lombok is a java library that automatically plugs into your editor and build tools, spicing up your java. Never write another getter or equals method again. Early access to future java features such as val, and much more.

直白的说: Lombok 是一种 Java™ 实用工具,可用来帮助开发人员消除 Java 的冗长,尤其是对于简单的 Java 对象(POJO)。它通过注解实现这一目的,且看:

Bean 的对比

传统的 POJO 类是这样的

通过Lombok改造后的 POJO 类是这样的

一眼可以观察出来我们在编写 Employee 这个类的时候通过 @Data 注解就已经实现了所有成员变量的 get() 与 set() 方法等,同时 Employee 类看起来更加清晰简洁。Lombok 的神奇之处不止这些,丰富的注解满足了我们开发的多数需求。

Lombok的安装与依赖导入

查看下图,@Data的实现,我们发现这个注解是应用在编译阶段的

这和我们大多数使用的注解,如 Spring 的注解(在运行时,通过反射来实现业务逻辑)是有很大差别的,如Spring 的@RestController 注解

一个更直接的体现就是,普通的包在引用之后一般的 IDE 都能够自动识别语法,但是 Lombok 的这些注解,一般的 IDE 都无法自动识别,因此如果要使用 Lombok 的话还需要配合安装相应的插件来支持 IDE 的编译,防止IDE 的自动检查报错,下面以 IntelliJ IDEA 举例安装插件。

在Repositories中搜索Lombok,安装后重启IDE即可

在Maven或Gradle工程中添加依赖

至此我们就可以应用 Lombok 提供的注解干些事情了。

Lombok注解详解

Lombok官网提供了许多注解,但是 “劲酒虽好,可不要贪杯哦”,接下来逐一讲解官网推荐使用的注解(有些注解和原有Java编写方式没太大差别的也没有在此处列举,如@ Synchronized等)

@Getter和@Setter

该注解可应用在类或成员变量之上,和我们预想的一样,@Getter 和 @Setter 就是为成员变量自动生成 get 和 set 方法,默认生成访问权限为 public 方法,当然我们也可以指定访问权限 protected 等,如下图:

成员变量name指定生成set方法,并且访问权限为protected;boolean类型的成员变量 female 只生成get方法,并修改方法名称为 isFemale()。当把该注解应用在类上,默认为所有非静态成员变量生成 get 和 set 方法,也可以通过 AccessLevel.NONE 手动禁止生成get或set方法,如下图:

@ToString

该注解需应用在类上,为我们生成 Object 的 toString 方法,而该注解里面的几个属性能更加丰富我们想要的内容, exclude 属性禁止在 toString 方法中使用某字段,而of属性可以指定需要使用的字段,如下图:

查看编译后的Employee.class得到我们预期的结果,如下图

@EqualsAndHashCode

该注解需应用在类上,使用该注解,lombok会为我们生成 equals(Object other) 和 hashcode() 方法,包括所有非静态属性和非transient的属性,同样该注解也可以通过 exclude 属性排除某些字段,of 属性指定某些字段,也可以通过 callSuper 属性在重写的方法中使用父类的字段,这样我们可以更灵活的定义bean的比对,如下图:

查看编译后的Employee.class文件,如下图:

@NonNull

该注解需应用在方法或构造器的参数上或属性上,用来判断参数的合法性,默认抛出 NullPointerException 异常

查看NonNullExample.class文件,会为我们抛出空指针异常,如下图:

当然我们可以通过指定异常类型抛出其他异常,lombok.nonNull.exceptionType = [NullPointerException | IllegalArgumentException] , 为实现此功能我们需要在项目的根目录新建lombok.config文件:

重新编译NonNullExample类,已经为我们抛出非法参数异常:

@NoArgsConstructor, @RequiredArgsConstructor, @AllArgsConstructor

以上三个注解分别为我们生成无参构造器,指定参数构造器和包含所有参数的构造器,默认情况下,@RequiredArgsConstructor@AllArgsConstructor 生成的构造器会对所有标记 @NonNull的属性做非空校验。

无参构造器很好理解,我们主要看看后两种,先看 @RequiredArgsConstructor

从上图中我们可以看出, @RequiredArgsConstructor 注解生成有参数构造器时只会包含有 final 和 @NonNull 标识的 field,同时我们可以指定 staticName 通过生成静态方法来构造对象

查看Employee.class文件

当我们把 staticName 属性去掉我们来看遍以后的文件:

相信你已经注意到细节

@AllArgsConstructor 就更简单了,请大家自行查看吧

@Data

介绍了以上的注解,再来介绍 @Data 就非常容易懂了,@Data 注解应用在类上,是@ToString,@EqualsAndHashCode@Getter / @Setter 和 @RequiredArgsConstructor合力的体现,如下图:

@Builder

函数式编程或者说流式的操作越来越流行,应用在大多数语言中,让程序更具更简介,可读性更高,编写更连贯,@Builder就带来了这个功能,生成一系列的builder API,该注解也需要应用在类上,看下面的例子就会更加清晰明了。

编译后的Employee.class文件如下:

妈妈再也不用担心我 set 值那么麻烦了,流式操作搞定:

@Log

该注解需要应用到类上,在编写服务层,需要添加一些日志,以便定位问题,我们通常会定义一个静态常量Logger,然后应用到我们想日志的地方,现在一个注解就可以实现:

查看class文件,和我们预想的一样:

Log有很多变种,CommonLog,Log4j,Log4j2,Slf4j等,lombok依旧良好的通过变种注解做良好的支持:

我实际使用的是 @Slf4j 注解

val

熟悉 Javascript 的同学都知道,var 可以定义任何类型的变量,而在 java 的实现中我们需要指定具体变量的类型,而 val 让我们摆脱指定,编译之后就精准匹配上类型,默认是 final 类型,就像 java8 的函数式表达式,()->System.out.println(“hello lombok”); 就可以解析到Runnable函数式接口。

查看解析后的class文件:

@Cleanup

当我们对流进行操作,我们通常需要调用 close 方法来关闭或结束某资源,而 @Cleanup 注解可以帮助我们调用 close 方法,并且放到 try/finally 处理块中,如下图:

编译后的class文件如下,我们发现被try/finally包围处理,并调用了流的close方法

其实在 JDK1.7 之后就有了 try-with-resource,不用我们显式的关闭流,这个请大家自行看吧

Lombok有什么坏处?

侵入性高

  • 因为Lombok的使用要求开发者一定要在IDE中安装对应的插件。
  • 如果未安装插件的话,使用IDE打开一个基于Lombok的项目的话会提示找不到方法等错误。导致项目编译失败。
  • 也就是说,如果项目组中有一个人使用了Lombok,那么其他人就必须也要安装IDE插件。否则就没办法协同开发
  • 更重要的是,如果我们定义的一个jar包中使用了Lombok,那么就要求所有依赖这个jar包的所有应用都必须安装插件,这种侵入性是很高的

代码可读性,可调试性低

在代码中使用了Lombok,确实可以帮忙减少很多代码,因为Lombok会帮忙自动生成很多代码。

但是这些代码是要在编译阶段才会生成的,所以在开发的过程中,其实很多代码其实是缺失的。

在代码中大量使用Lombok,就导致代码的可读性会低很多,而且也会给代码调试带来一定的问题。

比如,我们想要知道某个类中的某个属性的getter方法都被哪些类引用的话,就没那么简单了。

有BUG

因为Lombok使代码开发非常简便,这就使得部分开发者对其产生过度依赖。

在使用Lombok过程中,如果对于各种注解的底层原理不理解的话,很容易产生意想不到的结果。

举一个简单的例子,我们知道,当我们使用@Data定义一个类的时候,会自动帮我们生成equals()方法 。

但是如果只使用了@Data,而不使用@EqualsAndHashCode(callSuper=true)的话,会默认是@EqualsAndHashCode(callSuper=false),这时候生成的equals()方法只会比较子类的属性,不会考虑从父类继承的属性,无论父类属性访问权限是否开放

这就可能得到意想不到的结果。

影响升级

因为Lombok对于代码有很强的侵入性,就可能带来一个比较大的问题,那就是会影响我们对JDK的升级。

按照如今JDK的升级频率,每半年都会推出一个新的版本,但是Lombok作为一个第三方工具,并且是由开源团队维护的,那么他的迭代速度是无法保证的。

所以,如果我们需要升级到某个新版本的JDK的时候,若其中的特性在Lombok中不支持的话就会受到影响。

还有一个可能带来的问题,就是Lombok自身的升级也会受到限制。

因为一个应用可能依赖了多个jar包,而每个jar包可能又要依赖不同版本的Lombok,这就导致在应用中需要做版本仲裁,而我们知道,jar包版本仲裁是没那么容易的,而且发生问题的概率也很高。

破坏封装性

以上几个问题,我认为都是有办法可以避免的。但是有些人排斥使用Lombok还有一个重要的原因,那就是他会破坏封装性。

众所周知,Java的三大特性包括封装性、继承性和多态性。

如果我们在代码中直接使用Lombok,那么他会自动帮我们生成getter、setter 等方法,这就意味着,一个类中的所有参数都自动提供了设置和读取方法。

举个简单的例子,我们定义一个购物车类:

@Data

public class ShoppingCart { 

    //商品数目
    private int itemsCount; 

    //总价格
    private double totalPrice; 

    //商品明细
    private List items = new ArrayList<>();

}

我们知道,购物车中商品数目、商品明细以及总价格三者之前其实是有关联关系的,如果需要修改的话是要一起修改的。

但是,我们使用了Lombok的@Data注解,对于itemsCount 和 totalPrice这两个属性。虽然我们将它们定义成 private 类型,但是提供了 public 的 getter、setter 方法。

外部可以通过 setter 方法随意地修改这两个属性的值。我们可以随意调用 setter 方法,来重新设置 itemsCount、totalPrice 属性的值,这也会导致其跟 items 属性的值不一致。

面向对象封装的定义是:通过访问权限控制,隐藏内部数据,外部仅能通过类提供的有限的接口访问、修改内部数据。所以,暴露不应该暴露的 setter 方法,明显违反了面向对象的封装特性。

好的做法应该是不提供getter/setter,而是只提供一个public的addItem方法,同时去修改itemsCount、totalPrice以及items三个属性。

总结

Lombok的基本操作流程是这样的:

1. 定义编译期的注解

2. 利用JSR269 api(Pluggable Annotation Processing API )创建编译期的注解处理器

3. 利用tools.jar的javac api处理AST(抽象语法树)

4. 将功能注册进jar包

Lombok 当然还有很多注解,我推荐使用以上就足够了,这个工具是带来便利的,而不能被其捆绑,“弱水三千只取一瓢饮,代码千万需抓重点看”,Lombok 能让我更加专注有效代码排除意义微小的障眼代码(get,set等),另外Lombok生成的代码还能像使用工具类一样方便(@Builder)。

到底建不建议在日常开发中使用,我其实保持一个中立的态度,不建议大家过度依赖,也不要求大家一定要彻底不用。

只要大家在使用的过程中,或者评估要不要在代码中引入Lombok之前,在想到他的优点的同时,能够考虑到他给代码带来的问题的,那么本文的目的也就达到了!

更多内容请查看官网:

https://www.projectlombok.org/

发布了81 篇原创文章 · 获赞 93 · 访问量 15万+

猜你喜欢

转载自blog.csdn.net/minkeyto/article/details/104541277