Java注解--Java深度历险(转)
在开发Java程序,尤其是Java EE应用的时候,总是免不了与各种配置文件打交道。以Java EE中典型的S(pring)S(truts)H(ibernate)架构来说,Spring、Struts和Hibernate这 三个框架都有自己的XML格式的配置文件。这些配置文件需要与Java源代码保存同步,否则的话就可能出现错误。而且这些错误有可能到了运行时刻才被发 现。把同一份信息保存在两个地方,总是个坏的主意。理想的情况是在一个地方维护这些信息就好了。其它部分所需的信息则通过自动的方式来生成。JDK 5中引入了源代码中的注解(annotation)这一机制。注解使得Java源代码中不但可以包含功能性的实现代码,还可以添加元数据。注解的功能类似 于代码中的注释,所不同的是注解不是提供代码功能的说明,而是实现程序功能的重要组成部分。Java注解已经在很多框架中得到了广泛的使用,用来简化程序 中的配置。
使用注解
在一般的Java开发中,最常接触到的可能就是@Override和@SupressWarnings这 两个注解了。使用@Override的时候只需要一个简单的声明即可。这种称为标记注解(marker annotation ),它的出现就代表了某种配置语义。而其它的注解是可以有自己的配置参数的。配置参数以名值对的方式出现。使用 @SupressWarnings的时候需要类似@SupressWarnings({"uncheck", "unused"})这样的语法。在括号里面的是该注解可供配置的值。由于这个注解只有一个配置参数,该参数的名称默认为value,并且可以省略。而花 括号则表示是数组类型。在JPA中的@Table注解使用类似@Table(name = "Customer", schema = "APP")这样的语法。从这里可以看到名值对的用法。在使用注解时候的配置参数的值必须是编译时刻的常量。
从某种角度来说,可以把注解看成是一个XML元素,该元素可以有不同的预定义的属性。而属性的值是可以在声明该元素的时候自行指定的。在代码中使用注解,就相当于把一部分元数据从XML文件移到了代码本身之中,在一个地方管理和维护。
开发注解
在一般的开发中,只需要通过阅读相关的API文档来了解每个注解的配置参数的含义,并在代码中正确使用即可。在有些情况下,可能会需要开发自己的注 解。这在库的开发中比较常见。注解的定义有点类似接口。下面的代码给出了一个简单的描述代码分工安排的注解。通过该注解可以在源代码中记录每个类或接口的 分工和进度情况。
1 @Retention(RetentionPolicy.RUNTIME) 2 @Target(ElementType.TYPE) 3 public @interface Assignment { 4 String assignee(); 5 int effort(); 6 double finished() default 0; 7 }
@interface用来声明一个注解,其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称,返回值类型就是参数的类型。可以通过default来声明参数的默认值。在这里可以看到@Retention和@Target这样的元注解,用来声明注解本身的行为。@Retention用来声明注解的保留策略,有CLASS、RUNTIME和SOURCE这三种,分别表示注解保存在类文件、JVM运行时刻和源代码中。只有当声明为RUNTIME的时候,才能够在运行时刻通过反射API来获取到注解的信息。@Target用来声明注解可以被添加在哪些类型的元素上,如类型、方法和域等。
处理注解
在程序中添加的注解,可以在编译时刻或是运行时刻来进行处理。在编译时刻处理的时候,是分成多趟来进行的。如果在某趟处理中产生了新的Java源文 件,那么就需要另外一趟处理来处理新生成的源文件。如此往复,直到没有新文件被生成为止。在完成处理之后,再对Java代码进行编译。JDK 5中提供了apt工具用来对注解进行处理。apt是一个命令行工具,与之配套的还有一套用来描述程序语义结构的Mirror API。Mirror API(com.sun.mirror.*)描述的是程序在编译时刻的静态结构。通过Mirror API可以获取到被注解的Java类型元素的信息,从而提供相应的处理逻辑。具体的处理工作交给apt工具来完成。编写注解处理器的核心是AnnotationProcessorFactory和AnnotationProcessor两个接口。后者表示的是注解处理器,而前者则是为某些注解类型创建注解处理器的工厂。
以上面的注解Assignment为例,当每个开发人员都在源代码中更新进度的话,就可以通过一个注解处理器来生成一个项目整体进度的报告。 首先是注解处理器工厂的实现。
1 public class AssignmentApf implements AnnotationProcessorFactory { 2 public AnnotationProcessor getProcessorFor(Set<AnnotationTypeDeclaration> atds,? AnnotationProcessorEnvironment env) { 3 if (atds.isEmpty()) { 4 return AnnotationProcessors.NO_OP; 5 } 6 return new AssignmentAp(env); //返回注解处理器 7 } 8 public Collection<String> supportedAnnotationTypes() { 9 return Collections.unmodifiableList(Arrays.asList("annotation.Assignment")); 10 } 11 public Collection<String> supportedOptions() { 12 return Collections.emptySet(); 13 } 14 }
AnnotationProcessorFactory接口有三个方法:getProcessorFor是根据注解的类型来返回特定的注解处理 器;supportedAnnotationTypes是返回该工厂生成的注解处理器所能支持的注解类型;supportedOptions用来表示所支 持的附加选项。在运行apt命令行工具的时候,可以通过-A来传递额外的参数给注解处理器,如-Averbose=true。当工厂通过 supportedOptions方法声明了所能识别的附加选项之后,注解处理器就可以在运行时刻通过AnnotationProcessorEnvironment的getOptions方法获取到选项的实际值。注解处理器本身的基本实现如下所示。
1 public class AssignmentAp implements AnnotationProcessor { 2 private AnnotationProcessorEnvironment env; 3 private AnnotationTypeDeclaration assignmentDeclaration; 4 public AssignmentAp(AnnotationProcessorEnvironment env) { 5 this.env = env; 6 assignmentDeclaration = (AnnotationTypeDeclaration) env.getTypeDeclaration("annotation.Assignment"); 7 } 8 public void process() { 9 Collection<Declaration> declarations = env.getDeclarationsAnnotatedWith(assignmentDeclaration); 10 for (Declaration declaration : declarations) { 11 processAssignmentAnnotations(declaration); 12 } 13 } 14 private void processAssignmentAnnotations(Declaration declaration) { 15 Collection<AnnotationMirror> annotations = declaration.getAnnotationMirrors(); 16 for (AnnotationMirror mirror : annotations) { 17 if (mirror.getAnnotationType().getDeclaration().equals(assignmentDeclaration)) { 18 Map<AnnotationTypeElementDeclaration, AnnotationValue> values = mirror.getElementValues(); 19 String assignee = (String) getAnnotationValue(values, "assignee"); //获取注解的值 20 } 21 } 22 } 23 }
注解处理器的处理逻辑都在process方法中完成。通过一个声明(Declaration)的getAnnotationMirrors方法就可以获取到该声明上所添加的注解的实际值。得到这些值之后,处理起来就不难了。
在创建好注解处理器之后,就可以通过apt命令行工具来对源代码中的注解进行处理。 命令的运行格式是apt -classpath bin -factory annotation.apt.AssignmentApf src/annotation/work/*.java,即通过-factory来指定注解处理器工厂类的名称。实际上,apt工具在完成处理之后,会自 动调用javac来编译处理完成后的源代码。
JDK 5中的apt工具的不足之处在于它是Oracle提供的私有实现。在JDK 6中,通过JSR 269把自定义注解处理器这一功能进行了规范化,有了新的javax.annotation.processing这个新的API。对Mirror API也进行了更新,形成了新的javax.lang.model包。注解处理器的使用也进行了简化,不需要再单独运行apt这样的命令行工具,Java编译器本身就可以完成对注解的处理。对于同样的功能,如果用JSR 269的做法,只需要一个类就可以了。
1 @SupportedSourceVersion(SourceVersion.RELEASE_6) 2 @SupportedAnnotationTypes("annotation.Assignment") 3 public class AssignmentProcess extends AbstractProcessor { 4 private TypeElement assignmentElement; 5 public synchronized void init(ProcessingEnvironment processingEnv) { 6 super.init(processingEnv); 7 Elements elementUtils = processingEnv.getElementUtils(); 8 assignmentElement = elementUtils.getTypeElement("annotation.Assignment"); 9 } 10 public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) { 11 Set<? extends Element> elements = roundEnv.getElementsAnnotatedWith(assignmentElement); 12 for (Element element : elements) { 13 processAssignment(element); 14 } 15 } 16 private void processAssignment(Element element) { 17 List<? extends AnnotationMirror> annotations = element.getAnnotationMirrors(); 18 for (AnnotationMirror mirror : annotations) { 19 if (mirror.getAnnotationType().asElement().equals(assignmentElement)) { 20 Map<? extends ExecutableElement, ? extends AnnotationValue> values = mirror.getElementValues(); 21 String assignee = (String) getAnnotationValue(values, "assignee"); //获取注解的值 22 } 23 } 24 } 25 }
仔细比较上面两段代码,可以发现它们的基本结构是类似的。不同之处在于JDK 6中通过元注解@SupportedAnnotationTypes来 声明所支持的注解类型。另外描述程序静态结构的javax.lang.model包使用了不同的类型名称。使用的时候也更加简单,只需要通过javac -processor annotation.pap.AssignmentProcess Demo1.java这样的方式即可。
上面介绍的这两种做法都是在编译时刻进行处理的。而有些时候则需要在运行时刻来完成对注解的处理。这个时候就需要用到Java的反射API。反射API提供了在运行时刻读取注解信息的支持。不过前提是注解的保留策略声明的是运行时。Java反射API的AnnotatedElement接口提供了获取类、方法和域上的注解的实用方法。比如获取到一个Class类对象之后,通过getAnnotation方法就可以获取到该类上添加的指定注解类型的注解。
实例分析
下面通过一个具体的实例来分析说明在实践中如何来使用和处理注解。假定有一个公司的雇员信息系统,从访问控制的角度出发,对雇员的工资的更新只能由具有特定角色的用户才能完成。考虑到访问控制需求的普遍性,可以定义一个注解来让开发人员方便的在代码中声明访问控制权限。
1 @Retention(RetentionPolicy.RUNTIME) 2 @Target(ElementType.METHOD) 3 public @interface RequiredRoles { 4 String[] value(); 5 }
下一步则是如何对注解进行处理,这里使用的Java的反射API并结合动态代理。下面是动态代理中的InvocationHandler接口的实现。
1 public class AccessInvocationHandler<T> implements InvocationHandler { 2 final T accessObj; 3 public AccessInvocationHandler(T accessObj) { 4 this.accessObj = accessObj; 5 } 6 public Object invoke(Object proxy, Method method, Object[] args) throws Throwable { 7 RequiredRoles annotation = method.getAnnotation(RequiredRoles.class); //通过反射API获取注解 8 if (annotation != null) { 9 String[] roles = annotation.value(); 10 String role = AccessControl.getCurrentRole(); 11 if (!Arrays.asList(roles).contains(role)) { 12 throw new AccessControlException("The user is not allowed to invoke this method."); 13 } 14 } 15 return method.invoke(accessObj, args); 16 } 17 }
在具体使用的时候,首先要通过Proxy.newProxyInstance方法创建一个EmployeeGateway的接口的代理类,使用该代理类来完成实际的操作。
参考资料
- JDK 5和JDK 6中的apt工具说明文档
- Pluggable Annotation Processing API
APT: Compile-Time Annotation Processing with Java
转载于:https://www.cnblogs.com/WayneZeng/archive/2012/09/24/2699737.html
Java注解--Java深度历险(转)相关推荐
- c JAVA 注解,Java元注解作用及使用
元注解是负责对其它注解进行说明的注解,自定义注解时可以使用元注解.Java 5 定义了 4 个注解,分别是 @Documented.@Target.@Retention 和 @Inherited.Ja ...
- c#特性 java注解,Java注解全面了解
开发工具使用的是IntelliJ IDEA 一. 神马是注解? 注解(也称为元数据),为我们的代码添加信息提供了一种形式化的方法,使我们在某些时刻可以方便的使用这些数据. 注解在一定程度上把数据与源码 ...
- java 注解 id_java注解
java注解: Java 注解用于为 Java 代码提供元数据.作为元数据,注解不直接影响你的代码执行,但也有一些类型的注解实际上可以用于这一目的.Java 注解是从 Java5 开始添加到 Java ...
- java注解_Java注解
java注解 Java Annotations provides information about the code. Java annotations have no direct effect ...
- JAVA12_09学习总结(Java注解,JavaScript)
今日内容 1. Java注解 Java注解所有注解都继承自Java.lang.annotation下的Annotation公共接口注解的本质就是接口--接口中的方法名在注解中称为属性--注解中有且只有 ...
- 看完这篇Java注解,我要在学妹面前吹牛皮~
文章目录 Java注解 1.注解的定义 2.元注解 2.1 @Retention(保留) 2.2 @Documented(文档) 2.3 @Target(目标) 2.4 @Inherited(继承) ...
- 做了6年的Java,java视频教程传智播客
JAVA基础 JAVA异常分类及处理 异常分类 异常的处理方式 Throw和throws的区别 JAVA反射 动态语言 反射机制概念 (运行状态中知道类所有的属性和方法) Java反射API 反射使用 ...
- Java深度历险:Java注解
2019独角兽企业重金招聘Python工程师标准>>> 在开发Java程序,尤其是Java EE应用的时候,总是免不了与各种配置文件打交道.以Java EE中典型的S(pri ...
- Java 深度历险(作者成富,是IBM 中国软件开发中心的高级工程师)
Java 深度历险(作者成富,是IBM 中国软件开发中心的高级工程师) http://blog.csdn.net/hnzhangshilong/article/details/7038009 2 ...
最新文章
- leangoo敏捷开发工具应用场景
- Fluid 0.4 新版本正式发布
- 词频统计预处理之综合练习
- Windows上面挂载NFS共享
- 一个失败的创意:GPGPU纹理化通用加速kD树的实现
- 离散数学 (II) 习题 2
- 研发岗和产品岗的时间管理策略总结-大局观概述
- php花曲线,ps钢笔工具怎么画曲线
- 今天生日回想这难忘的一年(应届大学生2019-2020一年的总结)
- B站台湾大学郭彦甫|MATLAB 学习笔记|12 线性方程式和线性系统 Linear equations
- 计算机中的八卦知识,论八卦与电脑的关系
- Android之拍照后删除图片
- 解决梯度消失和梯度弥散的方法
- 外包也开始卷起来了???
- 计算机常见硬盘名称,我的硬盘我做主:自己给电脑硬盘改个名!
- 讲座有感——科技论文写作要素
- 强类型语言与弱类型语言/面向过程与面向对象
- java zhs16gbk_JAVA-----乱码的处理 乱码的解决方法总结
- unity3D 法线贴图的制作与使用
- 双目测距数学原理详解
热门文章
- 超详细的2440中断机制分析
- 重新安装mysql5.7.21_linux 安装mysql 5.7.21详解以及安装过程中所遇问题解决
- ashx 跨域_ASP.NET通用HTTP处理程序(ashx的),支持JSONP
- Redis Cluster Gossip 协议详解
- 智能指针——auto_ptr
- c++ 标准库中 cin.ignore()
- Linux newgrp命令用法详解:切换用户的有效组
- if、for、while、do while、switch (区别于if、while)解析
- 防火墙软件测试工资,防火墙的性能测试
- Spring MVC 配置--解剖