[译]使用注解处理器生成代码-2 注解处理器-阿里云开发者社区

开发者社区> 程序员历小冰> 正文

[译]使用注解处理器生成代码-2 注解处理器

简介: 原文请看摸我  这是有关注解代码生成技术系列博文的第二部分。在第一部分(摸我)中,我们介绍了注解的基本概念与用法。  在本篇博文中我们将介绍注解处理器的基本概念和使用运行方法。
+关注继续查看

原文请看摸我
 这是有关注解代码生成技术系列博文的第二部分。在第一部分(摸我)中,我们介绍了注解的基本概念与用法。
 在本篇博文中我们将介绍注解处理器的基本概念和使用运行方法。

介绍

注解功能强大。你可以使用注解来设置各类元数据或者配置信息,语法格式优雅并且功能强大。
 从目前我们了解的知识来看,注解比起Javadoc来有很多优势,但是这些好像都不足以委员会将其加入java语言之中。那么,我们可以更好的利用和了解注解吗?当然可以啦:

  • 在运行时刻,带有runtime retention policy的注解可以通过反射获得,Class类中的getAnnotation()getAnnotations()方法可以做到这些。
  • 在编译时刻,注解处理器可以处理在编译时发现的各类注解。

注解处理器API

当注解在Java 5 首次被引入时,注解处理器API还不是很成熟和规范化。处理注解需要一个单独的工具,叫做apt,注解处理工具;还需要Mirror API(com.sun.mirror),用于编写自定义处理器。
 从java 6开始,注解处理通过JSR 269(2)被标准化,被集成进标准库并且apt无缝的集成到java编译器javac中。
 因为我们只详细讲述Java 6 中的注解处理器相关API,你可以在这里这里找到关于java 5中注解的更多信息,并在这里找到一些例子。
 自定义注解处理器只是实现了javax.annotation.processing.Processor接口并准从指定的协议。为了我们的便利,自定义处理器一些常用的功能都由javax.annotation.processing.AbstractProcessor这个类给出了抽象实现。
 自定义注解处理器可以使用到一下三个注解来配置自己:

  • javax.annotation.processing.SupportedAnnotationTypes:这个注解用来注册注解处理器要处理的注解类型。有效值为完全限定名(就是带所在包名和路径的类全名)-通配符(此次英语原文为Wildcards,就是?这个符号代表的类型。比如说List<? extends String,想要深入了解,可以看一下这里)也可以。
  • javax.annotation.processing.SupportedSourceVersion:这是用来注册注解处理器要处理的源代码版本。
  • javax.annotation.processing.SupportedOptions:这个注解用来注册可能通过命令行传递给处理器的操作选项。
    (译者语:对于android注解处理器,第一个注解比较有用,另外两个了解就可)
     最后,我们提供process()方法的实现。

实现我们第一个注解处理器

让我们开始第一个注解处理器的实现。按照之前章节的知识,我们实现了下面这个类来处理第一篇博文中的Complexity注解:

 package sdc.assets.annotations.processors;

    import …

    @SupportedAnnotationTypes("sdc.assets.annotations.Complexity")
    @SupportedSourceVersion(SourceVersion.RELEASE_6)
    public class ComplexityProcessor extends AbstractProcessor {

        public ComplexityProcessor() {
            super();
        }

        @Override
        public boolean process(Set<? extends TypeElement> annotations,
                               RoundEnvironment roundEnv) {
            return true;
        }
    }

这个未完全完成的类,尽管没有任何操作,但是注册可以支持处理sdc.assets.annotations.Complexity注解类型。因此,每次java编译器遇到一个被Complexity标记的类都有执行这个处理器,假设这个处理器在那个路径中可以被获得(具体原由之后会看到)。
process()方法会受到两个输入参数:

  • Set<? extends TypeElement>:注解处理需要执行一次或者多次。每次执行时,处理器方法被调用,并且传入了当前要处理的注解类型。
  • RoundEnvironment:这个对象提供当前或者上一次注解处理中被注解标注的源文件元素。(简单点说,就是可以获得所有被标注的元素,无论是类,参数,函数还是变量)
     除了上述两个参数之外,ProcessingEnvironment对象也可以通过processingEnv实例获得。这个对象可以提供一些关于日志,文件读写的通用工具类;它的一些功能之后会讨论到。
     使用RoundEnvironment对象和Element接口的反射相关的函数,我们可以实现一个打印Complexity标注元素名的注解处理器。
for (Element elem :roundEnv.getElementsAnnotatedWith(Complexity.class)) {     
  Complexity complexity = elem.getAnnotation(Complexity.class);     
  String message = "annotation found in " + elem.getSimpleName()                     + " with complexity " + complexity.value();       processingEnv.getMessager().printMessage(Diagnostic.Kind.NOTE, message); 
  return true; // no further processing of this annotation type
}

打包并且注册注解处理器

自定义注解处理器的最后一步就是打包并且向java编译器获取其他可以识别处理器的工具进行注册。

注册处理器的最简单方法就是使用标注java服务机制:

  • 把你的注解处理器打包到jar文件中。
  • 把jar文件加入到META-INF/services目录。
  • 把javax.annotation.processing.Processor文件加入到目录。
  • 把处理器的全限定名写入一个文件中,一个处理器名一行。

java编译器或者其他工具会搜索这个文件中标记的所有处理器,并且在注解处理过程中使用。
 在我们这个例子中,目录结构和文件内容如下:


picture1.png

