Java开发之Lombok指南

1. 前言

在目前众多编程语言中，java 语言的表现还是抢眼，不论是企业级服务端开发，还是 andorid 客户端开发，都是作为开发语言的首选，甚至在大数据开发领域，java 语言也能占有一席之地，如 hadoop，spark，flink 大数据等。而作为已经诞生 24 年的 java 相比其他语言来说，编写起来略显得冗长和复杂，而为了能极大提升 java 开发的效率和代码简洁性，一个 java 库 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, with one annotation your class has a fully featured builder, automate your logging variables, and much more.

从上面的说明里我们可以初步认识一下 lombok，一个作用于编辑器和构建工具的 java 库，可以对编写的 java 代码进行增强，比如说不用再写实体类的 getter 方法，equals 方法而是自动生成，自动生成日志输出变量等等，减少重复模板的代码。

大概知道了 lombok 框架提供的功能后，接下来我们就真正使用一下 lombok 提供的注解，看它是如何帮助我们提高书写 java 代码的简洁性和效率的。

本文主要内容涉及如下：

• lombok 插件安装
• lombok 常用注解使用

示例项目：

• lombok-actions：

环境支持：

• jdk 8
• springboot 2.1.4
• maven 3.6.0

2. 正文

2.1 安装 lombok

使用 lombok 之前我们先要在所使用的 ide 中进行集成安装，这里以 idea 为例，安装步骤十分简单：

前往 file -> settings -> plugin -> marketplace ，搜索 lombok

选择搜索结果 lombok ，点击 install 安装。

安装完成后重启即可。

基于 eclipse 的 lombok 插件安装方法这里就不详细描述了，官方也给了对应的文档说明：

在 ide 安装了 lombok 插件后，我们就可以在 pom.xml 文件中添加 lombok 的依赖进行使用了。

<dependency>
<groupid>org.projectlombok</groupid>
<artifactid>lombok</artifactid>
<version>1.18.8</version>
<scope>provided</scope>
</dependency>

注意：pom 依赖设置 scope 为 provided，是为了让 lombok 库不被打包进程序。

2.2 @getter/@setter

通常我们编写实体类无论多少个字段，都要为其提供 getter 和 setter 方法，如下面的示例类 user.java

我们常会遇到这种情况：某个实体类新增和修改某个字段，我们都需要单独处理调整，十分麻烦并且重复。

这时候如果我们使用 lombok 提供 @getter/@setter 注解就能帮我们省去 getter 和 setter 方法的维护，由 lombok 对 user 类自动生成 getter 和 setter 方法,两者最终的字节码时一样的，而我们现在在 user.java 上编写的代码仅仅 7 行即可：

@getter
@setter
public class user {
private integer id;
private string username;
private string password;
}

然后用测试类 usertests.java 测试结果如下：

public class usertests {
@test
public void test() {
user user = new user();
user.setusername("one");
user.setpassword("zxc123");
assert.assertequals(user.getusername(), "one");
assert.assertequals(user.getpassword(), "zxc123");
}
}

@getter/@setter 注解不仅可以使用在类上，还可以使用在字段上，这样就是表示针对该字段自动生成 getter /setter 方法。

@getter
@setter
private string password;

这里该注解使用在类上，还是在字段上的区别就是，如果注解使用在类上，只针对这个类的非静态字段有效。

需要注意的一点是：如果 @getter 注解修饰了 boolean 类型的变量，其生成的 getter 方法签名是 isxxx 形式，而不是 getxxx形式。

除此之外，@getter/@setter 还提供访问权限控制的属性 lombok.accesslevel value(), 默认为 public，而其他选值都是枚举类型：module, protected, package, private

2.3 @nonnull

顾名思义，@nonnull 用于标记类中不能允许为 null 的字段或者参数上，任何使用该字段的地方都生成空指针判断代码，若@nonnull 标记的变量为 null，抛出 nullpointexception （npe） 异常。比如下面示例代码：

public class user {
private integer id;
private string username;
private string password;
public user(integer id, @nonnull string username, @nonnull string password) {
this.id = id;
this.username = username;
this.password = password;
}
}

使用了 @nonnull 注解之后我们可以获取到反编译之后的字节码信息如下，这就是 lombok 给我们生成的最终的代码：

public class user {
private integer id;
private string username;
private string password;
public user(integer id, @nonnull string username, @nonnull string password) {
if (username == null) {
throw new nullpointerexception("username is marked non-null but is null");
} else if (password == null) {
throw new nullpointerexception("password is marked non-null but is null");
} else {
this.id = id;
this.username = username;
this.password = password;
}
}
}

2.4 构造器注解

