IDEA 2022 之 Lombok 使用 教程

简介: IDEA 2022 之 Lombok 使用 教程

1.Lombok是什么

Lombok是使用java编写的一款开源类库。其主作用是使用注解来代替一些具有格式固定,没有过多技术含量的编码工作。使我们可以仅仅在代码中添加一个注解(annotation),就可以起到和编写一大段代码一样的作用。对于这些格式固定的的代码,IDE也提供了自动生成的功能,但是无论是自动生成还是纯手动写,这些代码在类中是实实在在的存在,有时候,看到一个类文件很长,其中却都是一些,没有任何技术含量的getter和setter方法。无疑会影响我们的代码阅读。而使用Lombok可以将这些“无用”的代码,通过相应的注解替换掉。好了,废话少说,进入主题:

1.上面说的“注解”具体是哪些注解?

2.这些注解又能代替哪些编码工作呢?

3.lombok是如何实现以上功能的呢?

1.1 Lombok 是什么?

官网:https://projectlombok.org/

Lombok 是一个 Java 库,使用 Lombok 可以通过简单的注解帮助我们消除 Java 的样板代码,使代码更加简洁清晰。

比如对于简单的 Java 对象(POJO),很多的代码里充斥着大量的 getter()setter() 方法,样板代码占用比例高,影响可读性,引入 Lombok 只需一个注解就能达到相同效果,而且更简洁。

Lombok 引入

2、POM 中引入依赖

使用 Lombok 注解需要依赖它的库。

Maven 库:https://mvnrepository.com/artifact/org.projectlombok/lombok

<dependency>
  <groupId>org.projectlombok</groupId>
  <artifactId>lombok</artifactId>
  <version>1.18.16</version>
</dependency>

系统中如果有引入无需重复引入。

3、IDE 中安装插件

为什么装插件?

  • 因为 Lombok 的引入后,java 文件使用 javac 编译成的字节码文件中就会包含 getter 和 setter 函数,但是源代码中找不到定义,IDE 会认为这是错误,因此需要安装一个 Lombok 的插件,方便本地 IDE 的研发工作。

IDEA 中安装:

Settings->Plugins->输入框输入”lombok”

4. Lombok 使用

比如要针对以下 Java 对象提供 getter()setter() 方法:

public class Mountain {
    private String name;
    private String country;
}

只需要在类上打 @Getter@Setter 注解。

@Getter
@Setter
public class Mountain {
    private String name;
    private String country;
}

然后用 maven 编译一下:mvn clean compile

使用的时候就可以正常拿到像 getCountry()setCountry() 这样的方法。通过 IDE 找方法调用处也可以直接锁定到字段上,以前要点两下才能看到字段明细信息,使用 Lombok 点一下就能达到效果。

4.1 Lombok 使用注意

  • 不建议直接使用 @Data 这种大而全的方式覆盖太多的简化场景。
  • toString 场景不建议使用 Lombok 的,建议使用系统自定义 ToString 里的方法。
  • 对外包考虑到接入方也需要引入依赖,如果担心副作用,可以不引入。
  • 其他注解酌情使用。

5.代码案例:

常用注解:@Getter/@Setter: 作用类上,生成所有成员变量的getter/setter方法;作用于成员变量上,生成该成员变量的getter/setter方法。可以设定访问权限及是否懒加载等。

package com.libin;
import lombok.AccessLevel;
import lombok.Getter;
import lombok.Setter;
/**
 * Created by  libin
 * DESC: 测试类
 */
@SuppressWarnings("unused")
public class TestClass {
    public static void main(String[] args) {
    }
    @Getter(value = AccessLevel.PUBLIC)
    @Setter(value = AccessLevel.PUBLIC)
    public static class Person {
        private String name;
        private int age;
        private boolean friendly;
    }
    public static class Animal {
        private String name;
        private int age;
        @Getter @Setter private boolean funny;
    }
}

在Structure视图中,可以看到已经生成了getter/setter等方法。

