Lombok 使用教程-@Accessors | 自定义getters和setters的生成格式

最新推荐文章于 2024-08-18 14:34:43 发布

smart哥

最新推荐文章于 2024-08-18 14:34:43 发布

阅读量1.1k

点赞数 28

分类专栏： Lombok专题文章标签： Lombok

本文链接：https://blog.csdn.net/smart_an/article/details/141150987

版权

Lombok专题专栏收录该内容

23 篇文章 0 订阅

订阅专栏

作者简介：大家好，我是smart哥，前中兴通讯、美团架构师，现某互联网公司CTO

联系qq：184480602，加我进群，大家一起学习，一起进步，一起对抗互联网寒冬

学习必须往深处挖，挖的越深，基础越扎实！

阶段1、深入多线程

 阶段2、深入多线程设计模式

 阶段3、深入juc源码解析

阶段4、深入jdk其余源码解析

阶段5、深入jvm源码解析

码哥源码部分

码哥讲源码-原理源码篇【2024年最新大厂关于线程池使用的场景题】

码哥讲源码【炸雷啦！炸雷啦！黄光头他终于跑路啦！】

码哥讲源码-【jvm课程前置知识及c/c++调试环境搭建】

码哥讲源码-原理源码篇【揭秘join方法的唤醒本质上决定于jvm的底层析构函数】

码哥源码-原理源码篇【Doug Lea为什么要将成员变量赋值给局部变量后再操作？】

码哥讲源码【你水不是你的错,但是你胡说八道就是你不对了！】

码哥讲源码【谁再说Spring不支持多线程事务，你给我抽他！】

终结B站没人能讲清楚红黑树的历史，不服等你来踢馆！

打脸系列【020-3小时讲解MESI协议和volatile之间的关系，那些将x86下的验证结果当作最终结果的水货们请闭嘴】

一、实验性功能说明

在lombok v0.11.0中，@Accessors被作为实验性功能引入。

添加原因：

我们可能希望将这些功能集成到一个更完整的属性支持概念中。
新功能 - 社区反馈。

当前状态：中性 - 预计会有一些变化。这些变化是为了向后兼容，但应该从实验性功能开始。

开放的功能请求：以小写字母开头的属性的命名行为，后面是大写字母。一半的规范、工具和lombok用户喜欢把名为uLimit的字段变成getULimit（包括lombok），另一半则转向喜欢getuLimit。@Accessors可以参与任何解决这一要求的更新。
开放功能请求：更多地控制命名访问器；例如，解决创造性命名的布尔属性：将 boolean wasRunning 转换为 boolean wasRunning() 而不是 boolean isWasRunning()，以及更广泛的前缀支持。如果解决此功能请求，将涉及@Accessors。
@Accessors目前没有从字段@Accessors注解 "级联 "到类级@Accessors注解，但它确实 "级联 "到lombok.config。改变这一点并不困难，但是向后不兼容。它不可能破坏很多现有的代码，但在该功能脱离实验状态之前，需要对此作出决定。

二、简介

@Accessors注解被用来配置lombok如何生成和寻找getters和setters。

默认情况下，lombok遵循bean规范的getter和setter。例如，一个名为pepper的字段的getter是getPepper。然而，有些人可能想打破Bean的规范，以便最终得到更漂亮的API。@Accessors让你做到这一点。

有些程序员喜欢为他们的字段使用前缀，例如他们写fPepper而不是pepper。我们强烈反对这样做，因为你无法对前缀的有效性进行单元测试，而且重构脚本可能会把字段变成局部变量或方法名称。此外，如果你想让这些信息即时可见，你的工具（比如你的编辑器）可以照顾到以某种方式呈现标识符的问题。尽管如此，你也可以通过@Accessors列出你的项目使用的前缀。

因此，@Accessors有3个选项：

fluent - 布尔值。默认值：false。如果为true，pepper的getter就是pepper()，setter就是pepper(T newValue)。此外，如果指定，那么chain默认为true。
chain - 布尔值。如果为true，则生成的setter返回该值，而不是void。默认值：false，如果fluent=true，默认值为true。
prefix - 一个字符串的列表。如果存在，字段必须以这些前缀中的任何一个为前缀。每个字段名依次与列表中的每个前缀进行比较，如果发现匹配，则剥离前缀以创建该字段的基本名称。在列表中包含一个空字符串是合法的，这将总是匹配的。对于属于字母的字符，前缀后面的字符不能是小写字母，即pepper甚至不能与前缀p匹配，但pEpper可以匹配（这意味着这个字段的基本名称是epper）。

@Accessors注解在类型和字段上都是合法的；如果存在的话，适用的注解是字段上的，否则就是类上的。当一个字段上的@Accessors注解存在时，字段所在的类上的任何@Accessors注解都会被完全忽略，甚至对于没有配置在字段上的@Accessors的属性。这与任何lombok.config配置键相反，这些配置键在任何明确的@Accessors注解没有指定的情况下作为后备默认。

三、示例比较

1. Lombok 写法

    import lombok.experimental.Accessors;
    import lombok.Getter;
    import lombok.Setter;
    
    @Accessors(fluent = true)
    public class AccessorsExample {
      @Getter @Setter
      private int age = 10;
    }
    
    class PrefixExample {
      @Accessors(prefix = "f") @Getter
      private String fName = "Hello, World!";
    }

2. Java 标准写法

    
    public class AccessorsExample {
      private int age = 10;
      
      public int age() {
        return this.age;
      }
      
      public AccessorsExample age(final int age) {
        this.age = age;
        return this;
      }
    }
    
    class PrefixExample {
      private String fName = "Hello, World!";
      
      public String getName() {
        return this.fName;
      }
    }

四、支持的配置项

lombok.accessors.chain = [true | false] (默认: false)
如果设置为true，任何没有@Accessors注解的类，或者有，但该注解没有明确的chain参数值，将像@Accessors(chain = true)存在一样行事。

lombok.accessors.chain = [true | false] (默认: false)
如果设置为true，任何没有@Accessors注解的类，或者有，但该注解没有明确的fluent参数值的类，将像@Accessors(fluent = true)存在一样行事。

lombok.accessors.prefix += 字段前缀 (默认: empty list)
这是一个列表属性；可以用+=操作符添加条目。从父级配置文件中继承的前缀可以用-=操作符删除。任何没有@Accessors注解的类，或者有，但该注解没有明确的prefix参数值的类，将像@Accessors(prefix = {配置中列出的前缀})一样行事。

lombok.accessors.flagUsage = [warning | error] (默认: not set)
Lombok将@Accessors的任何使用标记为警告或错误（如果已配置）。