什么是注解
注解:Annotation,Java标注,是JDK5引入的一种机制
Java中类,方法,变量,参数,包都可以被标注
元注解:专门给注解加的注解 (如果不学习反射,注解没什么作用)
我们发现注解中可以有方法
- 定义方法的格式:
String name();
- 可以有默认值,也可以没有,如果没有默认值,在使用的时候必须添加对应的值,如果需要有默认值,使用default添加
- 如果想在使用的时候不指定具体的名字,使用
value
注解类
在Java的整个注解体系中,有3个非常重要的主干类
Annotation
接口,定义一些常用的方法ElementType
枚举,它用来指定注解的类型,注解要用在哪里RetentionPolicy
枚举,它用来指定注解的策略,不同类型的策略指定的注解的作用域不同SOURCE
,注解仅存在于编译机处理期间,编译期处理完毕之后,这个注解就没用了CLASS
,注解在.class文件中依然有效RUNTIME
,编译期是不起作用的,只有在运行期才由JVM读取。
Java自带的注解
4个注解在java.lang.annotation
剩下的6个在java.lang
作用在代码上的注解
@Override
,检查该方法是否是重写方法,如果发现其父类,或者是引用的接口中没有该方法,会报错@Deprecated
,标记的方法变为过时的方法@SuppressWarnings
,让编辑器去忽略警告- all:忽略所有警告
- boxing:忽略装箱、拆箱警告
- rawtypes:使用生成时没有指定数据类型
- unchecked:忽略没有进行类型检查操作的警告
- unused:忽略没有使用的警告
@SafeVarargs
,JDK7开始支持,支持忽略任何使用参数为泛型变量的方法,或者构造器产生的警告@FunctionalInterface
,JDK8开始支持,标识一个接口为函数式接口@Repeatable
,JDK8开始支持,标识某个注解可以在同一个声明上使用多次
元注解:
@Retention
:标识这个注解作用域@Documented
:标记这个注解是否包含在用户文档中@Target
:这个注解可以修饰哪些信息@Inherited
:如果一个类用上了@Inherited注解,那么其子类也会继承这个注解
测试类
public class Ch01 {
@Deprecated
public void info() {
}
@MyAnnotation(20) // age=20
public void show() {
}
@Override
public String toString() {
return "Ch01{}";
}
}
自定义注解类
import java.lang.annotation.*;
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyAnnotation {
String name() default "tom";
int value();
// int age();
}
宁静常不仅决定于声音,而包括自心的感觉。在群众之中所获得的宁静,有时甚于一人独处,因为那种宁静更具有庄严、神圣的力量。 ——刘墉