33了解和入门注解的应用34 注解的定义与反射调用35为注解增加各种属性

 

33  了解和入门注解的应用

l  先通过@SuppressWarnings的应用让大家认识和了解一下注解：

Ø  通过System.runFinalizersOnExit(true);的编译警告引出@SuppressWarnings("deprecation")

l  @Deprecated

Ø  直接在刚才的类中增加一个方法，并加上@Deprecated标注，在另外一个类中调用这个方法。

l  @Override

Ø  public boolean equals(Reflect other)方法与HashSet结合讲解

l  总结：

Ø 注解相当于一种标记，在程序中加了注解就等于为程序打上了某种标记，没加，则等于没有某种标记，以后，javac编译器，开发工具和其他程序可以用反射来了解你的类及各种元素上有无何种标记，看你有什么标记，就去干相应的事。标记可以加在包，类，字段，方法，方法的参数以及局部变量上。

Ø 看java.lang包，可看到JDK中提供的最基本的annotation。

 

34 注解的定义与反射调用

 

注解就相当于一个你的源程序中要调用的一个类，要在源程序中应用某个注解，得先准备好了这个注解类。就像你要调用某个类，得先有开发好这个类。

自定义注解及其应用：

l 定义一个最简单的注解：public @interface MyAnnotation {}

l 把它加在某个类上：@MyAnnotation public class AnnotationTest{}

l 用反射进行测试AnnotationTest的定义上是否有@MyAnnotation 

l 根据发射测试的问题，引出@Retention元注解的讲解，其三种取值：RetetionPolicy.SOURCE、RetetionPolicy.CLASS、RetetionPolicy.RUNTIME;分别对应：java源文件-->class文件-->内存中的字节码。

注解的默认值是在class阶段。

@Override是给javac看的，编译完就没有价值了，也就说只有在源代码中有用，所以属性值是@Retention(value=SOURCE)

@SuppressWarnings的属性值是@Retention(value=SOURCE)

@Deprecated的属性值是@Retention(value=RUNTIME)

PS：class文件中的东西不是字节码，只有经过一系列的检查后加载到内存中才是字节码。

l  演示和讲解@Target元注解 

Ø  Target的默认值为任何元素，设置Target等于ElementType.METHOD，原来加在类上的注解就报错了，改为用数组方式设置{ElementType.METHOD,ElementType.TYPE}就可以了。 

l  <!--[endif]-->元注解以及其枚举属性值不用记，只要会看jdk提供那几个基本注解的API帮助文档的定义或其源代码，按图索骥即可查到，或者直接看java.lang.annotation包下面的类。

package cn.zyj35.review;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
 
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD,ElementType.TYPE})
public @interface ItcastAnnotation {
 
}

 

 

 

package cn.zyj35.review;
@ItcastAnnotation()
public class AnnotationTest {
   @SuppressWarnings("deprecation")
   public static void main(String[] args) {
     
      System.runFinalizersOnExit(true);
            //用反射进行测试的代码：
//检查返回的注解对象的类名，发现它其实是一个代理。
      if(AnnotationTest.class.isAnnotationPresent(ItcastAnnotation.class)){
         ItcastAnnotation annotation = (ItcastAnnotation)AnnotationTest.class.getAnnotation(ItcastAnnotation.class);
         System.out.println(annotation);
      }
 
   }
   @Deprecated
   public static void sayHello(){
      System.out.println("hi,传智播客");
   }
}

 

 

 

35为注解增加各种属性

为注解增加基本属性：

l  什么是注解的属性

Ø  一个注解相当于一个胸牌，如果你胸前贴了胸牌，就是传智播客的学生，否则，就不是。如果还想区分出是传智播客哪个班的学生，这时候可以为胸牌在增加一个属性来进行区分。加了属性的标记效果为：@MyAnnotation(color="red")

l  定义基本类型的属性和应用属性：

Ø  在注解类中增加String color();

Ø  @MyAnnotation(color="red")

l  用反射方式获得注解对应的实例对象后，再通过该对象调用属性对应的方法

Ø  MyAnnotation a = (MyAnnotation)AnnotationTest.class.getAnnotation(MyAnnotation.class);

Ø  System.out.println(a.color());

Ø  可以认为上面这个@MyAnnotation是MyAnnotaion类的一个实例对象

l  为属性指定缺省值：

Ø  String color() default "yellow";

l  value属性：

Ø  String value() default "zxx";