编译后的代码如下:这也是传统Java编程需要编写的样板代码。

//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by Fernflower decompiler)
//
package com.libin;
public class TestClass {
    public TestClass() {
    }
    public static void main(String[] args) {
    }
    public static class Animal {
        private String name;
        private int age;
        private boolean funny;
        public Animal() {
        }
        public boolean isFunny() {
            return this.funny;
        }
        public void setFunny(boolean funny) {
            this.funny = funny;
        }
    }
    public static class Person {
        private String name;
        private int age;
        private boolean friendly;
        public Person() {
        }
        public String getName() {
            return this.name;
        }
        public int getAge() {
            return this.age;
        }
        public boolean isFriendly() {
            return this.friendly;
        }
        public void setName(String name) {
            this.name = name;
        }
        public void setAge(int age) {
            this.age = age;
        }
        public void setFriendly(boolean friendly) {
            this.friendly = friendly;
        }
    }
}

@ToString:作用于类,覆盖默认的toString()方法,可以通过of属性限定显示某些字段,通过exclude属性排除某些字段。

@EqualsAndHashCode:作用于类,覆盖默认的equals和hashCode

@NonNull:主要作用于成员变量和参数中,标识不能为空,否则抛出空指针异常。

@NoArgsConstructor, @RequiredArgsConstructor, @AllArgsConstructor:作用于类上,用于生成构造函数。有staticName、access等属性。

staticName属性一旦设定,将采用静态方法的方式生成实例,access属性可以限定访问权限。

@NoArgsConstructor:生成无参构造器;

@RequiredArgsConstructor:生成包含final和@NonNull注解的成员变量的构造器;

@AllArgsConstructor:生成全参构造器。

编译后结果:

public static class Person {
    @NonNull
    private String name;
    private int age;
    private boolean friendly;
    public String toString() {
        return "TestClass.Person(name=" + this.getName() + ", age=" + this.getAge() + ")";
    }
    @NonNull
    public String getName() {
        return this.name;
    }
    public int getAge() {
        return this.age;
    }
    public boolean isFriendly() {
        return this.friendly;
    }
    public void setName(@NonNull String name) {
        if(name == null) {
            throw new NullPointerException("name");
        } else {
            this.name = name;
        }
    }
    public void setAge(int age) {
        this.age = age;
    }
    public void setFriendly(boolean friendly) {
        this.friendly = friendly;
    }
    private Person() {
    }
    private static TestClass.Person of() {
        return new TestClass.Person();
    }
    @ConstructorProperties({"name"})
    Person(@NonNull String name) {
        if(name == null) {
            throw new NullPointerException("name");
        } else {
            this.name = name;
        }
    }
    @ConstructorProperties({"name", "age", "friendly"})
    public Person(@NonNull String name, int age, boolean friendly) {
        if(name == null) {
            throw new NullPointerException("name");
        } else {
            this.name = name;
            this.age = age;
            this.friendly = friendly;
        }
    }
}

@Data:作用于类上,是以下注解的集合:

@ToString @EqualsAndHashCode @Getter @Setter @RequiredArgsConstructor

@Builder:作用于类上,将类转变为建造者模式

@Log:作用于类上,生成日志变量。针对不同的日志实现产品,有不同的注解:

其他重要注解:

@Cleanup:自动关闭资源,针对实现了java.io.Closeable接口的对象有效,如:典型的IO流对象。

编译后结果如下:

是不是简洁了太多。

@SneakyThrows:可以对受检异常进行捕捉并抛出,可以改写上述的main方法如下。

@Synchronized:作用于方法级别,可以替换synchronize关键字或lock锁,用处不大。

Lombok 原理

自 JDK6 之后,javac 在执行的时候会调用实现了 JSR 269 API 的程序,这样我们就可以对编译器做一些增强,这时 javac 执行的过程如下:

