AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

lombok系列2：lombok注解详解

2017-05-22 2155
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
本文涉及的产品
日志服务 SLS，月写入数据量 50GB 1个月
简介： 开篇看到第一篇《初识lombok》你可能意犹未尽，本文我们按照场景来介绍一下常用的注解。未特别说明，均标注在类级别。

开篇

看到第一篇《初识lombok》你可能意犹未尽，本文我们按照场景来介绍一下常用的注解。

未特别说明，均标注在类级别。

lombok.Data

最常用的注解，编译时自动添加Setter、Getter、toString（）、equals()和hashCode()。

package com.pollyduan;

import java.util.Date;

import lombok.Data;

@Data
public class User {
    private Integer id;
    private String userName;
    private String password;
    private String email;
    private Integer age;
    private Date signupTime;
    public static void main(String[] args) {
           User user=new User();
           user.setId(1001);
           user.setUserName("pollyduan");
           user.setPassword("123456");
           user.setEmail("pollyduan@pollyduan.com");
           user.setAge(30);
           user.setSignupTime(new Date());
           System.out.println(user);
       System.out.println(user.getUserName());
       System.out.println(user.hashCode());
        }
}

使用场景：

POJO类、hibernate的实体类、json或jaxb的实体类。

lombok.Value

如果我们需要一个不可变的对象类，那么就用该注解。它在编译是自动添加Getter、toString()、equals()、hashCode()以及一个全参的构造器。

注：没有无参构造器。如果需要，自己添加一个，或者增加一个后面介绍的lombok.NoArgsConstructor注解。

package com.pollyduan;

import java.util.Date;

import lombok.Value;

@Value
public class User {
    private Integer id;
    private String userName;
    private String password;
    private String email;
    private Integer age;
    private Date signupTime;

    public static void main(String[] args) {
        /*
         * User user=new User();//The constructor User() is undefined
         * user.setId(1001);//The method setId(int) is undefined for the type
         * User
         */
        User user = new User(1001, "pollyduan", "123456", "pollyduan@pollyduan.com", 30, new Date());
        System.out.println(user);
        System.out.println(user.getUserName());
        System.out.println(user.hashCode());
    }
}

如果自定义了自动生成的方法，以自己定义的为准。

lombok.Builder

它把我们的Bean类包装为一个构建者模式，编译时增加了一个Builder内部类和全字段的构造器。

注：没有Getter、Setter、toString()。如需其他方法，可以自己实现或者配合其他注解。

package com.pollyduan;

import java.util.Date;

import lombok.Builder;
import lombok.Data;

@Builder
public class User {
    private Integer id;
    private String userName;
    private String password;
    private String email;
    private Integer age;
    private Date signupTime;

    public static void main(String[] args) {
        /*
         * User user=new User();//The constructor User() is undefined
         */
        User user = new User(1001, "pollyduan", "123456", "pollyduan@pollyduan.com", 30, new Date());
        //或者
        user=User.builder()
                .age(30)
                .userName("pollyduan")
                .build();
        System.out.println(user);
    }
}

构造器注解

提供了三个构造器注解，分别为:

lombok.AllArgsConstructor 增加全参构造器
lombok.NoArgsConstructor 增加无参构造
lombok.RequiredArgsConstructor 增加必选参数构造器

该注解可同时标注，以增加不同的构造器。

可以使用access属性定制访问级别，如:”access = AccessLevel.PROTECTED”

前两个比较简单，必选参数构造器需要配合 lombok.NonNull 注解使用，只有标记了 NonNull 注解的字段才会被纳入 RequiredArgsConstructor 构造器中。

package com.pollyduan;

import java.util.Date;

import lombok.NonNull;
import lombok.RequiredArgsConstructor;

@RequiredArgsConstructor
public class User {
    @NonNull
    private Integer id;
    @NonNull
    private String userName;
    @NonNull
    private String password;
    private String email;
    private Integer age;
    private Date signupTime;

    public static void main(String[] args) {
        /*
         * User user=new User();
         * User user = new User(1001, "pollyduan", "123456", "pollyduan@pollyduan.com", 30, new Date());
         * //The constructor User() is undefined
         */
        User user=new User(1001, "pollyduan", "123456");//ok
        System.out.println(user);
    }
}

定制单个方法

lombok.ToString 这个简单，就是增加toString()方法。

类似的还有：

lombok.EqualsAndHashCode 增加equals() 和 hashCode（）。

lombok.Getter 增加Getter方法

lombok.Setter 增加Setter方法

