且构网

分享程序员开发的那些事...
且构网 - 分享程序员编程开发的那些事

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

更新时间:2022-09-14 19:10:33

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. 可以在自定义的注释类型的声明中添加注释,即注释的元注释。Java2个常用的内置元注释:

* @Target指定Annotation类型可以应用的程序元素,程序元素的类型由java.lang.annotation.ElementType枚举类定义。如ElementType.METHOD表示该注释类型只能用于方法声明中。

* @RetentionJava编译器处理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

};

//定义数据类型不需要定义gettersetter方法

//只需要定义一个以成员名称命名的方法,并指定返回类型为需要的数据类型

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

}

}




本文转自远哥博客园博客,原文链接:http://www.cnblogs.com/taven/archive/2011/12/17/2291463.html,如需转载请自行联系原作者