## 简介 `Lombok`是一种`Java™`实用工具,可用来帮助开发人员消除 Java 的冗长,尤其是对于简单的 Java 对象(POJO)。它通过注解实现这一目的。 ## 插件安装 * 由于`Lombok`采取注解形式,在编译后,自动生成相应的方法,所以需要下载插件来支持它。 * 以 idea 为例:查找插件`lombok plugin`安装即可。 ## 引入依赖 ``` <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>${lombok.version}</version> <scope>provided</scope> </dependency> ``` ## Lombok注解一览 * @Setter * @Getter * @Data * @Log(这是一个泛型注解,具体有很多种形式) * @AllArgsConstructor * @NoArgsConstructor * @EqualsAndHashCode * @NonNull * @Cleanup * @ToString * @RequiredArgsConstructor * @Value * @SneakyThrows * @Synchronized ## 常用注解介绍 * @Getter和@Setter :该注解可以使用在类上也可以使用在属性上。生成的getter遵循布尔属性的约定。在使用该注解时,会默认生成一个无参构造。和对应的`getter`、`setter`方法 ``` @Getter @Setter public class Notice { private Integer id; private String title; private Boolean isDeleted; } ``` 编译后将会转化为 ``` public class Notice { private Integer id; private String title; private Boolean isDeleted; public Notice() {} public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getTitle() { return title; } public void setTitle(String title) { this.title = title; } public Boolean getDeleted() { return isDeleted; } public void setDeleted(Boolean deleted) { isDeleted = deleted; } } ``` * @ToString :该注解使用在**类**上,编译后toString方法返回将会以字段的名称-值的形式输出 * @EqualsAndHashCode :该注解使用在**类**上,同时生成`equals`和`hashCode`。 * @AllArgsConstructor :该注解使用在**类**上,提供全参数的构造方法,默认不提供无参构造。 * @NoArgsConstructor :该注解使用在**类**上,提供无参构造 * @Data :使用`@Data`注解就可以有下面几个注解的功能:`@ToString`、`@Getter`、`@Setter`、`@EqualsAndHashCode`、`@NoArgsConstructor`。 需要注意的是:同时使用`@Data`和`@AllArgsConstructor`后 ,默认的无参构造函数失效,如果需要它,要重新设置`@NoArgsConstructor` * @Slf4j :在类上注解后,可直接调用log ``` log.info(xxxx); ``` * @Builder:bulder 模式构建对象。 * @Cleanup:自动化关闭流,相当于 `try with resource` ``` @Cleanup InputStream in = new FileInputStream(args[0]); @Cleanup OutputStream out = new FileOutputStream(args[1]); ``` * @NonNull :增加不为空判断 ``` public NonNullExample(@NonNull Person person) { this.name = person.getName(); } ``` 转换为: ``` public NonNullExample(@NonNull Person person) { if (person == null) { throw new NullPointerException("person"); } this.name = person.getName(); } ``` * @SneakyThrows :当我们需要抛出异常,在当前方法上调用,不用显示的在方法名后面写 throw ``` @SneakyThrows(Exception.class) ``` * @Synchronized :方法中所有的代码都加入到一个代码块中,默认静态方法使用的是全局锁,普通方法使用的是对象锁,当然也可以指定锁的对象。 ``` private final Object lock = new Object(); @Synchronized("lock") public void foo() { // Do something } ```