1、简述
lombok 是 java 开发中常用的工具库,通过注解的方式大大简化了代码开发,尤其是在 getter/setter、构造方法、日志工具 等常见场景中,能够极大地减少样板代码 (boilerplate)。本篇文章将从基础入门到高级用法,深入讲解 lombok 的使用技巧和注意事项。
2、什么是 lombok
lombok 是一个 java 注解处理工具,主要通过 编译时注解 自动生成代码。开发者在代码中添加简短的注解,lombok 就能自动为类生成常见方法,从而减少冗余代码,提高开发效率。
主要功能
- 自动生成 getter/setter。
- 生成 equals、hashcode、tostring。
- 构造器的自动生成。
- 支持 builder 模式。
- 集成日志工具。
- 提供高级功能,如链式调用、自定义访问级别等。
2.1 maven 依赖
在项目的 pom.xml 中引入 lombok:
<dependency>
<groupid>org.projectlombok</groupid>
<artifactid>lombok</artifactid>
<version>1.18.30</version>
<scope>provided</scope>
</dependency>
注意: provided 表示 lombok 仅在编译时有效,运行时不需要依赖它。
2.2 ide 配置
大部分 ide(如 intellij idea、eclipse)都支持 lombok,但需要安装插件:
intellij idea: 在插件市场中搜索 lombok 并安装。
eclipse: 下载并安装 lombok jar 文件,运行 java -jar lombok.jar 进行配置。
3、基础用法
3.1 自动生成 getter 和 setter
lombok 的 @getter 和 @setter 注解会自动为类的字段生成 getxxx 和 setxxx 方法。
import lombok.getter;
import lombok.setter;
public class user {
@getter @setter
private string name;
@getter @setter
private int age;
}
使用后,编译器会自动生成以下代码:
public string getname() { return name; }
public void setname(string name) { this.name = name; }
public int getage() { return age; }
public void setage(int age) { this.age = age; }
3.2 构造器注解
- @noargsconstructor:生成无参构造器。
- @allargsconstructor:生成包含所有字段的构造器。
- @requiredargsconstructor:生成包含 final 字段的构造器。
import lombok.allargsconstructor;
import lombok.noargsconstructor;
import lombok.requiredargsconstructor;
@noargsconstructor
@allargsconstructor
@requiredargsconstructor
public class user {
private final string id;
private string name;
private int age;
}
3.3 @tostring 和 @equalsandhashcode
@tostring:生成 tostring 方法,自动包含类中的字段。
@equalsandhashcode:生成 equals 和 hashcode 方法。
import lombok.equalsandhashcode;
import lombok.tostring;
@tostring
@equalsandhashcode
public class user {
private string name;
private int age;
}
3.4 @data 注解
@data 是一个组合注解,相当于以下 注解的合集:
- @getter
- @setter
- @tostring
- @equalsandhashcode
- @requiredargsconstructor
import lombok.data;
@data
public class user {
private string name;
private int age;
}
4、高级用法
4.1 builder 模式
lombok 提供了 @builder 注解来自动生成 builder 模式的代码,适用于需要构建复杂对象的场景。
import lombok.builder;
import lombok.tostring;
@builder
@tostring
public class user {
private string name;
private int age;
private string address;
}
使用方式:
user user = user.builder()
.name("john")
.age(30)
.address("new york")
.build();
system.out.println(user);
4.2 日志注解
lombok 提供了多种日志注解,自动为类注入对应的日志工具:
@slf4j:注入 slf4j 日志对象。
@log4j2:注入 log4j2 日志对象。
@commonslog:注入 commons logging 日志对象。
import lombok.extern.slf4j.slf4j;
@slf4j
public class loggingexample {
public static void main(string[] args) {
log.info("this is an info log.");
log.error("this is an error log.");
}
}
4.3 链式调用
通过 @accessors(fluent = true, chain = true),可以生成链式调用的 setter 方法。
import lombok.getter;
import lombok.setter;
import lombok.experimental.accessors;
@getter
@setter
@accessors(chain = true)
public class user {
private string name;
private int age;
}
使用方式:
user user = new user().setname("john").setage(30);
system.out.println(user.getname());
4.4 自定义 getter 和 setter 的访问级别
可以通过 @getter 和 @setter 的 accesslevel 属性设置访问级别(如 public、private)。
import lombok.accesslevel;
import lombok.getter;
import lombok.setter;
public class user {
@getter
@setter(accesslevel.private)
private string name;
}
4.5 @value:不可变对象
@value 注解会将类标记为不可变对象,相当于:
- 所有字段为 private final。
- 类为 final。
- 自动生成 getter。
import lombok.value;
@value
public class immutableuser {
string name;
int age;
}
4.6 @sneakythrows:异常处理
@sneakythrows 注解会自动将受检异常(checked exception)包装为运行时异常。
import lombok.sneakythrows;
public class sneakythrowsexample {
@sneakythrows
public void readfile() {
throw new exception("checked exception");
}
}
4.7 实验性功能:@with
@with 注解可以用于生成 不可变对象的复制方法,用于替换某些字段。
import lombok.value;
import lombok.with;
@value
public class user {
@with private string name;
private int age;
}
使用方式:
user user1 = new user("john", 30);
user user2 = user1.withname("doe");
system.out.println(user1); // user(name=john, age=30)
system.out.println(user2); // user(name=doe, age=30)
5、总结
lombok 是简化 java 开发中样板代码的神器,其注解如 @getter、@setter、@builder 等能显著提升编码效率。此外,像 @value 和 @with 这样的高级功能,为构建不可变对象提供了便利。
在日常开发中,合理使用 lombok,不仅能让代码更加简洁、优雅,也能提高团队的开发效率。不过,在一些需要明确代码逻辑的关键场景下,仍需谨慎使用,以避免可读性问题。
到此这篇关于java中lombok工具库使用的技术指南的文章就介绍到这了,更多相关java lombok库内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论