lombok.Cleanup

该注解的对象，如Stream对象，如果有close()方法，那么在该对象作用域离开时会自动关闭。

package com.pollyduan;

import lombok.Cleanup;

public class MyStream {
    public void close() {
        System.out.println("close.");
    }

    public static void main(String[] args) {
        System.out.println("new a mystream object.");
        @Cleanup
        MyStream ms=new MyStream();
        System.out.println("bye.");
    //退出前会自动调用close()
    }
}

执行后输出：

new a mystream object.
bye.
close.

日志相关注解

lombok提供了一组日志相关注解，标注的类会隐式的定一个了一个名为log的日志对象。如：

package com.pollyduan;

import lombok.extern.java.Log;

@Log
public class User {
    public static void main(String[] args) {
        System.out.println(log.getClass());
    log.info("app log.");
    }
}

输出：

class java.util.logging.Logger
五月 19, 2017 1:32:58 下午 com.pollyduan.User main
信息: app log.

该组注解包括：

@CommonsLog
    Creates private static final org.apache.commons.logging.Log log = org.apache.commons.logging.LogFactory.getLog(LogExample.class);

@JBossLog
    Creates private static final org.jboss.logging.Logger log = org.jboss.logging.Logger.getLogger(LogExample.class);

@Log
    Creates private static final java.util.logging.Logger log = java.util.logging.Logger.getLogger(LogExample.class.getName());

@Log4j
    Creates private static final org.apache.log4j.Logger log = org.apache.log4j.Logger.getLogger(LogExample.class);

@Log4j2
    Creates private static final org.apache.logging.log4j.Logger log = org.apache.logging.log4j.LogManager.getLogger(LogExample.class);

@Slf4j
    Creates private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(LogExample.class);

@XSlf4j
    Creates private static final org.slf4j.ext.XLogger log = org.slf4j.ext.XLoggerFactory.getXLogger(LogExample.class);

注：常用的日志处理器都在，一般我们使用log4j或slf4j。

没有logback，请使用slf4j代理logback。

Getter(lazy=true) 懒加载

如果Bean的一个字段的初始化是代价比较高的操作，比如加载大量的数据；同时这个字段并不是必定使用的。那么使用懒加载机制，可以保证节省资源。

懒加载机制，是对象初始化时，该字段并不会真正的初始化；而是第一次访问该字段时才进行初始化字段的操作。

一言不合贴代码：

package com.pollyduan;

import lombok.Data;
import lombok.Getter;

@Data
public class GetterLazyExample {
    @Getter(lazy = true)
    private final int[] cached = expensive();
    private Integer id;

    private int[] expensive() {
        int[] result = new int[100];
        for (int i = 0; i < result.length; i++) {
            result[i] = i;
            System.out.println(i);
        }
        System.out.println("cached 初始化完成。");
        return result;
    }
    public static void main(String[] args) {
        GetterLazyExample obj=new GetterLazyExample();
        obj.setId(1001);
        System.out.println("打印id："+obj.getId());
        System.out.println("cached 还没有初始化哟。");
        // obj.getCached();
    }
}

运行就会发现，cached这个字段并没有初始化，虽然看起来它是final的，并直接赋值使用expensive()进行初始化。

打印id：1001
cached 还没有初始化哟。

打开obj.getCached();的注释，获取这个字段的值，你就会发现它真的初始化了。

打印id：1001
cached 还没有初始化哟。
0
1
...
97
98
99
cached 初始化完成。

Synchronized

同步方法注解。添加了该注解的方法，其方法体都会自动包含在一个synchronize块中。如：

package com.pollyduan;

import java.util.concurrent.BlockingQueue;

import lombok.AllArgsConstructor;
import lombok.Synchronized;

@AllArgsConstructor
public class SynchronizedExample {
    private BlockingQueue<String> queue;

    @Synchronized("queue")
    public void sync1() throws Exception {
        System.out.println("sync1.");
    }

    @Synchronized("queue")
    public void sync2() throws Exception {
        System.out.println("sync2.");
    }

    @Synchronized
    public void sync3() throws Exception {
        System.out.println("sync3.");
    }
}

如果直接指定了value=queue，其中queue为类的一个成员，那么该方法使用该成员queue作为加锁对象，放在同步块中执行。那么本例中，sync1和sync2是互斥的，sync1没有执行完之前，sync2会被挂起，等待sync1执行完成之后才可以执行。

sync3，没有指定注解属性，这时lombok会自动创建一个对象作为锁，这样的结果是sync3自身互斥，多线程中两个线程不能同时执行sync3方法。