Lombok 本质上就是一个实现了“JSR 269 API”的程序。在使用 javac 的过程中,它产生作用的具体流程如下:

  1. javac 对源代码进行分析,生成一棵抽象语法树(AST)
  2. 运行过程中调用实现了“JSR 269 API”的 Lombok 程序
  3. Lombok 对第一步骤得到的 AST 进行处理,找到 @Getter @Setter 注解所在类对应的语法树(AST)
  4. Lombok 修改该语法树(AST),增加 getter()setter() 方法定义的相应树节点
  5. javac 使用修改后的抽象语法树(AST)生成字节码文件,即给 class 增加新的节点(代码块)

6. 常用注解

@Data :相当于@Setter + Getter + @ToString + @EqualsAndHashCode

@NoArgsConstructor:自动生成无参数构造函数。

@AllArgsConstructor:自动生成全参数构造函数。

三个常用注解~~~~

结语

如果这篇文章对您有所帮助,或者有所启发的话,求一键三连:点赞、评论、收藏➕关注,您的支持是我坚持写作最大的动力。


目录
相关文章
|
6月前
|
Java 开发工具 Maven
IntelliJ IDEA安装教程(超详细)
IntelliJ IDEA安装教程(超详细)
298 1
|
6月前
|
IDE Java 数据库连接
IntelliJ IDEA安装使用教程——社区免费版——附中文插件安装
IntelliJ IDEA安装使用教程——社区免费版——附中文插件安装
1067 0
|
1月前
|
IDE Java 程序员
学生邮箱白嫖/免费安装JetBrains全家桶(IDEA/pycharm等) —— 保姆级教程
本文提供了如何使用学生邮箱免费获取并安装JetBrains全家桶(包括IDEA、PyCharm等)的详细教程,涵盖了学生认证、软件下载、安装及常见问题的解决方法。
408 0
学生邮箱白嫖/免费安装JetBrains全家桶(IDEA/pycharm等) —— 保姆级教程
|
3月前
|
Java Maven
2022最新版超详细的Maven下载配置教程、IDEA中集成maven(包含图解过程)、以及导入项目时jar包下载不成功的问题解决
这篇文章是一份关于Maven的安装和配置指南,包括下载、环境变量设置、配置文件修改、IDEA集成Maven以及解决jar包下载问题的方法。
2022最新版超详细的Maven下载配置教程、IDEA中集成maven(包含图解过程)、以及导入项目时jar包下载不成功的问题解决
|
4天前
|
Java Windows
IDEA不使用lombok,如何快速生成get和set方法
【11月更文挑战第10天】在 IntelliJ IDEA 中生成 `get` 和 `set` 方法有多种方式:通过菜单操作、使用快捷键或自定义模板。菜单操作包括选择“Code”菜单中的“Generate...”,快捷键为“Alt + Insert”。自定义模板可在“File”-&gt;“Settings”-&gt;“Editor”-&gt;“Code Style”-&gt;“Java”中设置。批量生成时,可多选变量一次性生成。
|
1月前
|
Java
IDEA的fxml打开Scene Builder后空白! Scene Builder下载依赖后还是空白不显示 无论如何都不显示,网上的教程试过来了遍还是不显示
本文提供了三种方法来解决IDEA中fxml文件在Scene Builder中打开后显示空白的问题:检查JavaFX是否安装、切换IDEA版本、下载Scene Builder插件。
163 1
|
1月前
|
Oracle IDE Java
IDEA安装教程配置java环境(超详细)
IDEA安装教程配置java环境(超详细)
|
3月前
|
前端开发 Java Maven
【前端学java】全网最详细的maven安装与IDEA集成教程!
【8月更文挑战第12天】全网最详细的maven安装与IDEA集成教程!
98 2
【前端学java】全网最详细的maven安装与IDEA集成教程!
|
6月前
|
Java Maven Spring
【操作宝典】IntelliJ IDEA新建maven项目详细教程
【操作宝典】IntelliJ IDEA新建maven项目详细教程
292 1
|
3月前
IntelliJ IDEA lombok log 报红
IntelliJ IDEA lombok log 报红
37 0