Annotation 是从 JDK5.0 开始引入的新技术
Annotation 的作用
Annotation 的格式
@name
在代码中存在,还可以添加一些参数值,例如:@SuppressWarnings(value = "unchecked")
Annotation 在哪里使用?
@Override
:定义在java.lang.Override
中,此注解只适用于修辞方法,表示一个方法声明打算重写超类中的另一个方法声明
@Deprecated
:定义在java.lang.Deprecated
中,此注解可以用于修饰方法、属性、类,表示不鼓励程序员使用这些元素,通常是因为它很危险或者存在更好的选择
@SuppressWarnings
:定义在java.lang.SuppressWarnings
中,用来抑制编译时的警告信息,与前两个注解不同的是需要添加一个参数才能正确使用,这些参数都是已经定义好了的,选择性使用即可
@SuppressWarnings("all")
@SuppressWarnings("unchecked")
@SuppressWarnings(value = {"unchecked", "deprecation"})
元注解的作用:负责注解其他注解
Java 定义了 4 个标准的 meta-annotation 类型,他们被用来提供对其他 annotation 类型作说明
这些类型和它们所支持的类在java.lang.annotation
包中可以找到:@Target
、@Retention
、@Documented
、@Inherited
@Target
:用于描述注解的使用范围 (即:被描述的注解可以用在什么地方)@Retention
:表示需要在什么级别保存该注解信息,用于描述注解的生命周期 (SOURCE < CLASS < RUNTIME)@Documented
:说明该注解将被包含在 Javadoc 中@Inherited
:说明子类可以继承父类中的该注解xxxxxxxxxx
// Target 表示该注解可以用在什么地方:类,方法
value = {ElementType.TYPE, ElementType.METHOD}) (
// Retention 表示该注解在什么地方还有效:SOURCE < CLASS < RUNTIME
value = RetentionPolicy.RUNTIME) (
// Documented 表示该注解将生成在 Javadoc 中
// Inherited 表示子类可以继承该注解
public @interface MyAnnotation {
}
使用@interface
自定义注解时,自动继承java.lang.annotation.Annotation
接口
@interface
用来声明一个注解,格式:public @interface name {}
default
来声明参数的默认值value
value = {ElementType.TYPE, ElementType.METHOD}) (
value = RetentionPolicy.RUNTIME) (
public @interface MyAnnotation {
// 定义注解参数的格式:参数类型 + 名字 + ()
String name();
int age() default 0;
int id() default -1;
String[] schools() default {"school1", "school2"};
}
public class MyAnnotationTest {
name = "张三", age = 18, id = 1, schools = {"school3"}) (
public void test01() {
}
name = "张三") (
public void test02() {
}
}