Java开发神器Lombok的使用与原理


在面向对象编程中必不可少需要在代码中定义对象模型,而在基于Java的业务平台开发实践中尤其如此。相信大家在平时开发中也深有感触,本来是没有多少代码开发量的,但是因为定义的业务模型对象比较多,而需要重复写Getter/Setter、构造器方法、字符串输出的ToString方法和Equals/HashCode方法等。那么是否一款插件或工具能够替大家完成这些繁琐的操作呢?本文将向大家介绍一款在Eclipse/Intellij IDEA主流的开发环境中都可以使用的Java开发神器,同时简要地介绍下其背后自定义注解的原理。

Lombok的简介

Lombok是一款Java开发插件,使得Java开发者可以通过其定义的一些注解来消除业务工程中冗长和繁琐的代码,尤其对于简单的Java模型对象(POJO)。在开发环境中使用Lombok插件后,Java开发人员可以节省出重复构建,诸如hashCode和equals这样的方法以及各种业务对象模型的accessor和ToString等方法的大量时间。对于这些方法,它能够在编译源代码期间自动帮我们生成这些方法,并没有如反射那样降低程序的性能。

在Intellij中安装Lombok的插件

想要体验一把Lombok的话,得先在自己的开发环境中安装上对应的插件。下面先为大家展示下如何在Intellij中安装上Lombok插件。
通过IntelliJ的插件中心寻找Lombok
Java开发神器Lombok的使用与原理
从Intellij插件中心安装Lombok
Java开发神器Lombok的使用与原理
另外需要注意的是,在使用lombok注解的时候记得要导入lombok.jar包到工程,如果使用的是Maven的工程项目的话,要在其pom.xml中添加依赖如下:
  1. <dependency>
  2.    <groupId>org.projectlombok</groupId>
  3.    <artifactId>lombok</artifactId>
  4.    <version>1.16.8</version>
  5. </dependency>
好了,就这么几步后就可以在Java工程中开始用Lombok这款开发神器了。下文将会给大家介绍Lombok中一些注解的使用方法,让大家对如何用这些注解有一个大致的了解。

Lombok注解使用方法

Lombok常用注解介绍
下面先来看下Lombok中主要几个常用注解介绍:
Java开发神器Lombok的使用与原理
Lombok的基本使用示例
(1) Val可以将变量申明是final类型。
  1. public   staticvoid main(String[] args){
  2.    val setVar =newHashSet<String>();
  3.    val listsVar =new   ArrayList<String>();
  4.    val mapVar =newHashMap<String,   String>();
  5.    //=>上面代码相当于如下:
  6.    finalSet<String> setVar2 =new   HashSet<>();
  7.    finalList<String> listsVar2 =new   ArrayList<>();
  8.    finalMap<String,String> maps2 =   newHashMap<>();
  9. }
(2) @NonNull注解能够为方法或构造函数的参数提供非空检查。
  1. publicvoid notNullExample(@NonNullString string){
  2.    //方法内的代码
  3. }
  4. //=>上面代码相当于如下:
  5. publicvoid notNullExample(String string){
  6.    if(string !=null){
  7.        //方法内的代码相当于如下:
  8.    }else{
  9.        thrownewNullPointerException("null");
  10.    }
  11. }
(3) @Cleanup注解能够自动释放资源。
  1. public   void jedisExample(String[] args){
  2.    try{
  3.        @CleanupJedis jedis =   redisService.getJedis();
  4.    }catch(Exception ex){
  5.        logger.error(“Jedis异常:”,ex)
  6.    }
  7.    //=>上面代码相当于如下:
  8.    Jedis jedis=null;
  9.    try{
  10.        jedis = redisService.getJedis();
  11.    }catch(Exception e){
  12.        logger.error(“Jedis异常:”,ex)
  13.    }finally{
  14.        if(jedis !=null){
  15.            try{
  16.                jedis.close();
  17.            }catch(Exception e){
  18.                e.printStackTrace();
  19.            }
  20.        }
  21.    }
  22. }
