注解(Annotation)的应用

 1 package cn.itcast.day2;
 2 /**
 3  * 此类是用来演示注解(Annotation)的应用的，注解也是JDK1.5新增加的特性之一
 4  * JDK1.5内部提供的三种注解是：@SuppressWarnings(":deprecation")、@Deprecated、@Override
 5  * @author 孤傲苍狼
 6  *
 7  */
 8 /**
 9  * 类名的命名是有讲究的，类名、属性名、变量名一般是名词，或者是形容词+名词，方法一般是动词，或者是动词+名词，
10  * 以AnnotationTest作为类名和以TestAnnotation作为类名是有区别的，
11  * 前者是注解的测试，符合名词的特征，后者是测试注解，听起来就是一个动作名称，是方法的命名特征
12  */
13 public class AnnotationTest {
14     /**
15      * @param args
16      */
17     @SuppressWarnings(":deprecation")
18     //这里就是注解，称为压缩警告，这是JDK内部自带的一个注解，一个注解就是一个类，在这里使用了这个注解就是创建了SuppressWarnings类的一个实例对象
19     public static void main(String[] args) {
20         System.runFinalizersOnExit(true);
21         //The method runFinalizersOnExit(boolean) from the type System is deprecated(过时的，废弃的)
22         //这里的runFinalizersOnExit()方法画了一条横线表示此方法已经过时了，不建议使用了
23     }
24     @Deprecated //这也是JDK内部自带的一个注解，意思就是说这个方法已经废弃了，不建议使用了
25     public static void sayHello(){
26         System.out.println("hi,孤傲苍狼");
27     }
28     @Override //这也是JDK1.5之后内部提供的一个注解，意思就是要重写(覆盖)JDK内部的toString()方法
29     public String toString(){
30         return "孤傲苍狼";
31     }
32 }

1 public @interface MyAnnotation{}

 1 package cn.itcast.day2;
 2 import java.lang.annotation.ElementType;
 3 import java.lang.annotation.Retention;
 4 import java.lang.annotation.RetentionPolicy;
 5 import java.lang.annotation.Target;
 6 /**
 7  * 这是一个自定义的注解(Annotation)类 在定义注解(Annotation)类时使用了另一个注解类Retention
 8  * 在注解类上使用另一个注解类，那么被使用的注解类就称为元注解
 9  * 
10  * @author 孤傲苍狼
11  * 
12  */
13 @Retention(RetentionPolicy.RUNTIME)
14 //Retention注解决定MyAnnotation注解的生命周期
15 @Target( { ElementType.METHOD, ElementType.TYPE })
16 //Target注解决定MyAnnotation注解可以加在哪些成分上，如加在类身上，或者属性身上，或者方法身上等成分
17 /*
18  * @Retention(RetentionPolicy.SOURCE)
19  * 这个注解的意思是让MyAnnotation注解只在java源文件中存在，编译成.class文件后注解就不存在了
20  * @Retention(RetentionPolicy.CLASS)
21  * 这个注解的意思是让MyAnnotation注解在java源文件(.java文件)中存在，编译成.class文件后注解也还存在，
22  * 被MyAnnotation注解类标识的类被类加载器加载到内存中后MyAnnotation注解就不存在了
23  */
24 /*
25  * 这里是在注解类MyAnnotation上使用另一个注解类，这里的Retention称为元注解。
26  * Retention注解括号中的"RetentionPolicy.RUNTIME"意思是让MyAnnotation这个注解的生命周期一直程序运行时都存在
27  */
28 public @interface MyAnnotation {
29 }

1 @ MyAnnotation 
2 public class AnnotationUse{
3 
4 }

 1 package cn.itcast.day2;
 2 @MyAnnotation
 3 //这里是将新创建好的注解类MyAnnotation标记到AnnotaionTest类上
 4 public class AnnotationUse {
 5     public static void main(String[] args) {
 6         // 这里是检查Annotation类是否有注解，这里需要使用反射才能完成对Annotation类的检查
 7         if (AnnotationUse.class.isAnnotationPresent(MyAnnotation.class)) {
 8             /*
 9              * MyAnnotation是一个类，这个类的实例对象annotation是通过反射得到的，这个实例对象是如何创建的呢？
10              * 一旦在某个类上使用了@MyAnnotation，那么这个MyAnnotation类的实例对象annotation就会被创建出来了
11              * 假设很多人考驾照，教练在有些学员身上贴一些绿牌子、黄牌子，贴绿牌子的表示送礼送得比较多的，
12              * 贴黄牌子的学员表示送礼送得比较少的，不贴牌子的学员表示没有送过礼的，通过这个牌子就可以标识出不同的学员
13              * 教官在考核时一看，哦，这个学员是有牌子的，是送过礼给他的，优先让有牌子的学员过，此时这个牌子就是一个注解
14              * 一个牌子就是一个注解的实例对象，实实在在存在的牌子就是一个实实在在的注解对象，把牌子拿下来(去掉注解)注解对象就不存在了
15              */
16             MyAnnotation annotation = (MyAnnotation) AnnotationUse.class
17                     .getAnnotation(MyAnnotation.class);
18             System.out.println(annotation);// 打印MyAnnotation对象，这里输出的结果为：@cn.itcast.day2.MyAnnotation()
19         }
20     }
21 }

1 @Documented
2 @Retention(value=RUNTIME)
3 public @interface Deprecated

1 @Target(value=METHOD)
2 @Retention(value=SOURCE)
3 public @interface Override

1 @Target(value={TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE})
2 @Retention(value=SOURCE)
3 public @interface SuppressWarnings

1 @Target(value={TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE})
2 @Retention(value=SOURCE)
3 public @interface SuppressWarnings