Ø  如果注解中有一个名称为value的属性，且你只想设置value属性（即其他属性都采用默认值或者你只有一个value属性），那么可以省略value=部分，例如：@MyAnnotation("lhm")。

 

为注解增加高级属性：

l  数组类型的属性

Ø  int [] arrayAttr() default {1,2,3};

Ø  @MyAnnotation(arrayAttr={2,3,4})

Ø  如果数组属性中只有一个元素，这时候属性值部分可以省略大括

l  枚举类型的属性

Ø  EnumTest.TrafficLamp lamp() ;

Ø  @MyAnnotation(lamp=EnumTest.TrafficLamp.GREEN)

l  注解类型的属性：

Ø  MetaAnnotation annotationAttr() default @MetaAnnotation("xxxx");

Ø  @MyAnnotation(annotationAttr=@MetaAnnotation(“yyy”) )

Ø  可以认为上面这个@MyAnnotation是MyAnnotaion类的一个实例对象，同样的道理，可以认为上面这个@MetaAnnotation是MetaAnnotation类的一个实例对象，调用代码如下：

       MetaAnnotation ma =  myAnnotation.annotationAttr();

       System.out.println(ma.value());

l  注解的详细语法可以通过看java语言规范了解，即看java的language specification。

 

Ps：

注解的属性可以是八个，基本数据类型，String类型，Class类型，enum类型，annotation类型，和前面所有的数组类型。

Ps：

枚举和注解都是特殊的类，不能用new 创建它们的实例对象，创建枚举的实例对象就是在其中增加元素。

在程序中如何创建出一个注解的实例对象啊？直接用@放上一个标记即可

MetaAnnotation注解的定义：

public @interface MetaAnnotation {

   String value();

}

 

例子：

package cn.zyj35.review;
 
public enum TrafficLamp {
    //内部类。如果枚举元素后面没有大括号对，那是不会生成内部类的。
   RED(30){
      public  TrafficLamp nextLamp(){
         return GREEN;
      }
   },
   GREEN(45){
      public  TrafficLamp nextLamp(){
         return YELLOW;
      }       
   },
   YELLOW(5){
      public  TrafficLamp nextLamp(){
         return RED;
      }       
   };
   public abstract TrafficLamp nextLamp();
   private int time;
   private TrafficLamp(){}
   private TrafficLamp(int time){this.time = time;}
   public String toString(){
      if (this==RED) {
         return "红";
      } else if(this==GREEN){
         return "绿";
      }else{
         return "黄";
      }
   }
}

 

 

 

package cn.zyj35.review;
public @interface MetaAnnotation {
   String value();
}

 

 

 

package cn.zyj35.review;
 
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
 
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD,ElementType.TYPE})
public @interface ItcastAnnotation {
   int num() default 1;
   String color() default "blue";
   String value();
   int[] arrayAttr() default {3,4,4};
   TrafficLamp lamp() default TrafficLamp.RED;
   MetaAnnotation annotationAttr() default @MetaAnnotation("lhm");
   Class strClass() default String.class;
 
}

 

 

package cn.zyj35.review;
 
import java.lang.reflect.Method;
 
@ItcastAnnotation(annotationAttr=@MetaAnnotation("flx"),color="red",value="abc",arrayAttr=1)
public class AnnotationTest {
   @SuppressWarnings("deprecation")
   @ItcastAnnotation("方法注解")
   public static void main(String[] args) throws  Exception {
     
      System.runFinalizersOnExit(true);
      //用反射进行测试的代码：
      //检查返回的注解对象的类名，发现它其实是一个代理。
      if(AnnotationTest.class.isAnnotationPresent(ItcastAnnotation.class)){
         ItcastAnnotation annotation = (ItcastAnnotation)AnnotationTest.class.getAnnotation(ItcastAnnotation.class);
         System.out.println(annotation);
         System.out.println(annotation.num());
         System.out.println(annotation.color());
         System.out.println(annotation.value());
         System.out.println(annotation.arrayAttr().length);//int[]是Object，不是Object[]
         System.out.println(annotation.lamp().nextLamp().name());
         System.out.println(annotation.annotationAttr().value());
         System.out.println(annotation.strClass().toString());
      }
     
      Method mainMethod = AnnotationTest.class.getMethod("main", String[].class);
      ItcastAnnotation annotation2 = (ItcastAnnotation)mainMethod.getAnnotation(ItcastAnnotation.class);
      System.out.println(annotation2.value());
   }
 
   @Deprecated
   public static void sayHello(){
      System.out.println("hi,china");
   }
}