java since注解_java-注解

java注解

元注解(meta-annotation)

java5.0+

java.lang.annotation

@Target

作用：用于描述注解的使用范围。

取值：ElementType

值

使用范围

备注

TYPE

类、接口(包括注释类型)或枚举声明

FIELD

字段声明(包括枚举常量)

METHOD

方法声明

PARAMETER

形式化参数声明

CONSTRUCTOR

构造函数声明

LOCAL_VARIABLE

局部变量声明

ANNOTATION_TYPE

注释类型声明

PACKAGE

包装声明

TYPE_PARAMETER

类型参数声明

@since 1.8

TYPE_USE

使用类型

@since 1.8

@Retention

作用：用于描述注解的生命周期。(该Annotaion被保留的时间长短)

取值：RetentionPolicy

值

使用范围

备注

SOURCE

注释将被编译器丢弃。

CLASS

注释由编译器记录在类文件中但不需要由VM在运行时保留。

DEFAULT

RUNTIME

注释将被编译器记录在类文件中在运行时被VM保留，因此可以反射性地读取它们。

@Documented

作用：@Documented用于描述其它类型的annotation应该被作为被标注的程序成员的公共API，因此可以被例如javadoc此类的工具文档化。

取值：Documented是一个标记注解，没有成员。

@Inherited

作用：@Inherited阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class，则这个annotation将被用于该class的子类。

取值：Inherited是一个标记注解，没有成员。

备注：

类继承关系中，子类会继承父类使用的注解中被@Inherited修饰的注解 ；

接口继承关系中，子接口不会继承父接口中的任何注解；

类实现接口时不会继承任何接口中定义的注解 。

@Repeatable

@since 1.8

作用：在需要对同一种注解多次使用时，往往需要借助@Repeatable。

实例：一个人拥有多个身份。

@Target(ElementType.TYPE)

@Retention(RetentionPolicy.RUNTIME)

public @interface Persons {

Person[] value();

}

@Repeatable(Persons.class)

public @interface Person{

String role() default "";

}

@Person(role="CEO")

@Person(role="husband")

@Person(role="father")

@Person(role="son")

public class Man {

String name="";

}

//获取注解内容

if(Man.class.isAnnotationPresent(Persons.class)) {

Persons p2=Man.class.getAnnotation(Persons.class);

for(Person t:p2.value()){

System.out.println(t.role());

}

}

@Native

作用：@Native 作用在域上，用来表示域中的常量可能来自于本地代码。

常用内置注解

@Override

作用：父类的方法删除或修改后，编译器会提示错误信息。生命周期：源码阶段。

@Deprecated

作用：如果使用了弃用的方法，编译器将会发生警告。生命周期：运行时。

@SuppressWarnings

作用：告知编译器忽略产生的特殊警告。

自定义注解

使用@interface创建自定义注解。

自动继承java.lang.annotation.Annotation接口。

注解中的方法，实际是声明了一个配置参数，参数名称就是方法名，返回值类型就是参数的类型(返回值类型只能是基本类型、Class、String、enum、Annotation以及前面各类型的数组)。可以通过default来声明参数默认值。

注解中的方法，不允许使用protect、private修饰符，也无需加上public等修饰符，保持默认即可。这一点和接口类似。

自定义注解上需要打上前面的元注解，来描述注解的使用方式以及范围。

实例：

@Documented

@Target(ElementType.METHOD)

@Inherited

@Retention(RetentionPolicy.RUNTIME)

public @interface MethodInfo {

String author() default "";

String date();

int revision() default 1;

String comments();

}

//获取注解

try {

for (Method method : MethodInfoParsing.class.getClassLoader()

.loadClass("reflection.annotations.methodinfo.MethodInfoExample")

.getMethods()) {

if (method.isAnnotationPresent(MethodInfo.class)) {

try {

for (Annotation anno : method.getDeclaredAnnotations()) {

System.out.println("Annotation in method " + method + " : " + anno);

}

MethodInfo methodInfo = method.getAnnotation(MethodInfo.class);

if (methodInfo.revision() == 1) {

System.out.println("Method with revision 1 = " + method);

}

} catch (Throwable ex) {

ex.printStackTrace();

}

}

}

} catch (ClassNotFoundException e) {

e.printStackTrace();

}