(4) @Getter/@Setter注解可以针对类的属性字段自动生成Get/Set方法。
  1. publicclassOrderCreateDemoReq{
  2.    @Getter
  3.    @Setter
  4.    privateString customerId;
  5.    @Setter
  6.    @Getter
  7.    privateString poolId;
  8.    //其他代码……
  9. }
  10. //上面请求Req类的代码相当于如下:
  11. publicclassOrderCreateDemoReq{
  12.    privateString customerId;    
  13.    privateString poolId;
  14.    publicString getCustomerId(){
  15.         return customerId;
  16.    }
  17.    publicString getPoolId(){
  18.         return poolId;
  19.    }
  20.    publicvoid setCustomerId(String customerId){
  21.         this.customerId = customerId;
  22.    }
  23.    publicvoid setPoolId(String poolId){
  24.         this.pool = pool;
  25.    }
  26. }
(5) @ToString注解,为使用该注解的类生成一个toString方法,默认的toString格式为:ClassName(fieldName= fieleValue ,fieldName1=fieleValue)。
  1. @ToString(callSuper=true,exclude="someExcludedField")
  2. public   classDemoextendsBar{
  3.    privateboolean someBoolean =true;
  4.    privateString someStringField;
  5.    privatefloat someExcludedField;
  6. }
  7. //上面代码相当于如下:
  8. public   classDemoextendsBar{
  9.    privateboolean someBoolean =true;
  10.    privateString someStringField;
  11.    privatefloat someExcludedField;
  12.    @Override
  13.    publicString toString(){
  14.        return"Foo(super="+   super.toString()+
  15.            ", someBoolean="+   someBoolean +
  16.            ", someStringField="+   someStringField +")";
  17.    }
  18. }
(6) @EqualsAndHashCode注解,为使用该注解的类自动生成equals和hashCode方法。
  1. @EqualsAndHashCode(exclude ={"id"}, callSuper =true)
  2. publicclassLombokDemoextendsDemo{
  3.    privateint id;
  4.    privateString name;
  5.    privateString gender;
  6. }
  7. //上面代码相当于如下:
  8. publicclassLombokDemoextendsDemo{
  9.    privateint id;
  10.    privateString name;
  11.    privateString gender;
  12.    @Override
  13.    publicboolean equals(finalObject o){
  14.        if(o ==this)returntrue;
  15.        if(o ==null)returnfalse;
  16.        if(o.getClass()!=this.getClass())returnfalse;
  17.        if(!super.equals(o))returnfalse;
  18.        finalLombokDemo other =(LombokDemo)o;
  19.        if(this.name ==null? other.name !=null:!this.name.equals(other.name))returnfalse;
  20.        if(this.gender ==null? other.gender !=null:!this.gender.equals(other.gender))returnfalse;
  21.        returntrue;
  22.    }
  23.    @Override
  24.    publicint hashCode(){
  25.        finalint PRIME =31;
  26.        int result =1;
  27.        result = result * PRIME +super.hashCode();
  28.        result = result * PRIME +(this.name ==null?0:this.name.hashCode());
  29.        result = result * PRIME +(this.gender ==null?0:this.gender.hashCode());
  30.        return result;
  31.    }
  32. }
(7) @NoArgsConstructor@RequiredArgsConstructor@AllArgsConstructor,这几个注解分别为类自动生成了无参构造器、指定参数的构造器和包含所有参数的构造器。
  1. @RequiredArgsConstructor(staticName ="of")
  2. @AllArgsConstructor(access =AccessLevel.PROTECTED)
  3. publicclassConstructorExample<T>{
  4.  privateint x, y;
  5.  @NonNullprivate T description;
  6.  @NoArgsConstructor
  7.  publicstaticclassNoArgsExample{
  8.    @NonNullprivateString field;
  9.  }
  10. }
  11. //上面代码相当于如下:
  12. @RequiredArgsConstructor(staticName ="of")
  13. @AllArgsConstructor(access =AccessLevel.PROTECTED)
  14. publicclassConstructorExample<T>{
  15.  privateint x, y;
  16.  @NonNullprivate T description;
  17.  @NoArgsConstructor
  18.  publicstaticclassNoArgsExample{
  19.    @NonNullprivateString field;
  20.  }
  21. }
  22. publicclassConstructorExample<T>{
  23.  privateint x, y;
  24.  @NonNullprivate T description;
  25.  privateConstructorExample(T description){
  26.    if(description ==null)thrownewNullPointerException("description");
  27.    this.description = description;
  28.  }
  29.  publicstatic<T>ConstructorExample<T> of(T description){
  30.    returnnewConstructorExample<T>(description);
  31.  }
  32.  @java.beans.ConstructorProperties({"x","y","description"})
  33.  protectedConstructorExample(int x,int y, T description){
  34.    if(description ==null)thrownewNullPointerException("description");
  35.    this.x = x;
  36.    this.y = y;
  37.    this.description = description;
  38.  }
  39.  publicstaticclassNoArgsExample{
  40.    @NonNullprivateString field;
  41.    publicNoArgsExample(){
  42.    }
  43.  }
  44. }
