二十七、JDK1.5新特性---Annotation
上篇文章介绍了反射的一些基础知识以及应用案例，本文将介绍jdk 1.5 出现的新特性——Annotation也就是我们所说的注解，即使用注释的方式加入一些程序的信息。
注解相当于一种标记，在程序中加了注解就等于为程序打上了某种标记，没加，则等于没有某种标记。
Java.lang.annotation. Annotation 接口是所有的Annotation都必须实现的接口。下面我们将从系统的三个内建Annotation开始学习。
内建Annotation
♥ @Overrider ：复写的Annotation
♥ @Deprecated : 不赞成使用的Annotation，通常表示过时
♥ @SuppressWarnings ：压制安全警告的Annotation
Overrider作用与用法
表示当前方法是在复写父类的方法，当我们复写父类的一个方法时可以在方法上面写上@ Overrider，其作用是验证该方法是否拼写错误，如果编写错误则编译失败。从而提高了程序的安全性
Deprecated作用与用法
通常表示当前方法不建议使用或者是已经因为某种原因已经过时，现在有更好的方法，从而保证程序的健壮性
SuppressWarnings作用与用法
用于压制强制警告信息，以之前介绍的泛型操作为例，在泛型中如果没有指定泛型类型则在编译时期会出现安全警告，而如果加上@SuppressWarnings则可以将安全警告强制压制。
自定义Annotation
当我们系统Annotation不能满足我们的需求时，我们就可以自定义Annotation。
格式
[public ] @interface Annotation 名称{ 数据类型 变量名称(); }
按照上述格式自定义一个简单的Annotation。
public @interface MyDefaultAnnotationNoneParam{ }
之后就可以直接在程序中使用@ MyDefaultAnnotationNoneParam了。
此外还可以向Annotation中设置参数，使用变量接受参数
public @interface MyDefaultAnnotationSingleParam{ public String value() ; // 接收设置的内容 }
在使用的时候就必须指定变量的值
@ MyDefaultAnnotationSingleParam("月芽之上")
class Demo{
}
或者也可以使用明确的标记，表示内容赋值给那个参数
public @interface MyDefaultAnnotationMoreParam{ public String key(); public String value() ; // 接收设置的内容 }
此时Annotation在使用的时候需要设置两个参数。一个是key、一个事value.
@ MyDefaultAnnotationMoreParam (key="月芽之上",value="李占祥") class Demo{ }
也可以设置一个数据进去
public @interface MyDefaultAnnotationArrayParam{ public String[] value() ; // 接收设置的内容 }
接收的内容本身是一个数组类型，需要传递数据，这一点类似于SuppressWarnings
@ MyDefaultAnnotationArrayParam ({ "月芽之上","李占祥"})
class Demo{
}
以上所定义的全部的Annotation中有一个特点，就是所有的参数内容需要在使用注释的时候设置上去，那么也可以为一个参数设置默认的内容，在声明的时候使用default即可。
public @interface MyDefaultAnnotationParam{ public String key() default "月芽之上"; public String value()default "李占祥" ; // 接收设置的内容 }
如果设置了默认值，那么在使用Annotation时就可以不设置内容了（使用默认值）。
在以上操作中，对于一个Annotation而言 有时候会取固定的取值范围，只能取固定的几个值，那么这时候就需要依靠枚举来实现。
public enum MyName{ // 定义枚举类型 月芽之上,李占祥; }
以后的Annotation的取值，只能从这两个值中间去取。
public @interface MyDefaultAnnotationEnum{ public String name() default MyName."月芽之上"; }
此时以上的Annotation已经设置好了一个枚举中的内容作为默认值，那外部在使用此Annotation的时候也需要从枚举的固定值中取。
Retention和RetentionPolicy
在定义Annotation时可以使用Retention定义一个Annotation的保存范围，此Annotation的定义如下：
@Documented
@Retention(vale=RUNTIME)
@Target(vale=ANNOTATION_TYPE)
public @interface Retention{
RetentionPolicy value();
}
在以上的Retention定义中定义了一个RetentionPolicy的变量，此变量用于指定Annotation的保存范围。范围分为三种：
在三个范围中，最需要关心的即使RUNTIME范围，因此此时在执行的时候气作用。
通过反射取得Annotation内容
一个Annotation如果要想变得有意义，就必须结合反射机制取得Annotation中设置的全部内容。
取得Annotation内容的常见方法
package reflectannotation ; public class SimpleBeanOne{ @SuppressWarnings("unchecked") @Deprecated @Override public String toString(){ return "Hello LiXingHua!!!" ; } }
同时设置了三个Annotation，那么此时注意，只有Deprecated的Annotation定义的范围是RUNTIME范围，所以此时通过反射只能取得一个。
import java.lang.annotation.Annotation ; import java.lang.reflect.Method ; public class ReflectDemo01{ public static void main(String args[]) throws Exception{ // 所有异常抛出 Class <?> c = null ; c = Class.forName("reflectannotation.SimpleBeanOne") ; Method toM = c.getMethod("toString") ; // 找到toString()方法 Annotation an[] = toM.getAnnotations() ; // 取得全部的Annotation for(Annotation a:an){ // 使用 foreach输出 System.out.println(a) ; } } }
以上的操作代码实际是通过三个系统内建的Annotation完成的，那么特可以自定义一个Annotation
package reflectannotation ; import java.lang.annotation.Retention ; import java.lang.annotation.RetentionPolicy ; @Retention(value=RetentionPolicy.RUNTIME) // 此Annotation在类执行时依然有效 public @interface MyDefaultAnnotationReflect{ public String key() default "月芽之上" ; public String value() default "李占祥" ; }
以上的Annotation范围是在运行时依然有效，下面定义一个类使用该Annotation。
package reflectannotation ; public class SimpleBeanTwo{ @SuppressWarnings("unchecked") @Deprecated @Override @MyDefaultAnnotationReflect(key="月芽之上",value="李占祥") public String toString(){ return "Hello lzx!!!" ; } }
下面通过反射取得指定的Annotation，因为现在唯一设置的内容就是MyDefaultAnnotationReflect
import reflectannotation.MyDefaultAnnotationReflect ; import java.lang.annotation.Annotation ; import java.lang.reflect.Method ; public class ReflectDemo02{ public static void main(String args[]) throws Exception{ // 所有异常抛出 Class <?> c = null ; c = Class.forName("reflectannotation.SimpleBeanTwo") ; Method toM = c.getMethod("toString") ; // 找到toString()方法 if(toM.isAnnotationPresent(MyDefaultAnnotationReflect.class)){ // 判断是否是指定的Annotation MyDefaultAnnotationReflect mda = null ; mda = toM.getAnnotation(MyDefaultAnnotationReflect.class) ; // 得到指定的Annotation String key = mda.key() ; // 取出设置的key String value = mda.value() ; // 取出设置的value System.out.println("key = " + key) ; System.out.println("value = " + value) ; } } }
