怎样自己定义注解Annotation,并利用反射进行解析

Java注解可以提供代码的相关信息,同一时候对于所注解的代码结构又没有直接影响。在这篇教程中,我们将学习Java注解,怎样编写自己定义注解。注解的使用,以及怎样使用反射解析注解。

注解是Java 1.5引入的,眼下已被广泛应用于各种Java框架,如Hibernate。Jersey。Spring。注解相当于是一种嵌入在程序中的元数据。能够使用注解解析工具或编译器对其进行解析。也能够指定注解在编译期或执行期有效。

在注解诞生之前。程序的元数据存在的形式仅限于java凝视或javadoc,但注解可以提供很多其它功能。它不仅包括元数据,还能作用于执行期,注解解析器可以使用注解决定处理流程。

举个样例,在Jersey webservice中,我们在一个方法上加入了PATH注解和URI字符串,在执行期,jersey会对其进行解析,并决定作用于指定URI模式的方法。

在Java中创建自己定义注解

创建自己定义注解与编写接口非常相似,除了它的接口keyword前有个@符号。

我们能够在注解中定义方法。先来看个样例,之后我们会继续讨论它的特性。

@Documented
@Target(ElementType.METHOD)
@Inherited
@Retention(RetentionPolicy.RUNTIME)
public @interface MethodInfo {
String author() default "Somnus";
String date();
int revision() default 1;
String comments();
}
  • 注解方法不能有參数。
  • 注解方法的返回类型局限于原始类型,字符串,枚举。注解。或以上类型构成的数组。
  • 注解方法能够包括默认值。
  • 注解能够包括与其绑定的元注解,元注解为注解提供信息,有四种元注解类型:

1. @Documented – 表示使用该注解的元素应被javadoc或类似工具文档化,它应用于类型声明。类型声明的注解会影响client对注解元素的使用。

假设一个类型声明加入了Documented注解,那么它的注解会成为被注解元素的公共API的一部分。

2. @Target – 表示支持注解的程序元素的种类,一些可能的值有TYPE, METHOD, CONSTRUCTOR, FIELD等等。假设Target元注解不存在,那么该注解就能够使用在不论什么程序元素之上。

3. @Inherited – 表示一个注解类型会被自己主动继承,假设用户在类声明的时候查询注解类型。同一时候类声明中也没有这个类型的注解。那么注解类型会自己主动查询该类的父类,这个过程将会不停地反复。直到该类型的注解被找到为止,或是到达类结构的顶层(Object)。

4. @Retention – 表示注解类型保留时间的长短。它接收RetentionPolicy參数。可能的值有SOURCE, CLASS, 以及RUNTIME

Java内置注解

Java提供3种内置注解。

1. @Override – 当我们想要覆盖父类的一个方法时,须要使用该注解告知编译器我们正在覆盖一个方法。

这种话。当父类的方法被删除或改动了。编译器会提示错误信息。

大家能够学习一下为什么我们总是应该在覆盖方法时使用Java覆盖注解

2. @Deprecated – 当我们想要让编译器知道一个方法已经被弃用(deprecate)时。应该使用这个注解。Java推荐在javadoc中提供信息。告知用户为什么这种方法被弃用了,以及替代方法是什么。

3. @SuppressWarnings – 这个注解不过告知编译器,忽略它们产生了特殊警告。比方:在java泛型中使用原始类型。

它的保持性策略(retention
policy)是SOURCE。在编译器中将被丢弃。

我们来看一个样例,展示了怎样使用内置注解,以及上述演示样例中提及的自己定义注解。

public class AnnotationDemo {

    @Override
@MethodInfo(author = "Somnus", comments = "Main method", date = "June 12 2015", revision = 1)
public String toString() {
return "Overriden toString method";
} @Deprecated
@MethodInfo(comments = "deprecated method", date = "June 12 2015")
public static void outdatedMethod() {
System.out.println("outdated method, don't use it.");
} @SuppressWarnings({"unchecked"})
@MethodInfo(author = "Somnus", comments = "Main method", date = "June 12 2015", revision = 10)
public static void genericsTest() throws FileNotFoundException {
List l = new ArrayList();
l.add("abc");
outdatedMethod();
}
}

我相信这个样例是非常明了的,展示了不同场景下注解的使用方式。

Java注解解析

我们将使用Java反射机制从一个类中解析注解,请记住,注解保持性策略应该是RUNTIME,否则它的信息在执行期无效。我们也不能从中获取不论什么数据。

public class AnnotationParsing {
public static void main(String[] args) { for (Method method : AnnotationDemo.class.getMethods()) {
// checks if MethodInfo annotation is present for the method
if (method.isAnnotationPresent(MethodInfo.class)) {
try {
// iterates all the annotations available in the method
for (Annotation anno : method.getDeclaredAnnotations()) {
System.out.println("Annotation in Method \n'"+ method + "' : " + anno);
}
MethodInfo methodInfo = method.getAnnotation(MethodInfo.class);
if (methodInfo.revision() == 1) {
System.out.println("Method with revision no 1 = \n"+ method);
System.out.println("comments:"+methodInfo.comments());
}
System.out.println("*******************************************");
} catch (Throwable ex) {
ex.printStackTrace();
}
}
}
}
}

以上程序的输出是:

Annotation in Method
'public java.lang.String com.somnus.annotation.AnnotationDemo.toString()' : @com.somnus.annotation.MethodInfo(author=Somnus, revision=1, comments=Main method, date=June 12 2015)
Method with revision no 1 =
public java.lang.String com.somnus.annotation.AnnotationDemo.toString()
comments:Main method
*******************************************
Annotation in Method
'public static void com.somnus.annotation.AnnotationDemo.outdatedMethod()' : @java.lang.Deprecated()
Annotation in Method
'public static void com.somnus.annotation.AnnotationDemo.outdatedMethod()' : @com.somnus.annotation.MethodInfo(author=Somnus, revision=1, comments=deprecated method, date=June 12 2015)
Method with revision no 1 =
public static void com.somnus.annotation.AnnotationDemo.outdatedMethod()
comments:deprecated method
*******************************************
Annotation in Method
'public static void com.somnus.annotation.AnnotationDemo.genericsTest() throws java.io.FileNotFoundException' : @com.somnus.annotation.MethodInfo(author=Somnus, revision=10, comments=Main method, date=June 12 2015)
*******************************************

注解API很强大,被广泛应用于各种Java框架。如Spring,Hibernate,JUnit。

上一篇:基于spring@aspect注解的aop实现


下一篇:AOP经典2种配置演示样例