再来看下平时经常会遇见的场景，为实体类编写构造器方法，lombok 提供了三个不同构造器注解 @noargsconstructor / @allargsconstructor / @requiredargsconstructor 分别对用不同构造器方法处理方式，接下来就一一描述。

• @noargsconstructor 为实体类生成无参的构造器方法
• @allargsconstructor 为实体类生成除了static修饰的字段之外带有各参数的构造器方法。
• @requiredargsconstructor 为实体类生成指定字段的构造器方法，而这些字段需要被 final，或者 @nonnull 修饰。

```java
@requiredargsconstructor
public class user3 {
private integer id;
private final string username;
@nonnull
private string password;
}
```

编译成功后使用构造器方法时就是这样的效果：user3 user3 = new user3("user3", "zxc123");

2.5 @tostring

@tostring 会给类自动生成易阅读的 tostring 方法，带上有所非静态字段的属性名称和值，这样就十分便于我们日常开发时进行的打印操作。

@getter
@setter
@allargsconstructor
@tostring
public class user2 {
private integer id;
private string username;
private string password;
}

最终编译成字节码，反编译结果如下：

public class user2 {
private integer id;
private string username;
private string password;
// 省去 setter/getter
public string tostring() {
return "user2(id=" + this.getid() + ", username=" + this.getusername() + ", password=" + this.getpassword() + ")";
}
}

另外，注解 @tostring 还支持设置指定哪些字段的日志化输出，哪些不需要出现在 tostring 方法中。使用属性 @tostring.exclude排除不需要在 tostring 中出现的字段，使用 @tostring.include标记需要出现在 tostring 中的字段，具体用法可参见示例：

@getter
@setter
@allargsconstructor
@tostring
public class user2 {
@tostring.exclude
private integer id;
@tostring.include
private string username;
@tostring.include
private string password;
}

打印 user2 对象的日志效果就是：user2(username=user2, password=zcx123)。

2.6 @equalsandhashcode

@equalsandhashcode 注解就是用于根据类所拥有的非静态字段自动重写 equals 方法和 hashcode 方法,方便我们用于对象间的比较。类似 @tostring，@equalsandhashcode 还可以使用需要作为比较的字段和排除不需要比较的字段，具体用法可以看如下示例：

@getter
@setter
@allargsconstructor
@tostring
@equalsandhashcode
public class user4 {
@equalsandhashcode.exclude
private integer id;
@equalsandhashcode.include
private string username;
@equalsandhashcode.exclude
private string password;
}

写完实体类代码，我们编写测试方法试下效果：

@test
public void testequal() {
user4 user4 = new user4(1, "user4", "zxc");
user4 user4_2 = new user4(1, "user4", "123");
assert.assertequals(user4, user4_2); // ture
}

2.7 @data/@value

@data/@value 注解，提供了更综合的生成代码功能，等价于下面几个注解

• @getter
• @setter
• @requiredargsconstructor
• @tostring
• @equalsandhashcode

两个注解都只能使用在类上，与 @data 不同， @value 用来修饰不可变的类上。一般实体类没有特别的限制的话，通常可以直接使用 @data 注解修饰。

2.8 @builder

@builder 是一个非常强大的注解，提供了一种基于建造者模式的构建对象的 api。使用 @builder 注解为给我们的实体类自动生成 builder() 方法，并且直接根据字段名称方法进行字段赋值，最后使用 build()方法构建出一个实体对象。

@data
@builder
public class user6 {
private integer id;
private string username;
private string password;
}
@test
public void testbuilder() {
user6 user6 = user6.builder().id(1).username("user6").password("zxc123").build();
log.warn("testlog: {}", user6); // user6(id=1, username=user6, password=zxc123)
}

需要注意的是 @builder 不支持父类字段的生成，当一个实体类存在父类时，@builder 只能生成当前类的字段构建方法。

若需要用到父类的字段方法时， lombok 提供了新的注解 @superbuilder 来应对这种情况，下面是 @superbuilder 注解的使用方式:

@superbuilder
@getter
@setter
public class parent {
private int id;
private string name;
}
@superbuilder
@data
public class child extends parent {
private string childname;
}

调用示例:

child child = child.builder().id(1).name("父类名称").childname("子类名称").build();
system.out.println(child.getid());

由于 lombok plugin 还未更新支持@superbuilder，所以以上写法在 idea 下还会提示编译错误，无法找到 builder()方法。

也可以参考此文方式去处理继承的情况：reinhard.codes/2015/09/16/…

2.9 日志注解

正对程序类中常见不同框架 logger 对象，lombok 也提供了注解，来自动生成 logger 对象，实现优雅地输出日志,只需要在类上使用日志注解如 @log。当然 lombok 支持了多个日志框架，并且提供对应的注解如下：

