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{ }}