注解
①注解是放在Java源码的类、方法、字段、参数前的一种特殊“注释”
②注释会被编译器直接忽略,注解则可以被编译器打包进入class文件,因此,注解是一种用作标注的“元数据”(讲的通俗一点,就是为这个方法增加的说明或功能。)
@Override//例如:@Overvide这个注解就用来说明这个方式重写父类的
public String toString() {
return "Hello";
}
注解的作用
①注解本身对代码逻辑没有任何影响,如何使用注解完全由工具决定
②第一类是由编译器使用的注解,例如:@Override(让编译器检查该方法是否正确地实现了覆写)这类注解不会被编译进入.class文件,它们在编译后就被编译器扔掉了。
③第二类是由工具处理.class文件使用的注解,比如有些工具会在加载class的时候,对class做动态修改,实现一些特殊的功能。这类注解会被编译进入.class文件,但加载结束后并不会存在于内存中。这类注解只被一些底层库使用,一般我们不必自己处理。
④第三类是在程序运行期能够读取的注解,它们在加载后一直存在于JVM中,这也是最常用的注解。例如,一个配置了@PostConstruct的方法会在调用构造方法后自动被调用(这是Java代码读取该注解实现的功能,JVM并不会识别该注解)。
⑤定义一个注解时,还可以定义配置参数。
⑥配置参数可以包括:所有基本类型;String;枚举类型;数组。
⑦因为配置参数必须是常量,所以,上述限制保证了注解在定义时就已经确定了每个参数的值。
⑧注解的配置参数可以有默认值,缺少某个配置参数时将使用默认值。
⑨大部分注解会有一个名为value的配置参数,对此参数赋值,可以只写常量,相当于省略了value参数。
//@Check是一个注解
public class Hello {
@Check(min=0, max=100, value=55)//明确定义了三个参数
public int n;
@Check(value=99)//只定义了value
public int p;
@Check(99) // @Check(value=99)省略了value参数,只有他能这么写
public int x;
@Check//所有参数都为默认值
public int y;
}
定义注解
①Java语言使用@interface语法来定义注解(Annotation)
②注解中的每个方法表示一个配置参数,返回类型即是参数类型,可以通过default标识参数默认值。
③最常用的参数应当命名为value
public @interface Report {
int type() default 0;
String value() default "";
}
元注解
①有一些注解可以修饰其他注解,这些注解就称为元注解。
②Java标准库已经定义了一些元注解,我们只需要使用元注解,通常不需要自己去编写元注解。
下面是Java提供的四种元注解
如何自定义注解Annotation
第一步,用@interface定义注解:
public @interface Report {
}
第二步,添加参数、默认值:
public @interface Report {
int type() default 0;
String level() default "info";
String value() default "";
}
把最常用的参数定义为value(),推荐所有参数都尽量设置默认值。
第三步,用元注解配置注解:
@Target(ElementType.TYPE)//必须设置@Target来指定Annotation可以应用的范围
@Retention(RetentionPolicy.RUNTIME)//便于运行期读取该Annotation
public @interface Report {
int type() default 0;
String level() default "info";
String value() default "";
}
其中,必须设置@Target和@Retention,@Retention一般设置为RUNTIME,因为我们自定义的注解通常要求在运行期读取。一般情况下,不必写@Inherited和@Repeatable。