Java Annotation之应用篇 – 运行期动态解析annotation
来源:互联网 发布:潮流计算的软件 编辑:程序博客网 时间:2024/04/29 13:17
这样说来,annotation到底能起什么作用呢?
1, 编译工具或其他工具可以根据被附加在代码里的annotation信息自动生成配置文件或文档等外部文件。
比如,sun公司就提供了apt(Annotation Processing Tool)工具,apt工具是一个可以处理annotation的命令行工具,apt提供了在编译期针对源代码级别的解析,并可以在解析时生成新的源代码和其他文件,同时还可以对生成的源代码进行编译。
2, 其他程序可以在运行时动态解析将要被执行的程序里的annotation信息,并根据被附加的annotation信息来执行不同的操作。
比如,EJB3规范就比较广泛地使用了annotation特性。比如只要在POJO为class注明@Stateless注释,EJB容器便会根据此annotation把该POJO注册为无状态的Session Bean。EJB3使用了annotation大大地简化了EJB的开发和配置过程。我们会在其他文章里专门介绍EJB Annotation的原理与使用方法,这里不做详述。
本文通过一个简单地例子来说明怎么在运行期动态解析annotation。Apt工具的使用我们会在近期其他文章里对其加以介绍。
比如,我们定义了MyAnnotation3注释:
MyAnnotation3.java
- package com.test.annotation;
- import java.lang.annotation.Annotation;
- import java.lang.annotation.Inherited;
- import java.lang.annotation.Retention;
- import java.lang.annotation.RetentionPolicy;
- @Retention(RetentionPolicy.RUNTIME)
- public @interface MyAnnotation3 {
- public String value();
- public String[] multiValues();
- int number() default 0;
- }
上面定义了一个名为MyAnnotation3的注释。
我们再定义一个GetMyAnnotation类,该类使用了MyAnnotation3注释:
GetMyAnnotation.java:
- package com.test.annotation.test;
- import java.lang.annotation.Annotation;
- import java.lang.reflect.Field;
- import java.lang.reflect.Method;
- import javax.ejb.EJB;
- import javax.naming.InitialContext;
- import javax.naming.NamingException;
- import com.test.annotation.MyAnnotation3;
- // 为GetMyAnnotation类附加MyAnnotation3 注释
- @MyAnnotation3(value = "Class GetMyAnnotation", multiValues = { "1", "2" })
- public class GetMyAnnotation {
- // 为testField1属性附加MyAnnotation3 注释
- @MyAnnotation3(value = "call testField1", multiValues = { "1" }, number = 1)
- private String testField1;
- // 为testMethod1方法附加MyAnnotation3 注释
- @MyAnnotation3(value = "call testMethod1", multiValues = { "1", "2" }, number = 1)
- public void testMethod1() {
- }
- @Deprecated
- @MyAnnotation3(value = "call testMethod2", multiValues = { "3", "4", "5" })
- public void testMethod2() {
- }
- }
上面的例子GetMyAnnotation非常简单,里面没有任何功能,但是分别为类(class),属性(field),方法(method)申明(附加)了MyAnnotation3 注释。
下面我们用程序TestMyAnnotation3对GetMyAnnotation里MyAnnotation3注释进行解析。
运行时解析annotation
TestMyAnnotation3.java
- public class TestMyAnnotation3 {
- public static void main(String[] args) {
- System.out.println("--Class Annotations--");
- if (GetMyAnnotation.class.isAnnotationPresent(MyAnnotation3.class)) {
- System.out.println("[GetMyAnnotation].annotation:");
- MyAnnotation3 classAnnotation = GetMyAnnotation.class
- .getAnnotation(MyAnnotation3.class);
- printMyAnnotation3(classAnnotation);
- }
- System.out.println("--Fields Annotations--");
- Field[] fields = GetMyAnnotation.class.getDeclaredFields();
- for (Field field : fields) {
- if (field.isAnnotationPresent(MyAnnotation3.class)) {
- System.out.println("[GetMyAnnotation." + field.getName()
- + "].annotation:");
- MyAnnotation3 fieldAnnotation = field
- .getAnnotation(MyAnnotation3.class);
- printMyAnnotation3(fieldAnnotation);
- }
- }
- System.out.println("--Methods Annotations--");
- Method[] methods = GetMyAnnotation.class.getDeclaredMethods();
- for (Method method : methods) {
- System.out.println("[GetMyAnnotation." + method.getName()
- + "].annotation:");
- if (method.isAnnotationPresent(MyAnnotation3.class)) {
- MyAnnotation3 methodAnnotation = method
- .getAnnotation(MyAnnotation3.class);
- printMyAnnotation3(methodAnnotation);
- }
- }
- }
- private static void printMyAnnotation3(MyAnnotation3 annotation3) {
- if (annotation3 == null) {
- return;
- }
- System.out.println("{value=" + annotation3.value());
- String multiValues = "";
- for (String value : annotation3.multiValues()) {
- multiValues += "," + value;
- }
- System.out.println("multiValues=" + multiValues);
- System.out.println("number=" + annotation3.number() + "}");
- }
- }
输出:
--Class Annotations--
[GetMyAnnotation].annotation:
{value=Class GetMyAnnotation
multiValues=,1,2
number=0}
--Fields Annotations--
[GetMyAnnotation.testField1].annotation:
{value=call testField1
multiValues=,1
number=1}
--Methods Annotations--
[GetMyAnnotation.testMethod1].annotation:
{value=call testMethod1
multiValues=,1,2
number=1}
[GetMyAnnotation.testMethod2].annotation:
{value=call testMethod2
multiValues=,3,4,5
number=0}
JDK1.5以后的版本提供的跟annotation有关的接口:
- interface java.lang.reflect.AnnotatedElement {
- boolean isAnnotationPresent(Class<? extends Annotation> annotationClass);
- <T extends Annotation> T getAnnotation(Class<T> annotationClass);
- Annotation[] getAnnotations();
- Annotation[] getDeclaredAnnotations();
- }
该接口主要用来取得附加在类(class),构造方法(constructor),属性(field),方法(method),包(package)上的annotation信息。
JDK1.5与此有关的几个类都实现了AnnotatedElement接口:
所以可以利用反射(reflection)功能在程序里动态解析附加的annotation信息。
总结:
本文通过举例简单地说明了怎么动态解析annotation,大家可以举一反三,利用Java的annotation特性,完成更复杂功能等。
- Java Annotation之应用篇 – 运行期动态解析annotation (3)
- Java Annotation之应用篇 – 运行期动态解析annotation
- Java中的Annotation解析之二(1)
- Java编程之Annotation全解析
- 用Annotation,Future,动态代理实现自己的JAVA方法运行超时应用
- Java中的Annotation解析
- Java Annotation 高级应用
- Java Annotation 高级应用
- Java Annotation 高级应用
- Java Annotation 高级应用
- Java Annotation 高级应用
- Java Annotation 高级应用
- Java Annotation高级应用
- java annotation高级应用
- Java Annotation 高级应用
- Java Annotation 高级应用
- Java Annotation 高级应用
- Java Annotation 高级应用
- [整理] RPM包制作
- 虚函数和抽象基类的应用
- 第3只眼看苹果和老乔
- Android弹性listview滚动
- 代码获取apk包信息
- Java Annotation之应用篇 – 运行期动态解析annotation
- 麦肯锡解决问题的7个步骤
- DataGrid关于button的相关操作
- 有关BlackBerry app 数字签名
- CAN总线使用总结
- 对CURL的一些研究
- 绘制3维文字标注(IText3DElement )
- DropDownList 局部刷新
- java.lang.UnsupportedClassVersionError: Bad version number in .class file