JDK5.0新特性系列---9.注释功能Annotation

 

import java.lang.annotation.ElementType;
import java.lang.annotation.Target;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
/**关键技术
 * 1.Java常用的内置注释
 *     @Override放在方法的修饰符前，表示该方法覆盖了父类的同名同参数方法，如果该方法没有覆盖父 类的方法而使用了该注释，则编译器会报错
 *     @Deprecated放在变量和方法的访问修饰符前，表示该变量或者方法已经不推荐使用，通常是因为它很危险或者存在更好的选择。
 * 2.可以自定义注释类型，与enum定义枚举类型一样，使用@interface定义注释类型
 * 3. 能在自定义的注释中定义其它类、属性和方法。定义属性时，以属性名为方法名，以属性类型为方法的返回值类型，方法后接default关键字表示属性的默认值。如"String name();"表示该注释类型具有name属性，类型为String;而"int age() default 20;"表示该注释具有age属性，类型为int，默认值为20.
 * 4. 可以在自定义的注释类型的声明中添加注释，即注释的元注释。Java有2个常用的内置元注释：
 *    @Target指定Annotation类型可以应用的程序元素，程序元素的类型由java.lang.annotation.ElementType枚举类定义。如ElementType.METHOD表示该注释类型只能用于方法声明中。
 *    @Retention和Java编译器处理Annotation类型的方式有关，这些方式由java.lang.annotation.RetentionPolicy枚举值定义。如RetentionPolicy.RUNTIME表示该注释类型 将被编译成class文件
 *    @Document指明需要在Javadoc中包含注释(默认是不包含的)
 */
public class AnnotationData {
                   @Deprecated private String name;
                   public AnnotationData(String name){
                                      this.name = name;
                   }
                  
                   //方法声明中使用了内置的@Override元数据，表示该方法覆盖了父类的同名同参数方法
                   //如果父类不存在该方法，则编译不会通过
                   @Override public String toString(){
                                      return super.toString() + this.name;
                   }
                   @Override public int hashCode(){
                                      return toString().hashCode();
                   }
                  
                   /**方法中使用了内置的@Deprecated元数据，表示该方法已经不被推荐使用了*/
                   @Deprecated public String getName(){
                                      return name;
                   }
                   public String getAnnotationDataName(){
                                      return this.name;
                   }
 
                   //下面定义元数据类型
                   //使用@interface声明Annotation类型
                   public @interface MyAnnotation{
                                      //在元数据中可以定义其它类
                                      public enum Severity{
                                                         CRITICAL,IMPORTANT,TRIVIAL,DOCUMENT
                                      };
                                      //定义数据类型不需要定义getter和setter方法
                                      //只需要定义一个以成员名称命名的方法，并指定返回类型为需要的数据类型
                                      //default关键字为Annotation类型的成员设置默认值
                                      Severity severity() default Severity.IMPORTANT;
                                      String item();
                                      String assignedTo();
                                      String dateAssigned();
                   }
                   //使用自定义的Annotation类型，在使用时，
                   //如果Annotation类型在其他的包下，需要与使用类一样，import它
                   @MyAnnotation(severity = MyAnnotation.Severity.CRITICAL,
                                                           item = "Must finish this method carefully",
                                                           assignedTo = "Programmer A",
                                                           dateAssigned = "2006/09/10")
                   public void doFunction(){
                                      //do something
                   }
                  
                   //下面再定义一个Annotation类型，使用了元数据的元数据
                   //@Retention(RetentionPolicy.RUNNTIME)这个meta-annotation
                   //表示了此类型的annotation将编译成class文件，而且还能被虚拟机读取
                   //而@Target(ElementType.METHOD)表示此类型的annotation只能用于修饰方法声明
                   @Retention(RetentionPolicy.RUNTIME)
                   @Target(ElementType.METHOD)
                   public @interface MyNewAnnotation{
                                     
                   }
}