注解(Annotation)
JDK5.0新增 — 注解(Annotation),也叫元数据。一般以@开头与类、接口、枚举是在同一个层次,它可以声明在包、类、字段、方法、局部变量、方法参数等的前面,用来对这些元素进行说明,注释。
内置注解
@Override 检测重写
@Deprecated 已过时, 只是一个标志, 还是能够使用
@SuppressWarnings(“all”) 抑制编译器生成警告信息
元注解
@Documented
表示是否将我们的注解添加在Javadoc文档中
@Retention
表示注解保留到什么地方还有效
●只在源码阶段保留:@Retention(value = RetentionPolicy.SOURCE)
●保留到编译进行的时候:@Retention(value = RetentionPolicy.CLASS)
●保留到程序运行时:@Retention(value = RetentionPolicy.RUNTIME)
@Target
表示我们的注解可以用在那些地方
@Target(value = {ElementType.METHOD,ElementType.TYPE})
● ElementType.CONSTRUCTOR:用于描述构造器
● ElementType.FIELD:成员变量、对象、属性(包括enum实例)
● ElementType.LOCAL_VARIABLE:用于描述局部变量
● ElementType.METHOD:用于描述方法
● ElementType.PACKAGE:用于描述包
● ElementType.PARAMETER:用于描述参数
● ElementType.TYPE:用于描述类、接口(包括注解类型) 或enum声明
@Inherited
子类可以继承父类中的该注解
自定义注解
/** 自定义一个注解 */
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation{
// 注解的定义格式 :参数类型 + 参数名()
String name();
// 默认值为-1,代表不存在
int id() default -1;
// default:默认值,使用该注解时参数可以省略不写
String[] header() default {};
}
@MyAnnotation2(name = "琴")
public void test() {}
补充
若注解中只有一个参数,且参数名为value时,使用该注解时value可省略不写