- 一、注解
- 二、基本注解
- 三、元注解
- @Target
- @Retention
- @Inherited
- @Documented
- 四、自定义注解
- 1.定义注解
- 2.使用注解
- 3.解析注解
- 总结
一、注解
注解(Annotation)是一种能被添加到java代码中的元数据,类、方法、变量、参数和包都可以用注解来修饰。注解对于它所修饰的代码并没有直接的影响。
二、基本注解JDK提供5个基本注解annotation:
//常用
@Override:常用于子类方法,表示被标注的方法重写了父类方法
@Deprecated:不再建议使用这个类或者方法,在调用时会出现删除线
@SuppressWarnings(“警告类型”):关闭编译器对该项的警告
//非常用
@SafeVarargs:处理可变长参数中的泛型
@FunctionalInterface:指定接口是函数式接口
JDK提供4个元注解meta-annotation用于修饰注解:
@Target用于确定注解所修饰的对象,例:
@Retention@Target注解指定@SuppressWarnings注解可以作用于类、属性、方法、参数、构造器、局部变量
@Target注解指定@Override注解仅可以作用于方法
用于确定注解的保留策略(类似生命周期) 表示需要在什么级别保存该注解信息
RetentionPolicy.SOURCE:保留至源码阶段
RetentionPolicy.CLASS:保留至编译阶段
RetentionPolicy.RUNTIME:保留至运行阶段
@Inherited示例如上两图所示
用于确定注解类型的自动继承,某类被@Inherited注解的注解注解,则该类的子类自动继承该注解
@Documented示例:自定义注解+注解父类+子类继承父类+使用子类进行验证
重要方法:
A.isAnnotationPresent(B.class);
注释B是否在A上。如果在返回true,不在返回false。
用于确定生成javadoc文档时将该注解写入到帮助文档中
四、自定义注解 1.定义注解示例:略
如何生成JavaDoc文档
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface MyAnnotation1 {
public String name();
public int age() default 20;
}
2.使用注解
@MyAnnotation1(name = "lucy",age = 22)
public class MyClass1 {
}
3.解析注解
public class TestAnnotation1 {
public static void main(String[] args) {
getAnnotation();
}
public static void getAnnotation() {
Class clazz = MyClass1.class;
boolean isPresent = clazz.isAnnotationPresent(MyAnnotation1.class);
//判断注解是否存在
if (isPresent) {
//获取注解
MyAnnotation1 myAnnotation1 = clazz.getAnnotation(MyAnnotation1.class);
System.out.println("annotation = " + myAnnotation1);
//获取注解中属性的值
String name = myAnnotation1.name();
int age = myAnnotation1.age();
System.out.println("name=" + name + ",age=" + age);
}else {
System.out.println("Annotation is not present");
}
}
}
控制台输出
annotation = @org.example.annotation2.MyAnnotation1(age=22, name=lucy)
name=lucy,age=22
总结
浅浅学习了一天的注解,还有很多需要学习的地方。
路漫漫其修远兮,吾将上下而求索。



