标签：思考 等价 const 推荐阅读 city tom 功能 http 函数
Lombok 简介点击左上角，关注：“锅外的大佬”
专注分享国外最新技术内容
帮助每位开发者更优秀地成长
和其他语言相比， Java经常因为不必要的冗长被批评。 Lombok提供了一系列注解用以在后台生成模板代码，将其从你的类中删除，从而有助于保持你的代码整洁。较少的模板意味着更简洁的代码，更易于阅读和维护。在本文中，我将涉及我经常使用的 Lombok功能，并想你展示如何使用他们生产更清晰、更简洁的代码。
许多语言通过查看等号右侧的表达式来推断局部变量类型。尽管现在 Java10+已经支持这种功能，但在之前的版本中没有 Lombok的帮助就无法实现。下面的代码段展示了如何显式指定局部类型：
final
Map
<
String
,
Integer
>
map
=
new
HashMap
<>();
map
.
put
(
"Joe"
,
21
);在 Lombok中，我们可以通过使用 val来缩短它，如下所示：
val valMap
=
new
HashMap
<
String
,
Integer
>();
valMap
.
put
(
"Sam"
,
30
);注意， val在背后创建了一个 final且不可变的变量。如果你需要一个可变本地变量，可以使用 var。
对方法参数进行 null检查通常不是一个坏主意，特别是如果该方法形成的 API被其他开发者使用。虽然这些检查很简单，但是他们可能变得冗长，特别是当你有多个参数时。如下所示，额外的代码无助于可读性，并且可能从方法的主要目的分散注意力。
public
void
nonNullDemo
(
Employee
employee
,
Account
account
)
{
if
(
employee
==
null
)
{
throw
new
IllegalArgumentException
(
"Employee is marked @NonNull but is null"
);
}
if
(
account
==
null
)
{
throw
new
IllegalArgumentException
(
"Account is marked @NonNull but is null"
);
}
// do stuff
}理想情况下，你需要 null检查——没有干扰的那种。这就是 @NonNull发挥作用的地方。通过用 @NonNull标记参数， Lombok替你为该参数生成 null检查。你的方法突然变得更加简洁，但没有丢失那些安全性的 null检查。
public
void
nonNullDemo
(
@NonNull
Employee
employee
,
@NonNull
Account
account
)
{
// just do stuff
}默认情况下， Lombok会抛出 NullPointerException，如果你愿意，可以配置 Lombok抛出 IllegalArgumentException。我个人更喜欢 IllegalArgumentException，因为我认为它更适合于对参数检查。
数据类是 Lombok真正有助于减少模板代码的领域。在查看该选项前，思考一下我们经常需要处理的模板种类。数据类通常包括以下一种或全部：
想想下面的 Car类。当生成 getter和 setter时，我们会得到接近 50 行代码来描述一个包含 5 个成员变量的类。
public
class
Car
{
private
String
make
;
private
String
model
;
private
String
bodyType
;
private
int
yearOfManufacture
;
private
int
cubicCapacity
;
public
String
getMake
()
{
return
make
;
}
public
void
setMake
(
String
make
)
{
this
.
make
=
make
;
}
public
String
getModel
()
{
return
model
;
}
public
void
setModel
(
String
model
)
{
this
.
model
=
model
;
}
public
String
getBodyType
()
{
return
bodyType
;
}
public
void
setBodyType
(
String
bodyType
)
{
this
.
bodyType
=
bodyType
;
}
public
int
getYearOfManufacture
()
{
return
yearOfManufacture
;
}
public
void
setYearOfManufacture
(
int
yearOfManufacture
)
{
this
.
yearOfManufacture
=
yearOfManufacture
;
}
public
int
getCubicCapacity
()
{
return
cubicCapacity
;
}
public
void
setCubicCapacity
(
int
cubicCapacity
)
{
this
.
cubicCapacity
=
cubicCapacity
;
}
}Lombok可以替你生成 getter和 setter模板。通过对每个成员变量使用 @Getter和 @Setter注解，你最终得到一个等效的类，如下所示：
public
class
Car
{
@Getter
@Setter
private
String
make
;
@Getter
@Setter
private
String
model
;
@Getter
@Setter
private
String
bodyType
;
@Getter
@Setter
private
int
yearOfManufacture
;
@Getter
@Setter
private
int
cubicCapacity
;
}注意，你可以在非 final成员变量上只使用 @Setter。在 final成员变量上使用它将导致编译错误。
如果你需要为每个成员变量生成 getter和 setter，你也可以在类级别使用 @Getter和 @Setter，如下所示。
@Getter
@Setter
public
class
Car
{
private
String
make
;
private
String
model
;
private
String
bodyType
;
private
int
yearOfManufacture
;
private
int
cubicCapacity
;
}数据类通常包含一个构造函数，它为每个成员变量接受参数。IDE 为 Car生成的构造函数如下所示：
public
class
Car
{
@Getter
@Setter
private
String
make
;
@Getter
@Setter
private
String
model
;
@Getter
@Setter
private
String
bodyType
;
@Getter
@Setter
private
int
yearOfManufacture
;
@Getter
@Setter
private
int
cubicCapacity
;
public
Car
(
String
make
,
String
model
,
String
bodyType
,
int
yearOfManufacture
,
int
cubicCapacity
)
{
super
();
this
.
make
=
make
;
this
.
model
=
model
;
this
.
bodyType
=
bodyType
;
this
.
yearOfManufacture
=
yearOfManufacture
;
this
.
cubicCapacity
=
cubicCapacity
;
}
}我们可以使用 @AllArgsConstructor注解实现同样功能。 @Getter和 @Setter、 @AllArgsConstructor减少模板，保持类更干净且更简洁。
@AllArgsConstructor
public
class
Car
{
@Getter
@Setter
private
String
make
;
@Getter
@Setter
private
String
model
;
@Getter
@Setter
private
String
bodyType
;
@Getter
@Setter
private
int
yearOfManufacture
;
@Getter
@Setter
private
int
cubicCapacity
;
}还有其他选项用于生成构造函数。 @RequiredArgsConstructor将创建带有每个 final成员变量参数的构造函数， @NoArgsConstructor将创建没有参数的构造函数。
在你的数据类上覆盖 toString方法是有助于记录日志的良好实践。IDE 为 Car类生成的 toString方法如下所示：
@AllArgsConstructor
public
class
Car
{
@Getter
@Setter
private
String
make
;
@Getter
@Setter
private
String
model
;
@Getter
@Setter
private
String
bodyType
;
@Getter
@Setter
private
int
yearOfManufacture
;
@Getter
@Setter
private
int
cubicCapacity
;
@Override
public
String
toString
()
{
return
"Car [make="
+
make
+
", model="
+
model
+
", bodyType="
+
bodyType
+
", yearOfManufacture="
+
yearOfManufacture
+
", cubicCapacity="
+
cubicCapacity
+
"]"
;
}
}我们可以使用 ToString注解废除这个，如下所示：
@ToString
@AllArgsConstructor
public
class
Car
{
@Getter
@Setter
private
String
make
;
@Getter
@Setter
private
String
model
;
@Getter
@Setter
private
String
bodyType
;
@Getter
@Setter
private
int
yearOfManufacture
;
@Getter
@Setter
private
int
cubicCapacity
;
}默认情况下， Lombok生成包含所有成员变量的 toString方法。可以通过 exclude属性 @ToString(exclude={"someField"},"someOtherField"}) 覆盖行为将某些成员变量排除。
如果你正在将你的数据类和任何类型的对象比较，则需要覆盖 equals和 hashCode 方法。对象的相等是基于业务规则定义的。举个例子，在 Car类中，如果两个对象有相同的 make、 model和 bodyType，我可能认为他们是相等的。如果我使用 IDE 生成 equals方法检查 make、 model和 bodyType，它看起来会是这样：
@Override
public
boolean
equals
(
Object
obj
)
{
if
(
this
==
obj
)
return
true
;
if
(
obj
==
null
)
return
false
;
if
(
getClass
()
!=
obj
.
getClass
())
return
false
;
Car
other
=
(
Car
)
obj
;
if
(
bodyType
==
null
)
{
if
(
other
.
bodyType
!=
null
)
return
false
;
}
else
if
(!
bodyType
.
equals
(
other
.
bodyType
))
return
false
;
if
(
make
==
null
)
{
if
(
other
.
make
!=
null
)
return
false
;
}
else
if
(!
make
.
equals
(
other
.
make
))
return
false
;
if
(
model
==
null
)
{
if
(
other
.
model
!=
null
)
return
false
;
}
else
if
(!
model
.
equals
(
other
.
model
))
return
false
;
return
true
;
}等价的 hashCode实现如下所示：
@Override
public
int
hashCode
()
{
final
int
prime
=
31
;
int
result
=
1
;
result
=
prime
*
result
+
((
bodyType
==
null
)
?
0
:
bodyType
.
hashCode
());
result
=
prime
*
result
+
((
make
==
null
)
?
0
:
make
.
hashCode
());
result
=
prime
*
result
+
((
model
==
null
)
?
0
:
model
.
hashCode
());
return
result
;
}虽然 IDE 处理了繁重的工作，但我们在类中仍然有大量的模板代码。 Lombok允许我们使用 @EqualsAndHashCode类注解实现相同的功能，如下所示：
@ToString
@AllArgsConstructor
@EqualsAndHashCode
(
exclude
=
{
"yearOfManufacture"
,
"cubicCapacity"
})
public
class
Car
{
@Getter
@Setter
private
String
make
;
@Getter
@Setter
private
String
model
;
@Getter
@Setter
private
String
bodyType
;
@Getter
@Setter
private
int
yearOfManufacture
;
@Getter
@Setter
private
int
cubicCapacity
;
}默认情况下， @EqualsAndHashCode会创建包含所有成员变量的 equals和 hashCode方法。 exclude选项可用于通知 Lombok排除某些成员变量。在上面的代码片段中。我已经从生成的 equals和 hashCode方法中排除了 yearOfManuFacture 和 cubicCapacity。
如果你想使数据类尽可能精简，可以使用 @Data注解。 @Data 是 @Getter、 @Setter、 @ToString、 @EqualsAndHashCode 和 @RequiredArgsConstructor 的快捷方式。
@ToString
@RequiredArgsConstructor
@EqualsAndHashCode
(
exclude
=
{
"yearOfManufacture"
,
"cubicCapacity"
})
public
class
Car
{
@Getter
@Setter
private
String
make
;
@Getter
@Setter
private
String
model
;
@Getter
@Setter
private
String
bodyType
;
@Getter
@Setter
private
int
yearOfManufacture
;
@Getter
@Setter
private
int
cubicCapacity
;
}通过使用 @Data，我们可以将上面的类精简如下：
@Data
public
class
Car
{
private
String
make
;
private
String
model
;
private
String
bodyType
;
private
int
yearOfManufacture
;
private
int
cubicCapacity
;
}建造者设计模式描述了一种灵活的创建对象的方式。 Lombok可以帮你轻松的实现该模式。看一个使用简单 Car类的示例。假设我们希望可以创建各种 Car对象，但我们希望在创建时设置的属性具有灵活性。
@AllArgsConstructor
public
class
Car
{
private
String
make
;
private
String
model
;
private
String
bodyType
;
private
int
yearOfManufacture
;
private
int
cubicCapacity
;
private
List
<
LocalDate
>
serviceDate
;
}假设我们要创建一个 Car，但只想设置 make和 model。在 Car上使用标准的全参数构造函数意味着我们只提供 make和 model并设置其他参数为 null。
Car2
car2
=
new
Car2
(
"Ford"
,
"Mustang"
,
null
,
null
,
null
,
null
);这可行但并不理想，我们必须为我们不感兴趣的参数传递 null。我们可以创建一个只接受 make和 model的构造函数来避开这个问题。这是一个合理的解决方法，但不够灵活。如果我们有许多不同的字段排列，我们可以用什么来创建一个新 Car？最终我们得到了一堆不同的构造函数，代表了我们可以实例化 Car的所有可能方式。
解决该问题的一种干净、灵活的方式是使用建造者模式。 Lombok通过 @Builder 注解帮你实现建造者模式。当你使用 @Builder注解 Car类时， Lombok会执行以下操作：
Car
muscleCar
=
Car
.
builder
().
make
(
"Ford"
)
.
model
(
"mustang"
)
.
bodyType
(
"coupe"
)
.
build
();现在只使用 make和 model创建 Car比之前更简洁了。只需在 Car上简单的调用生成的 builder方法获取 CarBuilder实例，然后调用任何我们感兴趣的 setter风格方法。最后，调用 build创建 Car的新实例。
另一个值得一提的方便的注解是 @Singular。默认情况下，Lombok 为集合创建使用集合参数的标准的 setter 风格方法。在下面的例子中，我们创建了新的 Car并设置了服务日期列表。
Car
muscleCar
=
Car
.
builder
().
make
(
"Ford"
)
.
model
(
"mustang"
)
.
serviceDate
(
Arrays
.
asList
(
LocalDate
.
of
(
2016
,
5
,
4
)))
.
build
();向集合成员变量添加 @Singular将提供一个额外的方法，允许你向集合添加单个项。
@Builder
public
class
Car
{
private
String
make
;
private
String
model
;
private
String
bodyType
;
private
int
yearOfManufacture
;
private
int
cubicCapacity
;
@Singular
private
List
<
LocalDate
>
serviceDate
;
}现在我们可以添加单个服务日期，如下所示：
Car
muscleCar3
=
Car
.
builder
()
.
make
(
"Ford"
)
.
model
(
"mustang"
)
.
serviceDate
(
LocalDate
.
of
(
2016
,
5
,
4
))
.
build
();这是一个有助于在创建对象期间处理集合时保持代码简洁的快捷方法。
Lombok另一个伟大的功能是日志记录器。如果没有 Lombok，要实例化标准的 SLF4J日志记录器，通常会有以下内容：
public
class
SomeService
{
private
static
final
org
.
slf4j
.
Logger
log
=
org
.
slf4j
.
LoggerFactory
.
getLogger
(
LogExample
.
class
);
public
void
doStuff
(){
log
.
debug
(
"doing stuff...."
);
}
}这些日志记录器很沉重，并为每个需要日志记录的类添加了不必要的混乱。值得庆幸的是 Lombok提供了一个为你创建日志记录器的注解。你要做的所有事情就是在类上添加注解，这样就可以了。
@Slf4j
public
class
SomeService
{
public
void
doStuff
(){
log
.
debug
(
"doing stuff...."
);
}
}我在这里使用了 @SLF4J注解，但 Lombok能为几乎所有通用 Java日志框架生成日志记录器。有关更多日志记录器的选项，请参阅文档。
我非常喜欢 Lombok的一点是它的不侵入性。。如果你决定在使用如 @Getter、 @Setter 或 @ToString时也想要自己的方法实现，你的方法将总是优先于 Lombok。它允许你在大多数时间使用 Lombok，但在你需要的时候仍有控制权。
在过去的 4 到 5 年里，我几乎在每个项目中都使用了 Lombok。我喜欢它，因为它减少了杂乱，最终得到了更干净、更简洁、更易阅读的代码。它不一定为你节省大量时间，因为它生成的代码可以由 IDE 自动生成。话虽如此，我认为更干净的代码的好处不仅仅是将其添加到 Java堆栈中。
我已经介绍了我经常使用的 Lombok功能，但还有很多我没有讲到。如果你喜欢目前为止所看到的，并希望了解更多，请继续阅读 Lombok 文档。
原文链接：https://dzone.com/articles/introduction-to-lombok
作者：Brian Hannaway
译者：Darren Luo
推荐阅读：避免在Java中检查Null语句
上篇好文：Spring Boot实现带STOMP的WebSocket
标签：思考 等价 const 推荐阅读 city tom 功能 http 函数
原文地址：https://blog.51cto.com/14901350/2524997