(8) @Data注解作用比较全,其包含注解的集合 @ToString, @EqualsAndHashCode,所有字段的 @Getter和所有非final字段的 @Setter@RequiredArgsConstructor。其示例代码可以参考上面几个注解的组合。
(9) @Builder注解提供了一种比较推崇的构建值对象的方式。
  1. @Builder
  2. publicclassBuilderExample{
  3.  privateString name;
  4.  privateint age;
  5.  @SingularprivateSet<String> occupations;
  6. }
  7. //上面代码相当于如下:
  8. publicclassBuilderExample{
  9.  privateString name;
  10.  privateint age;
  11.  privateSet<String> occupations;
  12.  BuilderExample(String name,int age,Set<String> occupations){
  13.    this.name = name;
  14.    this.age = age;
  15.    this.occupations = occupations;
  16.  }
  17.  publicstaticBuilderExampleBuilder builder(){
  18.    returnnewBuilderExampleBuilder();
  19.  }
  20.  publicstaticclassBuilderExampleBuilder{
  21.    privateString name;
  22.    privateint age;
  23.    private java.util.ArrayList<String> occupations;    
  24.    BuilderExampleBuilder(){
  25.    }
  26.    publicBuilderExampleBuilder name(String name){
  27.      this.name = name;
  28.      returnthis;
  29.    }
  30.    publicBuilderExampleBuilder age(int age){
  31.      this.age = age;
  32.      returnthis;
  33.    }
  34.    publicBuilderExampleBuilder occupation(String occupation){
  35.      if(this.occupations ==null){
  36.        this.occupations =new java.util.ArrayList<String>();
  37.      }
  38.      this.occupations.add(occupation);
  39.      returnthis;
  40.    }
  41.    publicBuilderExampleBuilder occupations(Collection<?extendsString> occupations){
  42.      if(this.occupations ==null){
  43.        this.occupations =new java.util.ArrayList<String>();
  44.      }
  45.      this.occupations.addAll(occupations);
  46.      returnthis;
  47.    }
  48.    publicBuilderExampleBuilder clearOccupations(){
  49.      if(this.occupations !=null){
  50.        this.occupations.clear();
  51.      }
  52.      returnthis;
  53.    }
  54.    publicBuilderExample build(){  
  55.      Set<String> occupations =newHashSet<>();
  56.      returnnewBuilderExample(name, age, occupations);
  57.    }
  58.    @verride
  59.    publicString toString(){
  60.      return"BuilderExample.BuilderExampleBuilder(name = "+this.name +", age = "+this.age +", occupations = "+this.occupations +")";
  61.    }
  62.  }
  63. }
