-
在调用
build()
之后调用其中一个adder
方法或clear
方法不会修改任何已经生成的对象。如果对集合修改之后,再调用build()
,则会创建一个基于上一个对象创建的对象实体。 -
生成的集合将被压缩到最小的可行格式,同时保持高效。
@Singular
只能应用于lombok
已知的集合类型。目前,支持的类型有:
java.util:
-
Iterable
,Collection
, 和List
(一般情况下,由压缩的不可修改的ArrayList
支持). -
Set
,SortedSet
, andNavigableSet
(一般情况下,生成可变大小不可修改的HashSet
或者TreeSet
). -
Map
,SortedMap
, andNavigableMap
(一般情况下,生成可变大小不可修改的HashMap
或者TreeMap
).
Guava’s com.google.common.collect:
-
ImmutableCollection
andImmutableList
-
ImmutableSet
andImmutableSortedSet
-
ImmutableMap
,ImmutableBiMap
, andImmutableSortedMap
-
ImmutableTable
来看看使用了@Singular
注解之后的编译情况:
@Builder
public class User {
private final Integer id;
private final String zipCode = “123456”;
private String username;
private String password;
@Singular
private List hobbies;
}
// 编译后:
public class User {
private final Integer id;
private final String zipCode = “123456”;
private String username;
private String password;
private List hobbies;
User(Integer id, String username, String password, List hobbies) {
this.id = id; this.username = username;
this.password = password; this.hobbies = hobbies;
}
public static User.UserBuilder builder() {return new User.UserBuilder();}
public static class UserBuilder {
private Integer id;
private String username;
private String password;
private ArrayList hobbies;
UserBuilder() {}
public User.UserBuilder id(Integer id) { this.id = id; return this; }
public User.UserBuilder username(String username) { this.username = username; return this; }
public User.UserBuilder password(String password) { this.password = password; return this; }
public User.UserBuilder hobby(String hobby) {
if (this.hobbies == null) {
this.hobbies = new ArrayList();
}
this.hobbies.add(hobby);
return this;
}
public User.UserBuilder hobbies(Collection<? extends String> hobbies) {
if (this.hobbies == null) {
this.hobbies = new ArrayList();
}
this.hobbies.addAll(hobbies);
return this;
}
public User.UserBuilder clearHobbies() {
if (this.hobbies != null) {
this.hobbies.clear();
}
return this;
}
public User build() {
List hobbies;
switch(this.hobbies == null ? 0 : this.hobbies.size()) {
case 0:
hobbies = Collections.emptyList();
break;
case 1:
hobbies = Collections.singletonList(this.hobbies.get(0));
break;
default:
hobbies = Collections.unmodifiableList(new ArrayList(this.hobbies));
}
return new User(this.id, this.username, this.password, hobbies);
}
public String toString() {
return “User.UserBuilder(id=” + this.id + “, username=” + this.username + “, password=” + this.password + “, hobbies=” + this.hobbies + “)”;
}
}
}
其实,lombok 的创作者还是很用心的,在进行build()
来创建实例对象时, 并没有直接使用Collections.unmodifiableList(Collection)
此方法来创建实例,而是分为三种情况。
-
第一种,当集合中没有元素时,创建一个空 list
-
第二种情况,当集合中存在一个元素时,创建一个不可变的单元素 list
-
第三种情况,根据当前集合的元素数量创建对应合适大小的 list
当然我们看编译生成的代码,创建了三个关于集合操作的方法:
-
hobby(String hobby)
:向集合中添加一个元素 -
hobbies(Collection<? extends String> hobbies)
:添加一个集合所有的元素 -
clearHobbies()
:清空当前集合数据
- @Singular 注解配置 value 属性
我们先来看看 @Singular 注解的详情:
@Target({FIELD, PARAMETER})
@Retention(SOURCE)
public @interface Singular {
// 修改添加集合元素的方法名
String value() default “”;
}
- 测试如何使用注解属性
value
@Builder
public class User {
private final Integer id;
private final String zipCode = “123456”;
private String username;
private String password;
@Singular(value = “testHobbies”)
private List hobbies;
}
// 测试类
public class BuilderTest {
public static void main(String[] args) {
User user = User.builder()
.testHobbies(“reading”)
.testHobbies(“eat”)
.id(1)
.password(“admin”)
.username(“admin”)
.build();
System.out.println(user);
}
}
说明,当我们使用了注解属性value
之后,我们在使用添加集合元素时的方法名发生相应的改变。但是,同时生成的添加整个集合的方法名发生改变了吗?我们再来看看编译后的代码:
/ 编译后:
public class User {
// 省略部分代码,只看关键部分
public static class UserBuilder {
public User.UserBuilder testHobbies(String testHobbies) {
if (this.hobbies == null) {
this.hobbies = new ArrayList();
}
this.hobbies.add(testHobbies);
return this;
}
public User.UserBuilder hobbies(Collection<? extends String> hobbies) {
if (this.hobbies == null) {
this.hobbies = new ArrayList();
}
this.hobbies.addAll(hobbies);
return this;
}
public User.UserBuilder clearHobbies() {
if (this.hobbies != null) {
this.hobbies.clear();
}
return this;
}
}
}
可以看到,只有添加一个元素的方法名发生了改变。推荐:Java进阶学习资料。
- @Builder.Default 的使用
比如有这样一个实体类:
@Builder
@ToString
public class User {
@Builder.Default
private final String id = UUID.randomUUID().toString();
private String username;
private String password;
@Builder.Default
private long insertTime = System.currentTimeMillis();
}
在类中我在id
和insertTime
上都添加注解@Builder.Default
,当我在使用这个实体对象时,我就不需要在为这两个字段进行初始化值,如下面这样:
public class BuilderTest {
public static void main(String[] args) {
User user = User.builder()
.password(“admin”)
.username(“admin”)
.build();
System.out.println(user);
}
}
// 输出内容:
User(id=416219e1-bc64-43fd-b2c3-9f8dc109c2e8, username=admin, password=admin, insertTime=1546869309868)
lombok
在实例化对象时就为我们初始化了这两个字段值。
当然,你如果再对这两个字段进行设值的话,那么默认定义的值将会被覆盖掉,如下面这样:
public class BuilderTest {
public static void main(String[] args) {
User user = User.builder()
.id(“admin”)
.password(“admin”)
.username(“admin”)
.build();
System.out.println(user);
}
}
// 输出内容
User(id=admin, username=admin, password=admin, insertTime=1546869642151)
- @Builder 详细配置
下面我们再来详细看看@Builder
这个注解类地详细实现:
@Target({TYPE, METHOD, CONSTRUCTOR})
@Retention(SOURCE)
public @interface Builder {
// 如果@Builder注解在类上,可以使用 @Builder.Default指定初始化表达式
@Target(FIELD)
@Retention(SOURCE)
public @interface Default {}
// 指定实体类中创建 Builder 的方法的名称,默认为: builder (个人觉得没必要修改)
String builderMethodName() default “builder”;
// 指定 Builder 中用来构件实体类的方法的名称,默认为:build (个人觉得没必要修改)
String buildMethodName() default “build”;
// 指定创建的建造者类的名称,默认为:实体类名+Builder
String builderClassName() default “”;
// 使用toBuilder可以实现以一个实例为基础继续创建一个对象。(也就是重用原来对象的值)
boolean toBuilder() default false;
@Target({FIELD, PARAMETER})
@Retention(SOURCE)
public @interface ObtainVia {
// 告诉lombok使用表达式获取值
String field() default “”;
// 告诉lombok使用表达式获取值
String method() default “”;
boolean isStatic() default false;
最后
小编在这里分享些我自己平时的学习资料,由于篇幅限制,pdf文档的详解资料太全面,细节内容实在太多啦,所以只把部分知识点截图出来粗略的介绍,每个小节点里面都有更细化的内容!
开源分享:【一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码】
程序员代码面试指南 IT名企算法与数据结构题目最优解
这是” 本程序员面试宝典!书中对IT名企代码面试各类题目的最优解进行了总结,并提供了相关代码实现。针对当前程序员面试缺乏权威题目汇总这一-痛点, 本书选取将近200道真实出现过的经典代码面试题,帮助广“大程序员的面试准备做到万无一失。 “刷”完本书后,你就是“题王”!
《TCP-IP协议组(第4版)》
本书是介绍TCP/IP协议族的经典图书的最新版本。本书自第1版出版以来,就广受读者欢迎。
本书最新版进行」护元,以体境计算机网络技不的最新发展,全书古有七大部分共30草和7个附录:第一部分介绍一些基本概念和基础底层技术:第二部分介绍网络层协议:第三部分介绍运输层协议;第四部分介绍应用层协议:第五部分介绍下一代协议,即IPv6协议:第六部分介绍网络安全问题:第七部分给出了7个附录。
Java开发手册(嵩山版)
这个不用多说了,阿里的开发手册,每次更新我都会看,这是8月初最新更新的**(嵩山版)**
MySQL 8从入门到精通
本书主要内容包括MySQL的安装与配置、数据库的创建、数据表的创建、数据类型和运算符、MySQL 函数、查询数据、数据表的操作(插入、更新与删除数据)、索引、存储过程和函数、视图、触发器、用户管理、数据备份与还原、MySQL 日志、性能优化、MySQL Repl ication、MySQL Workbench、 MySQL Utilities、 MySQL Proxy、PHP操作MySQL数据库和PDO数据库抽象类库等。最后通过3个综合案例的数据库设计,进步讲述 MySQL在实际工作中的应用。
Spring5高级编程(第5版)
本书涵盖Spring 5的所有内容,如果想要充分利用这一领先的企业级 Java应用程序开发框架的强大功能,本书是最全面的Spring参考和实用指南。
本书第5版涵盖核心的Spring及其与其他领先的Java技术(比如Hibemate JPA 2.Tls、Thymeleaf和WebSocket)的集成。本书的重点是介绍如何使用Java配置类、lambda 表达式、Spring Boot以及反应式编程。同时,将与企业级应用程序开发人员分享一些见解和实际经验,包括远程处理、事务、Web 和表示层,等等。
JAVA核心知识点+1000道 互联网Java工程师面试题
企业IT架构转型之道 阿里巴巴中台战略思想与架构实战
本书讲述了阿里巴巴的技术发展史,同时也是-部互联网技 术架构的实践与发展史。
ySQL在实际工作中的应用。
[外链图片转存中…(img-onBF3Shi-1714493499389)]
Spring5高级编程(第5版)
本书涵盖Spring 5的所有内容,如果想要充分利用这一领先的企业级 Java应用程序开发框架的强大功能,本书是最全面的Spring参考和实用指南。
本书第5版涵盖核心的Spring及其与其他领先的Java技术(比如Hibemate JPA 2.Tls、Thymeleaf和WebSocket)的集成。本书的重点是介绍如何使用Java配置类、lambda 表达式、Spring Boot以及反应式编程。同时,将与企业级应用程序开发人员分享一些见解和实际经验,包括远程处理、事务、Web 和表示层,等等。
[外链图片转存中…(img-KcuDeWPW-1714493499389)]
JAVA核心知识点+1000道 互联网Java工程师面试题
[外链图片转存中…(img-UrnvMv2J-1714493499389)]
[外链图片转存中…(img-ORSJ1bAZ-1714493499390)]
企业IT架构转型之道 阿里巴巴中台战略思想与架构实战
本书讲述了阿里巴巴的技术发展史,同时也是-部互联网技 术架构的实践与发展史。
[外链图片转存中…(img-zHLZYC5h-1714493499390)]