sync3等同于：

private final Object $lock = new Object[0];//lombok添加的
public void sync3() throws Exception {
    synchronized($lock){
        System.out.println("sync3.");
    }
}

注：因为sync3与sync1使用的不是同一个锁，那么他们没有互斥关系，sync2也一样。

一定要理清楚锁的关系，否则不要轻易使用该注解。

SneakyThrows 隐藏异常

自动捕获检查异常。

我们知道，java对于检查异常，需要在编码时进行捕获，或者throws抛出。

该注解的作用是将检查异常包装为运行时异常，那么编码时就无需处理异常了。

提示：不过这并不是友好的编码方式，因为你编写的api的使用者，不能显式的获知需要处理检查异常。

package com.pollyduan;

import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.UnsupportedEncodingException;

import lombok.SneakyThrows;

public class SneakyThrowsExample {
    @SneakyThrows({UnsupportedEncodingException.class})
    public void test(byte[] bytes) {
        String str = new String(bytes, "UTF8");
    }
    @SneakyThrows({UnsupportedEncodingException.class,FileNotFoundException.class})
    public void test2(byte[] bytes) {
        FileInputStream file=new FileInputStream("no_texists.txt");
        String str=new String(bytes, "UTF8");
    }
    @SneakyThrows
    public void test3(byte[] bytes) {
        FileInputStream file=new FileInputStream("no_texists.txt");
        String str=new String(bytes, "UTF8");
    }

}

注解接受一个class数组的value属性，如果未指定value属性，默认捕获所有异常。

以上代码相当于：

package com.pollyduan;

import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.UnsupportedEncodingException;

import lombok.SneakyThrows;

