什么是注解
Annotation是JDK5.0开始引入的新技术
Annotation的作用
- 不是程序本身,可以对程序做出解释(这一点和注释没有什么区别)
- 可以被其它程序,比如编译器读取
Annotation的格式
- 注解以
@注释名
在代码中存在的,还可以添加一些参数值 - 例如:
@SuppressWarnings(value = "unchecked")
Annotation在那里使用?
- 可以附加在package、class、method、field等上面,相当于给他们添加了额外的辅助信息
- 通过反射机制变成实现对这些元数据的控制
内置注解
@Override:定义在 java.lang.Override
中,此注释只适用于修饰方法,表示一个方法声明打算重写超类中的另一个方法声明
@Deprecated:定义在java.lang.Deprecated
中,此注释可以用于修饰方法,属性,类,表示不鼓励程序员使用这样的元素,通常是因为它很危险,或者存在更好的选择
@SuppressWarnings:定义在java.lang.SuppressWarnings
中,用来抑制编译时的警告信息,与前面的两个注释不同,你需要额外添加一个参数才能正确使用,这些参数都是已经定义好了的,我们选择性的使用就好了。
- @SuppressWarnings(“all”)
- @SuppressWarnings(“unchecked”)
- @SuppressWarnings(value={“unchecked”, “deprecation”})
元注解
@Target:用于描述注解的使用范围,即:被描述的注解可以在什么地方使用
@Retention:表示需要什么保存该注释信息,用于描述注解的生命周期(级别范围:Source < Class < Runtime)
@Document:说明该注解被包含在java doc中
@Inherited:说明子类可以集成父类中的注解
自定义注解
@interface 用来声明一个注解,格式:public @interface 注解名 {定义内容}
其中的每个方法实际上是申明了一个配置参数
方法的名称j就是参数的类型
返回值类型就是参数的类型(返回值只能是基本数据类型,Class,String,enum)
通过default来申明参数的默认值
如果只有一个参数成员,一般参数名为 value
注解元素必须要有值,我们定义元素时,经常使用空字符串或者0作为默认值
/**
* 自定义注解
*
* @author: 陌溪
* @create: 2020-03-28-22:57
*/
public class MateAnnotationDemo {
// 注解可以显示赋值,如果没有默认值,我们就必须给注解赋值
@MyAnnotation(schools = {"大学"})
public void test(){
}
}
/**
* 定义一个注解
*/
@Target(value={ElementType.METHOD, ElementType.TYPE}) // target表示我们注解应用的范围,在方法上,和类上有效
@Retention(RetentionPolicy.RUNTIME) // Retention:表示我们的注解在什么时候还有效,运行时候有效
@Documented // 表示说我们的注解是否生成在java doc中
@Inherited // 表示子类可以继承父类的注解
@interface MyAnnotation {
// 注解的参数:参数类型 + 参数名()
String name() default "";
int age() default 0;
// 如果默认值为-1,代表不存在
int id() default -1;
String[] schools();
}