(10) @Synchronized注解类似Java中的Synchronized 关键字,但是可以隐藏同步锁。
  1. publicclassSynchronizedExample{
  2. privatefinalObject readLock =new   Object();
  3. @Synchronized
  4. publicstaticvoid hello(){
  5.     System.out.println("world");  
  6. }
  7. @Synchronized("readLock")
  8. publicvoid foo(){
  9.   System.out.println("bar");
  10. }
  11. //上面代码相当于如下:
  12. publicclassSynchronizedExample{
  13.  privatestaticfinalObject $LOCK =new   Object[0];
  14.  privatefinalObject readLock =new   Object();
  15.  publicstaticvoid hello(){
  16.    synchronized($LOCK){
  17.      System.out.println("world");
  18.    }
  19.  }  
  20.  publicvoid foo(){
  21.    synchronized(readLock){
  22.        System.out.println("bar");  
  23.    }
  24.  }
  25. }

Lombok背后的自定义注解原理

本文在前三章节主要介绍了Lombok这款Java开发利器中各种定义注解的使用方法,但作为一个Java开发者来说光了解插件或者技术框架的用法只是做到了“知其然而不知其所以然”,如果真正掌握其背后的技术原理,看明白源码设计理念才能真正做到“知其然知其所以然”。好了,话不多说下面进入本章节的正题,看下Lombok背后注解的深入原理。
可能熟悉Java自定义注解的同学已经猜到,Lombok这款插件正是依靠可插件化的Java自定义注解处理API(JSR 269: Pluggable Annotation Processing API)来实现在Javac编译阶段利用“Annotation Processor”对自定义的注解进行预处理后生成真正在JVM上面执行的“Class文件”。有兴趣的同学反编译带有Lombok注解的类文件也就一目了然了。其大致执行原理图如下:
Java开发神器Lombok的使用与原理
从上面的这个原理图上可以看出Annotation Processing是编译器在解析Java源代码和生成Class文件之间的一个步骤。其中Lombok插件具体的执行流程如下:
Java开发神器Lombok的使用与原理
从上面的Lombok执行的流程图中可以看出,在Javac 解析成AST抽象语法树之后, Lombok 根据自己编写的注解处理器,动态地修改 AST,增加新的节点(即Lombok自定义注解所需要生成的代码),最终通过分析生成JVM可执行的字节码Class文件。使用Annotation Processing自定义注解是在编译阶段进行修改,而JDK的反射技术是在运行时动态修改,两者相比,反射虽然更加灵活一些但是带来的性能损耗更加大。
需要更加深入理解Lombok插件的细节,自己查阅其源代码是必比可少的。对开源框架代码比较有执着追求的童鞋可以将Lombok的源代码工程从github上download到本地进行阅读和自己调试。下图为Lombok工程源代码的截图:
Java开发神器Lombok的使用与原理
从熟悉JSR 269: Pluggable Annotation Processing API的同学可以从工程类结构图中发现AnnotationProcessor这个类是Lombok自定义注解处理的入口。该类有两个比较重要的方法一个是init方法,另外一个是process方法。在init方法中,先用来做参数的初始化,将AnnotationProcessor类中定义的内部类(JavacDescriptor、EcjDescriptor)先注册到ProcessorDescriptor类型定义的列表中。其中,内部静态类—JavacDescriptor在其加载的时候就将 lombok.javac.apt.LombokProcessor这个类进行对象实例化并注册。
在 LombokProcessor处理器中,其中的process方法会根据优先级来分别运行相应的handler处理类。Lombok中的多个自定义注解都分别有对应的handler处理类,如下图所示:
Java开发神器Lombok的使用与原理
可以看出,在Lombok中对于其自定义注解进行实际的替换、修改和处理的正是这些handler类。对于其实现的细节可以具体参考其中的代码。
本文先从Lombok使用角度出发,先介绍了如何在当前主流的Java开发环境—Intellij中安装这块Java插件,随后分别介绍了Lombok中几种主要的常用注解(比如, @Data、 @CleanUp、 @ToString和 @Getter/Setter等),最后将Lombok背后Java自定义注解的原理与源代码结合起来,介绍了Lombok插件背后具体的执行处理流程。限于篇幅,未能对“自定义Java注解处理器”的具体实践和原理进行阐述,后面将另起专题篇幅进行介绍。限于笔者的才疏学浅,对本文内容可能还有理解不到位的地方,如有阐述不合理之处还望留言一起探讨。
本站所有文章均来自互联网,如有侵权,请联系站长删除。极客文库 » Java开发神器Lombok的使用与原理
分享到:
赞(0)

评论抢沙发

评论前必须登录!