在spring、hibernate等流行的开源框架中,基本上来进行配置的方式有两种,一种是基于配置文件的配置,注入applicationContext.xml或者是hbm.xml,同样另一种方式则是基于注解的配置,可以说使用注解的配置相当的简洁明了,所以这里就再来回顾一下什么是Annotation。
一、Annotation基本概念
Annotation是jdk5以后出现的新特性,在jdk中,其内置了许多自己的Annotation,例如@Override,@SuppresWarning,@Deprecated等等,其中一些Annotation是标志性的Annotation,例如@Override就是表示这个类要重写父类的方法。
我们首先要清楚的知道一点,其实Annotation和Class、Interface这些一样,都是类级别的,而且我们创建的每一个Annotation都默认的继承了java.lang.annotation.Annotation这个接口,注意:如果一个接口继承了这个Annotation接口,那么这个接口并不是一个Annotation。
我们接下来自己创建一个简单的Annotation:
public @interface MyAnnotation { String value(); String name() default "xiaoluo"; }
这样就定义了我们自己的一个Annotation了,它的标识符就是 @interface,同样,Annotation里面可以定义我们的属性,例如,上面的例子我就定义了两个String类型的属性,一个是value属性,一个是name属性,注意:在Annotation里定义属性,属性后面都要加上括号。同时我们还可以给Annotation的属性设置默认值,通过 default 这个关键字来设置默认值,接下来我们就可以使用我们自己定义的Annotation了:
@MyAnnotation(value="hello", name="world")public class AnnotationTest { @MyAnnotation("xiaoluo") public void hello() { System.out.println("This is my Annotation!"); } }
我们看到,这个时候我们就可以在类上面、方法上面使用我们的Annotation了,注意:在自己定义的Annotation中,如果为其设置了属性,则我们必须要给其属性赋值。
在上面的例子中,我们看到 @MyAnnotation(value="hello", name="world") 这里就是给其 value属性和name 属性赋值,而在下面的那个Annotation中:
@MyAnnotation("xiaoluo"),我们没有指定其属性名,那么它是赋值给谁呢?在Annotation中,如果我们定义了一个 value 属性,那么我们在使用该Annotation,给其赋值时,可以不用写出属性的名字,即value。
怎么样,简单吧,这样我们就定义并使用了我们的Annotation了。
二、Retention和RetentionPolicy
在初步了解了Annotation之后,我们再来看看Retention和RetentionPolicy这两个概念,Retention的中文意思是,保留、持有,同样,Retention也是一个Annotation,通过这个注解,我们可以指定我们自己定义的Annotation的保留范围,其默认值是有三个,是枚举类型的值,RetentionPolicy.CLASS(这个是Retention的默认值,表示这个Annotation会被编译到class文件当中), RetentionPolicy.RESOURCE(这个表示Annotation仅仅在编译的时候有效,起到提示作用,并不会被编译到class文件当中去), RetentionPolicy.RUNTIME(这个表示Annotation不仅会被编译到class文件当中,而且会在JVM运行中也可以得到这个Annotation,这样我们就可以通过反射来得到Annotaion,并对其进行一些操作了),我们来看看jdk自带的一些Annotation,其Retention分别是什么:
@Retention(value=SOURCE)public @interface Override @Retention(value=SOURCE)public @interface SuppressWarnings @Retention(value=RUNTIME)public @interface Deprecated
我们看到,Deprecated的RetentionPolicy是RUNTIME的,这样我们可以通过反射在运行时得到其Annotation,接下来我们自己来指定我们刚定义的MyAnnotation为RUNTIME:
@Retention(RetentionPolicy.RUNTIME)public @interface MyAnnotation { String value(); String name() default "xiaoluo"; }
这个时候,我们定义的Annotation就会被编译到class文件当中去,并且在运行时可以得到它,接下来我们来通过一个例子来看看如何使用反射机制得到我们的Annotation以及我们设置的属性值,java的API指定了访问得到Annotation的方法,我们的Class,Method,Constructor等等这些都默认实现了 AnnotatedElement 这个接口,这个接口定义了四个常用的方法:
<T extends Annotation> T getAnnotation(Class<T> annotationClass) // 根据Annotation.class得到这个Annotation Annotation[] getAnnotations() // 得到一个Annotation数组 Annotation[] getDeclaredAnnotations() // 也是得到一个Annotation数组boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) // 判断是否为被当前的Annotation所标识
@MyAnnotation("hello")public class AnnotationTest { @MyAnnotation(value="xiaoluo", name="welcome") public void hello() { System.out.println("This is my Annotation!"); } public static void main(String[] args) throws Exception { // 得到AnnotationTest这个类的 class 对象 Class<AnnotationTest> clazz = AnnotationTest.class; // 得到AnnotationTest的一个实例对象 AnnotationTest test = (AnnotationTest)clazz.newInstance(); // 得到方法名为hello的Method对象 Method method = clazz.getMethod("hello", new Class[]{}); // 判断hello这个方法是否被MyAnnotation这个注解所标记 if(method.isAnnotationPresent(MyAnnotation.class)) { // 得到我们的MyAnnotation这个注解 MyAnnotation myAnnotation = (MyAnnotation)method.getAnnotation(MyAnnotation.class); System.out.println(myAnnotation.name() + ", " + myAnnotation.value()); method.invoke(test, new Object[]{}); } } }
我们来看看,因为我们的@MyAnnotation设置了其RetentionPolicy为RUNTIME,所以我们可以在通过反射在运行时得到该Annotation对象,结果输出为:
welcome, xiaoluo This is my Annotation!
通过这个例子,我想大家应该知道了RecentPolicy的三个值的含义了吧,我们都可以设置其为RUNTIME,这样就可以在运行时对其进行判断来处理我们的业务逻辑了
三、Target和ElementType
最后我们来看看Target和ElementType这两个东东,Target这个也是一个注解,这个Annotation是用来指定我们的Annotation可以标志的范围,例如定义在类上,定义在方法上等等,其value就是通过ElementType来指定的,我们来看看ElementType有哪些值:
ANNOTATION_TYPE
我们也可以在刚才定义的MyAnnotation上设置我们的Target:
@Target({ElementType.TYPE, ElementType.METHOD}) @Retention(RetentionPolicy.RUNTIME)public @interface MyAnnotation { String value(); String name() default "xiaoluo"; }
表示MyAnnotation可以定义在类上还有方法上,如果在其他地方定义该注解,则会编译不通过
好了,Annotation的知识基本就是这些了,主要讲解了Annotation的基本概念以及其的一些特性