eclipse,idea安装lombok,以及lombok的使用

柔情只为你懂 2022-06-02 02:09 302阅读 0赞

Lombok是一种Java实用工具，可以帮助开发人员消除Java的冗长，具体看lombok的官网：http://projectlombok.org/

安装步骤：

1.下载lombok.jar包

2.将lombok.jar包复制到myeclipse.ini/eclipse.ini所在文件目录

3.打开myeclipse.ini/eclipse.ini，在最后添加以下代码并保存：

-javaagent:lombok.jar

4.重启myeclipse/eclipse.

5.project==>clean 清理项目

# Lombok使用 #

## 介绍 ##

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

## IDEA中的安装 ##

打开IDEA的Setting –> 选择Plugins选项 –> 选择Browse repositories –> 搜索lombok –> 点击安装 –> 安装完成重启IDEA –> 安装成功

![idea安装Lombok][idea_Lombok]

## 引入依赖 ##

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

<dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.16.18</version>
        <scope>provided</scope>
    </dependency>

## 使用 ##

在对应的类或者方法上使用对应注解即可。例如：   
![示例][getImage_fileId_5a542b603d0e5c5182000001]

## 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官方介绍][Log]

### @Getter和@Setter ###

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

在使用该注解时，会默认生成一个无参构造。和对应的getterhe setter方法   
![示例][getImage_fileId_5a54370fab644126e2000c49]

该注解也可以使用在单个属性上，会默认生成一个无参构造：   
![示例][getImage_fileId_5a54370fab644126e2000c48]

### @Data ###

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

![示例][getImage_fileId_5a54370fab644126e2000c43]

### @NonNull ###

该注解使用在**属性**上，该注解用于属的非空检查，当放在setter方法的字段上，将生成一个空检查，如果为空，则抛出`NullPointerException`。   
该注解会默认是生成一个无参构造。   
![示例][getImage_fileId_5a54370fab644126e2000c47]

### @toString ###

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

*  includeFieldNames是否包含属性名称：   
    ![示例][getImage_fileId_5a54370fab644126e2000c42]
 *  exclude 排除指定字段   
    ![示例][getImage_fileId_5a54370fab644126e2000c45]
 *  callSuper输出父类属性   
    ![示例][getImage_fileId_5a543c1aab644126e2000d38]

注意：父类也要有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 ###

该注解使用在**类**上，该注解在类级别注释会同时生成`equals`和`hashCode`。   
注意继承关系的时候该注解的使用。详细介绍参照[官方介绍][Link 1]   
![示例][getImage_fileId_5a543f5dab644126e2000d85]  
存在继承关系需要设置`callSuper`参数为`true`。

### @Data ###

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

虽然`@Data`注解非常有用，但是它没有与其他注解相同的控制粒度。`@Data`提供了一个可以生成静态工厂的单一参数，将`staticConstructor`参数设置为所需要的名称，Lombok自动生成的构造函数设置为私有，并提供公开的给定名称的静态工厂方法。   
![示例][getImage_fileId_5a546265ab644126e2001263]

### @AllArgsConstructor ###

该注解使用在**类**上，该注解提供一个全参数的构造方法，默认不提供无参构造。   
![示例][getImage_fileId_5a546265ab644126e2001260]

### @NoArgsConstructor ###

该注解使用在**类**上，该注解提供一个无参构造   
![示例][getImage_fileId_5a546266ab644126e2001264]

### @RequiredArgsConstructor ###

该注解使用在**类**上，使用类中所有带有 @NonNull 注解的或者带有 final 修饰的成员变量生成对应的构造方法。   
![实例][getImage_fileId_5a546265ab644126e200125f]

### @Value ###

这个注解用在 类 上，会生成含所有参数的构造方法，get 方法，此外还提供了equals、hashCode、toString 方法。   
**注意：没有setter**   
![示例][getImage_fileId_5a546265ab644126e2001261]

### @Cleanup ###

该注解使用在**属性**前，该注解是用来保证分配的资源被释放。在本地变量上使用该注解，任何后续代码都将封装在try/finally中，确保当前作用于中的资源被释放。默认`@Cleanup`清理的方法为`close`，可以使用value指定不同的方法名称。   
![示例][getImage_fileId_5a546266ab644126e2001266]

### @Synchronized ###

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

### @SneakyThrows ###

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

## 结语 ##

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

[idea_Lombok]: /images/20220602/9d95c83d63d742b894c31ef4551fd014.png
[Maven]: http://mvnrepository.com/
[getImage_fileId_5a542b603d0e5c5182000001]: /images/20220602/e8b95a6ebdcc4cb2ab5204fe588bfbe9.png
[Log]: https://projectlombok.org/features/log
[getImage_fileId_5a54370fab644126e2000c49]: /images/20220602/7d4cb0de2b7f4225bed0f9db7137eb9b.png
[getImage_fileId_5a54370fab644126e2000c48]: /images/20220602/7b45059a30d04c65be5f35f3470bb583.png
[getImage_fileId_5a54370fab644126e2000c43]: /images/20220602/e7877314e4a04a30a6432ab334d8bdbf.png
[getImage_fileId_5a54370fab644126e2000c47]: /images/20220602/422755bd339d4d0096d91067262bb441.png
[getImage_fileId_5a54370fab644126e2000c42]: /images/20220602/25331852eb484cc7a95dca36d154da3f.png
[getImage_fileId_5a54370fab644126e2000c45]: /images/20220602/22daaa4cc74d4dc3b0a7fd9d838e2c2e.png
[getImage_fileId_5a543c1aab644126e2000d38]: /images/20220602/591c1f434cc94bdf936b05e01fdfa26d.png
[Link 1]: http://jnb.ociweb.com/jnb/jnbJan2010.html
[getImage_fileId_5a543f5dab644126e2000d85]: /images/20220602/918f436d2a38446087e58a5bae75e5c3.png
[getImage_fileId_5a546265ab644126e2001263]: /images/20220602/f837ad4724e049289f043728aa98489f.png
[getImage_fileId_5a546265ab644126e2001260]: /images/20220602/0cf04396381948d8a9ae5d0e46b381db.png
[getImage_fileId_5a546266ab644126e2001264]: /images/20220602/91ced92ab77a491eaecbbe29ebbe4c68.png
[getImage_fileId_5a546265ab644126e200125f]: /images/20220602/01b53bf4a2be40a8b659e5902d21e297.png
[getImage_fileId_5a546265ab644126e2001261]: /images/20220602/2b238ba0b81a4ca58232082bd3832492.png
[getImage_fileId_5a546266ab644126e2001266]: /images/20220602/81b0d87665434e4bbea5112261353b02.png
[getImage_fileId_5a546265ab644126e2001262]: /images/20220602/c0400df37ddc485bb6a5c9ccd761567d.png
[Link 2]: https://projectlombok.org/features/SneakyThrows
[getImage_fileId_5a546266ab644126e2001265]: /images/20220602/5cfefcc9473140f88460f372b678acdb.png