public class SneakyThrowsExample {
    public void test(byte[] bytes) {
        try {
            String str = new String(bytes, "UTF8");
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
    }
    public void test2(byte[] bytes) {
        try {
            FileInputStream file=new FileInputStream("no_texists.txt");
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        }
        try {
            String str=new String(bytes, "UTF8");
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
    }
    public void test3(byte[] bytes) {
        try {
            FileInputStream file=new FileInputStream("no_texists.txt");
            String str=new String(bytes, "UTF8");
        } catch (Throwable e) {
            e.printStackTrace();
        }
    }

}

注：个人建议，了解即可，非必要不要使用。隐藏了异常细节，你的使用者会骂死你。

辅助注解

lombok.NonNull

前面已经使用过了，标记在字段上，表示非空字段。

也可以标注在方法参数上，会在第一次使用该参数是判断是否为空。

官方文档：https://projectlombok.org/features/index.html

文章标签：
日志服务
Java
关键词：
lombok Java
lombok注解Java
相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
pollyduan
目录
相关文章
m1a6
|
28天前
|
XML Java 编译器
Java学习十六—掌握注解：让编程更简单
Java 注解（Annotation）是一种特殊的语法结构，可以在代码中嵌入元数据。它们不直接影响代码的运行，但可以通过工具和框架提供额外的信息，帮助在编译、部署或运行时进行处理。
m1a6
86 43
Java学习十六—掌握注解：让编程更简单
进步`于辰
|
22天前
|
Java 开发者 Spring
[Java]自定义注解
本文介绍了Java中的四个元注解（@Target、@Retention、@Documented、@Inherited）及其使用方法，并详细讲解了自定义注解的定义和使用细节。文章还提到了Spring框架中的@AliasFor注解，通过示例帮助读者更好地理解和应用这些注解。文中强调了注解的生命周期、继承性和文档化特性，适合初学者和进阶开发者参考。
进步`于辰
43 14
进步`于辰
|
22天前
|
前端开发 Java
[Java]讲解@CallerSensitive注解
本文介绍了 `@CallerSensitive` 注解及其作用，通过 `Reflection.getCallerClass()` 方法返回调用方的 Class 对象。文章还详细解释了如何通过配置 VM Options 使自定义类被启动类加载器加载，以识别该注解。涉及的 VM Options 包括 `-Xbootclasspath`、`-Xbootclasspath/a` 和 `-Xbootclasspath/p`。最后，推荐了几篇关于 ClassLoader 的详细文章，供读者进一步学习。
进步`于辰
29 12
杀死一只知更鸟debug
|
2月前
|
Java
lombok的使用
本文介绍了Lombok库的基本使用方法和常用注解，通过示例代码展示了如何使用Lombok简化Java对象的创建、属性访问、日志记录等编码工作，使代码更加简洁。
杀死一只知更鸟debug
28 1
lombok的使用
兴化
|
16天前
|
Java 编译器
Java进阶之标准注解
Java进阶之标准注解
兴化
28 0
dream_ready
|
1月前
|
JSON Java 数据库
java 常用注解大全、注解笔记
关于Java常用注解的大全和笔记，涵盖了实体类、JSON处理、HTTP请求映射等多个方面的注解使用。
dream_ready
35 0
java 常用注解大全、注解笔记
LKIDTI数据
|
1月前
|
IDE Java 编译器
java的反射与注解
java的反射与注解
LKIDTI数据
16 0
杀死一只知更鸟debug
|
2月前
|
Java 编译器 程序员
Java注解，元注解，自定义注解的使用
本文讲解了Java中注解的概念和作用，包括基本注解的用法（@Override, @Deprecated, @SuppressWarnings, @SafeVarargs, @FunctionalInterface），Java提供的元注解（@Retention, @Target, @Documented, @Inherited），以及如何自定义注解并通过反射获取注解信息。
杀死一只知更鸟debug
34 0
Java注解，元注解，自定义注解的使用
小王老师呀
|
2月前
|
IDE Java 编译器
lombok编译遇到“找不到符号的问题”
【9月更文挑战第18天】当使用 Lombok 遇到 “找不到符号” 的问题时，可能是由于 Lombok 未正确安装、编译器不支持、IDE 配置不当或项目构建工具配置错误。解决方法包括确认 Lombok 安装、编译器支持，配置 IDE 和检查构建工具配置。通过这些步骤通常可解决问题，若问题仍存在，建议检查项目配置和依赖，或查看日志获取更多信息。
小王老师呀
634 2
木子0204
|
1月前
|
XML Java 数据格式
Java-spring注解的作用
Java-spring注解的作用
木子0204
23 0

热门文章

最新文章

  • 1
    Java 生成 UUID
  • 2
    报错：java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver at java.base/jdk.internal.loader.Bui
  • 3
    Java - StringUtils 之 Equals
  • 4
    JAVA虚拟机关闭钩子(Shutdown Hook)
  • 5
    Java项目导出源代码jar包在Eclipse中查看中文注释乱码的问题
  • 6
    【报错】java -jar 命令启动后中文乱码
  • 7
    （JAVA编程练习）：判断101-200之间有多少个素数，并输出所有素数。
  • 8
    Java -- JDBC 学习--通过 ResultSet 执行查询操作
  • 9
    JDK6笔记（5）----JDBC4
  • 10
    How to programmatically new a java class which implements sepecified interface in eclipse plugin development
  • 1
    Dubbo03【管理控制台和监控中心搭建】，Java开发实用必备的几款插件
    56
  • 2
    Java中int[]与Integer[]相互转化的方法，java基础知识面试重点总结
    35
  • 3
    Java 并发编程中的锁优化策略
    34
  • 4
    Java一分钟之-设计模式：装饰器模式与代理模式
    63
  • 5
    《手把手教你》系列技巧篇（四十六）-java+ selenium自动化测试-web页面定位toast-下篇（详解教程）
    64
  • 6
    刷题两个月，从入门到字节跳动offer丨GitHub标星16k+，美团Java面试题
    65
  • 7
    《MySQL 入门教程》第 05 篇 账户和权限，Java高并发编程详解深入理解pdf
    53
  • 8
    Java的前景如何，好不好自学？，万字Java技术类校招面试题汇总
    54
  • 9
    es集群安装，邮储银行java面试
    79
  • 10
    数据结构~缓存淘汰算法--LRU算法（Java的俩种实现方式，万字解析
    98

    • 相关课程

    更多
  • Java面试疑难点解析 - 面试技巧及语言基础
  • Java面试疑难点解析 - Java Web开发
  • Java面试疑难点解析 - 系统架构及项目设计
  • Java编程入门
  • Java面向对象编程
  • Java高级编程

    • 相关电子书

    更多
  • Spring Cloud Alibaba - 重新定义 Java Cloud-Native
  • The Reactive Cloud Native Arch
  • JAVA开发手册1.5.0

    • 相关实验场景

    更多
  • 基于ECS搭建Java Web开发环境
  • 使用Aliyun Java Intializr进行项目开发
  • 搭建Java Web开发环境
  • 部署基于Dragonwell的Java运行环境
  • 阿里云平台上进行Java程序的编译与运行
  • RocketMQ中使用Java客户端发送消息和消费的应用
    • 下一篇
    阿里云OSS设置跨域访问