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();
}

剑指 Offer