• @commonslog 等价效果： private static final org.apache.commons.logging.log log = org.apache.commons.logging.logfactory.getlog(logexample.class);
• @flogger 等价效果： private static final com.google.common.flogger.fluentlogger log = com.google.common.flogger.fluentlogger.forenclosingclass();
• @jboslog 等价效果： private static final org.jboss.logging.logger log = org.jboss.logging.logger.getlogger(logexample.class);
• @log 等价效果： private static final java.util.logging.logger log = java.util.logging.logger.getlogger(logexample.class.getname());
• @log4j 等价效果： private static final org.apache.log4j.logger log = org.apache.log4j.logger.getlogger(logexample.class);
• @log4j2 等价效果： private static final org.apache.logging.log4j.logger log = org.apache.logging.log4j.logmanager.getlogger(logexample.class);
• @slf4j 等价效果： private static final org.slf4j.logger log = org.slf4j.loggerfactory.getlogger(logexample.class);
• @xslf4j 等价效果: private static final org.slf4j.ext.xlogger log = org.slf4j.ext.xloggerfactory.getxlogger(logexample.class);

下面代码使用 @slf4j 注解进行日志输出：

@slf4j
public class usertests {
// ....
@test
public void testlog() {
user5 user5 = new user5();
user5.setid(1);
user5.setusername("user5");
user5.setpassword("zxc123");
log.warn("testlog: {}", user5);
// 21:57:15.488 [main] warn com.one.learn.lombok.usertests - testlog: user5(id=1, username=user5, password=zxc123)
}
}

2.10 @cleanup

@cleanup 用于标记需要释放清理操作的资源对象变量，如 fileinputstream, fileoutputstream 等，标记之后资源对象使用完毕后，就会被自动关闭和清理，实际上这里 lombok 实现效果与 java7 特性 try with resource 一样, 为我们屏蔽了关闭资源的模板代码，下面给出 @cleanup 的使用示例：

public class cleanupexample {
public static void main(string[] args) throws ioexception {
@cleanup inputstream in = new fileinputstream(args[0]);
@cleanup outputstream out = new fileoutputstream(args[1]);
byte[] b = new byte[10000];
while (true) {
int r = in.read(b);
if (r == -1) {
break;
}
out.write(b, 0, r);
}
}
}

将 cleanupexample.java 编译生成的字节码反编译可以得到如下结果：

public class cleanupexample {
//...
public static void main(string[] args) throws ioexception {
fileinputstream in = new fileinputstream(args[0]);
try {
fileoutputstream out = new fileoutputstream(args[1]);
try {
byte[] b = new byte[10000];
while(true) {
int r = in.read(b);
if (r == -1) {
return;
}
out.write(b, 0, r);
}
} finally {
if (collections.singletonlist(out).get(0) != null) {
out.close();
}
}
} finally {
if (collections.singletonlist(in).get(0) != null) {
in.close();
}
}
}
}

2.11 @sneakythrows

@sneakythrows 主要用于在没有 throws 关键字的情况下，隐蔽地抛出受检查异常，为我们平常开发中需要异常抛出时省去的 throw 操作,下面为使用 @sneakythrows 的示例代码：

public class sneakythrowsexample implements runnable {
@sneakythrows(unsupportedencodingexception.class)
public string utf8tostring(byte[] bytes) {
return new string(bytes, "utf-8");
}
@sneakythrows
public void run() {
throw new throwable();
}
}

最终编译成字节码，反编译结果如下：

public class sneakythrowsexample implements runnable {
public sneakythrowsexample() {
}
public string utf8tostring(byte[] bytes) {
try {
return new string(bytes, "utf-8");
} catch (unsupportedencodingexception var3) {
throw var3;
}
}
public void run() {
try {
throw new throwable();
} catch (throwable var2) {
throw var2;
}
}
}

2.12 val/var

val/var 用于局部变量的修饰，有了这注解修饰后，变量的类型就会自动通过等号右边的表达式推断出来，这个功能借鉴于许多编程语言的自动类型推断的特性。

而 val 与 var 的区别在于， val 用于修饰不可变变量，var 修饰可变变量。当 val 修饰的变量被重新赋值时，编译器就会提示异常：error: java: 无法为最终变量 x 分配值。实际用法也比较简单，可参考下面代码：

@slf4j
public class varvalexample {
public static void main(string[] args) {
val text = "abc";
// text = "1"; // error: java: 无法为最终变量 text 分配值`。
var num = 1;
num = 2;
log.info("text:{},num:{}", text, num); // text:abc,num:2
}
}

3. 结语

到这里我们学习了 lombok 的近乎 80% 常用的注解，应用在我们的日常开发中已经是绰绰有余了，开始尝试 使用 lombok 吧，慢慢地就会感受下效率的提升以及代码的优雅。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。