Lombok 介绍和使用详情

介绍

在项目中使用Lombok可以减少很多重复代码的书写。比如说getter/setter/toString等方法的编写。

IDEA中的安装

打开IDEA的Setting –> 选择Plugins选项 –> 选择Browse repositories –> 搜索lombok –> 点击安装 –> 安装完成重启IDEA –> 安装成功
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-8Wxu6puV-1626182323785)(http://1.file.leanote.top/5a54370fab644126e2000c44/1515465239279_2.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:ECrRjWgXnbUD3XO3DQfOybg-xPc)]

引入依赖

在项目中添加Lombok依赖jar,在pom文件中添加如下部分。(不清楚版本可以在Maven仓库中搜索)

<!-- https://mvnrepository.com/artifact/org.projectlombok/lombok -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.16.18</version>
    <scope>provided</scope>
</dependency>

使用

在对应的类或者方法上使用对应注解即可。

Lombok有哪些注解

  • @Setter
  • @Getter
  • @Data
  • @Log(这是一个泛型注解,具体有很多种形式)
  • @AllArgsConstructor
  • @NoArgsConstructor
  • @EqualsAndHashCode
  • @NonNull
  • @Cleanup
  • @ToString
  • @RequiredArgsConstructor
  • @Value
  • @SneakyThrows
  • @Synchronized

注解详情

log

注解在 上。有如下可选择可用:

//@CommonsLog
private static final org.apache.commons.logging.Log log = org.apache.commons.logging.LogFactory.getLog(LogExample.class);
//@JBossLog
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);

默认情况下,记录器的主题(或名称)将是使用注释进行@Log注释的类的类名称。这可以通过指定topic参数来定制。例如:@XSlf4j(topic="reporting")

该类型注解可以满足不同的日志系统的日志使用,Lombok提供了一些自定义配置项可以参看官方说明文档。

Log官方介绍

@Getter和@Setter

该注解使用在类或者属性上,该注解可以使用在类上也可以使用在属性上。生成的getter遵循布尔属性的约定。例如:boolean类型的sex,getter方法为isSex而不是getSex