picture2.png

 一旦打包完成,我们就准备使用它。
(译者语:关于android平台的自动打包和使用,可以参考butterknife的方法,就是使用AutoService,这个详细知识之后我会单独博文讲解)

使用javac运行处理器

想象一下你在一个项目中使用了一些自定义注解并且可以使用注解处理器。在java 5中,编译和注解处理是不同的两步,但是在java 6中,两个任务都集成到java编译器工具javac中。
 如果你把注解处理器加入到javac的路径中并且他们使用服务机制进行了注册,他们就会被javac执行调用啦。
 在我们这个例子中,下边这个命令会编译并且执行注解处理:

>javac -cp sdc.assets.annotations-1.0-SNAPSHOT.jar;  
sdc.assets.annotations.processors-1.0-SNAPSHOT.jar    
SimpleAnnotationsTest.java

用于处理的java类文件内容如下:

package sdc.startupassets.annotations.base.client; 
import ... 
@Complexity(ComplexityLevel.VERY_SIMPLE) 
public class SimpleAnnotationsTest { 
  public SimpleAnnotationsTest() 
  { 
    super(); 
  } 
  @Complexity() // this annotation type applies also to methods //   the default value 'ComplexityLevel.MEDIUM' is assumed 
public void theMethod() 
  { 
    System.out.println("consoleut"); 
  } 
}

上述执行结果如下:

picture3.png

有一些javac的选项可以在一些特殊的情况下使用:

  • -Akey[=value]:用来传递选项值给处理器,处理器只会接收在通过SupportedOptions注解注册的选项。
  • -proc:{none|only}:默认情况下,javac会运行注解处理并且编译源码。使用proc:none选项,将不执行注解处理;使用proc:only选项将只执行注解处理过程-当你在注解处理器中运行验证或者质量检查工具或者代码审查工具时。
  • -processorpath path:用来确定注解处理器和它的依赖的位置
  • -s dir:用来确定通过注解处理生成的源代码放置在哪个文件夹中。这个目录在执行命令行之前必须存在。
  • -processor class1[,class2,class3…]:用来给出将要执行的注解处理器全限定名,当使用这个选项时,默认的通过服务机制寻找到的注解处理器将被替换,直接使用命令行给出的处理器进行处理。
    (译者语:下边两个章节因为和主干内容没有太大关系,所以没有翻译,请感兴趣的朋友自行查阅)

Eclipse 中运行注解处理器

Maven中运行注解处理器

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
Netbeans源代码编辑技巧——使用代码补全和代码生成
原文 Netbeans源代码编辑技巧——使用代码补全和代码生成 使用代码补全生成代码 一般来说,代码补全对于自动填充缺失的代码是有帮助的,例如标识符和关键字。截至 NetBeans IDE 6.0,您现在甚至可以用代码补全来生成整个方法。
871 0
MyBatis Generator 代码生成器 快速入门指南
要使用MyBatis Generator(MBG)快速启动并运行,请按照下列步骤操作:1、适当地创建并填写配置文件。至少必须指定:一个元素来指定如何连接到目标数据库一个元素来指定生成的Java模型对象的目标包和目标项目用于指定生成的SQL映射文件的目标包和目标项目的元素(可选)一个元素来指定生成的客户端接口和类的目标包和目标项目(如果不希望生成Java客户端代码,则可以省略元素)至少有一个数据库元素有关配置文件的示例,请参阅XML配置文件参考页面。
804 0
Unity不同平台生成中预处理的注意点
Unity3D的项目,这周吃亏在宏上了。大背景是项目需要在Unity中用Hudson自动生成不同平台的版本。 程序设计语言的预处理的概念:在编译之前进行的处理。
734 0
C++实践参考——处理C++源代码的程序
【项目 - 处理C++源代码的程序】   在CodeBlocks等IDE中都提供了代码格式整理的功能。完成这种功能的程序,操作的数据是用C++写的源代码文件。C++源文件是一种文本文件,可以通过程序进行操作。集成开发环境(IDE)对对程序进行编译,操作的“数据”是源程序。编译中,要对源程序进行词法检查和语法检查,后续还要进行目标代码生成、代码优化等工作。相关的技术将在《编译原理》课中学习。这些
916 0
asp.net core webapi 使用ef 对mysql进行增删改查,并生成Docker镜像构建容器运行
1.构建运行mysql容器,添加数据库user 参考Docker创建运行多个mysql容器,地址 http://www.cnblogs.com/heyangyi/p/9288402.html 添加user数据库,添加tbusers表 2.
2481 0
一文助你解决90%的自然语言处理问题(附代码)
自然语言处理(NLP)与计算机视觉(CV)一样,是目前人工智能领域里最为重要的两个方向。如何让机器学习方法从文字中理解人类语言内含的思想?本文中,来自 Insight AI 的 Emmanuel Ameisen 将为我们简述绝大多数任务上我们需要遵循的思路。
7530 0
SSM框架——使用 MyBatis Generator 生成代码,包括:Model、Dao、Mapping
基于 SSM 框架开发,Mybatis 属于半自动 ORM,如果每个数据表相关的 Model、Dao、Mapping 都要自己动手去写,是不是很麻烦呢?工作量最大的就是书写Mapping的映射文件,而且手动书写很容易出错。
1152 0
78
文章
4
问答
文章排行榜
最热
最新
相关电子书
更多
《2021云上架构与运维峰会演讲合集》
立即下载
《零基础CSS入门教程》
立即下载
《零基础HTML入门教程》
立即下载