在使用该注解时,会默认生成一个无参构造。和对应的getterhe setter方法
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-1XlicXQE-1626182323786)(http://1.file.leanote.top/5a54370fab644126e2000c49/1515466096955_4.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:_z0z0eT_f5KIjw8coUCwgOPBiy8)]

该注解也可以使用在单个属性上,会默认生成一个无参构造:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-T7eXqMiW-1626182323787)(http://1.file.leanote.top/5a54370fab644126e2000c48/1515466294316_5.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:vRO2cgQmWTXc6JehUN8H8foZDoM)]

@Data

该注解使用在类上,该注解会提供getter、setter、equals、canEqual、hashCode、toString方法。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kZ3TLKRn-1626182323787)(http://1.file.leanote.top/5a54370fab644126e2000c43/1515466806437_6.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:K2BqAPlrfIj6nk1VyDkxv30ldfk)]

@NonNull

该注解使用在属性上,该注解用于属的非空检查,当放在setter方法的字段上,将生成一个空检查,如果为空,则抛出NullPointerException
该注解会默认是生成一个无参构造。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-KedikOaL-1626182323789)(http://1.file.leanote.top/5a54370fab644126e2000c47/1515467159376_7.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:0XIqPQzaJbSu9J-y51X_-lbXDDE)]

@toString

该注解使用在类上,该注解默认生成任何非讲台字段以名称-值的形式输出。
1、如果需要可以通过注释参数includeFieldNames来控制输出中是否包含的属性名称。
2、可以通过exclude参数中包含字段名称,可以从生成的方法中排除特定字段。
3、可以通过callSuper参数控制父类的输出。

  • includeFieldNames是否包含属性名称:
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-itT8rOPV-1626182323790)(http://1.file.leanote.top/5a54370fab644126e2000c42/1515467459770_8.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:KJKqvKXu0OldtrJUPekOe3S9ntI)]

  • exclude 排除指定字段
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-6obeCfoR-1626182323791)(http://1.file.leanote.top/5a54370fab644126e2000c45/1515468047413_9.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:zsKgxa2gTCpElZSWULvxn0aUef0)]

  • callSuper输出父类属性
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-OSZU4xTp-1626182323792)(http://1.file.leanote.top/5a543c1aab644126e2000d38/1515469434112_10.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:IqeKwFLMTuPPMpTtjedZLc6ddgE)]

注意:父类也要有toString方法,不然打印的是对象内存地址

//父类无toString方法
Person(super=com.motui.Person@3abfe836, firstName=motui, address=北京, dateOfBirth=Tue Jan 09 11:49:05 CST 2018, sex=true)
//父类有toString方法
Person(super=People(id=111), firstName=motui, address=北京, dateOfBirth=Tue Jan 09 11:50:11 CST 2018, sex=true)
@EqualsAndHashCode

该注解使用在上,该注解在类级别注释会同时生成equalshashCode
注意继承关系的时候该注解的使用。详细介绍参照官方介绍
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fRuCmuQ1-1626182323792)(http://1.file.leanote.top/5a543f5dab644126e2000d85/1515470235374_11.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:sjZmfKM8d3vCdzGvL5KwQeOzYP0)]

存在继承关系需要设置callSuper参数为true。

@Data

该注解使用在类上,该注解是最常用的注解,它结合了@ToString,@EqualsAndHashCode, @Getter和@Setter。本质上使用@Data注解,类默认@ToString@EqualsAndHashCode以及每个字段都有@Setter@getter。该注解也会生成一个公共构造函数,可以将任何@NonNullfinal字段作为参数。

虽然@Data注解非常有用,但是它没有与其他注解相同的控制粒度。@Data提供了一个可以生成静态工厂的单一参数,将staticConstructor参数设置为所需要的名称,Lombok自动生成的构造函数设置为私有,并提供公开的给定名称的静态工厂方法。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-wG4cFd7M-1626182323793)(http://1.file.leanote.top/5a546265ab644126e2001263/1515476412751_12.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:qp8aGxlfa2DcAnWco2d57bk2C-w)]

@AllArgsConstructor

该注解使用在上,该注解提供一个全参数的构造方法,默认不提供无参构造。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-vRhg5MFG-1626182323794)(http://1.file.leanote.top/5a546265ab644126e2001260/1515478142533_16.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:UO-4ANEldw7j5lZuR66tEWy-4io)]

@NoArgsConstructor

该注解使用在上,该注解提供一个无参构造
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-774Dk3A0-1626182323794)(http://1.file.leanote.top/5a546266ab644126e2001264/1515478200493_17.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:ng0PugDk_lmiDlCNC1IIrrMxZ3U)]

@RequiredArgsConstructor

该注解使用在上,使用类中所有带有 @NonNull 注解的或者带有 final 修饰的成员变量生成对应的构造方法。

@Value

这个注解用在 类 上,会生成含所有参数的构造方法,get 方法,此外还提供了equals、hashCode、toString 方法。
注意:没有setter

@Cleanup

该注解使用在属性前,该注解是用来保证分配的资源被释放。在本地变量上使用该注解,任何后续代码都将封装在try/finally中,确保当前作用于中的资源被释放。默认@Cleanup清理的方法为close,可以使用value指定不同的方法名称。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-nZQZAVZR-1626182323795)(http://1.file.leanote.top/5a546266ab644126e2001266/1515476968925_13.png?e=1531792696&token=ym9ZIrtxjozPN4G9he3-FHPOPxAe-OQmxzol5EOk:Fvl9zn1Xyw34UHGa3aatB03-pDs)]

@Synchronized

该注解使用在类或者实例方法上,Synchronized在一个方法上,使用关键字可能会导致结果和想要的结果不同,因为多线程情况下会出现异常情况。Synchronized
关键字将在this示例方法情况下锁定当前对象,或者class讲台方法的对象上多锁定。这可能会导致死锁现象。一般情况下建议锁定一个专门用于此目的的独立锁,而不是允许公共对象进行锁定。该注解也是为了达到该目的。

@SneakyThrows

该注解使用在方法上,这个注解用在 方法 上,可以将方法中的代码用 try-catch 语句包裹起来,捕获异常并在 catch 中用 Lombok.sneakyThrow(e) 把异常抛出,可以使用 @SneakyThrows(Exception.class) 的形式指定抛出哪种异常。该注解需要谨慎使用。详情参看官方介绍

结语

Lombok的目的是减少代码的重复编写,并提供比较好的解决方案。当然也存在一些争议性的注解,可以根据实际场景进项使用。Lombok有一些实验注解可以在官网查看。

出处:https://blog.csdn.net/motui/article/details/79012846

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值