[Java] 注解

背景

• 一种数据类型，和class平级
• JDK 1.5 后可用
• 类比：贴标签
• 注解是用来解释代码的元数据，但不是注解的代码本身的一部分，对代码运行效果没有直接影响
• 提取和处理Annotation的代码统称APT（Annotation Proccesing Tool）

应用

• 提供信息给编译器：检查错误信息
• 编译阶段处理：生成代码，Html文档等
• 运行时处理：注解在运行时接收代码提取

基本内置注解

• @Override：重写父类方法。如果父类没有该方法则编译无法通过
• @SuppressWarning：忽略警告信息
• @SafeVarargs：去掉使用可变数量参数，参数类型是泛型T时出现的警告
• @FunctionalInterface：约定函数接口

自定义注解

• 注解类型：@interface
• 创建注解：public @interface JDBCConfig
• 注解元素：String ip();
• 通过反射，获取注解对象
• 通过class对象的isAnnotationPresent()方法，判断是否应用了某个注解
• 通过class对象的getAnnotation()，获取Annotation对象
• 拿到注解对象，通过其方法，获取注解元素的值
• 注解只有成员变量，没有方法
• 注解的成员变量在注解定义中以“无形参方法”形式声明
• 方法名定义了成员变量的名字，返回值定义了成员变量的类型
• 使用时为属性赋值（value = " "），多个属性间用 , 隔开
• 属性的类型必须是8中数据类型，或类、接口、注解及其数组
• 利用 default 为注解的属性设置默认值

元注解

• 元数据（metadata）：为其他数据提供信息的数据
• @Target({METHOD,TYPE})：此注解可以使用在方法、类、接口上，不能放在属性位置
• @Retention(RetentionPolicy.RUNTIME)：运行时注解，运行起来才可获得注解中信息，而不像@Override编译时就可获取
• @Inherited：可被子类继承
• @Documented：执行javadoc时，会生成相关文档
• @Repeatable：可重复，注解的值可同时取多个

TestAnnotation.java

 1 package Annotation;
 2 
 3 import java.lang.annotation.ElementType;
 4 import java.lang.annotation.Retention;
 5 import java.lang.annotation.RetentionPolicy;
 6 import java.lang.annotation.Target;
 7 
 8 @Target(ElementType.TYPE)
 9 @Retention(RetentionPolicy.RUNTIME)
10 public @interface TestAnnotation {
11     
12     int id() default -1;
13     
14     String msg() default "Hi";
15 
16 }

View Code

Test.java

 1 import Annotation.TestAnnotation;
 2 
 3 @TestAnnotation()
 4 public class Test {
 5     
 6     public static void main(String[] args) {
 7         
 8         boolean hasAnnotation = Test.class.isAnnotationPresent(TestAnnotation.class);
 9         
10         if ( hasAnnotation ) {
11             TestAnnotation testAnnotation = Test.class.getAnnotation(TestAnnotation.class);
12             
13             System.out.println("id:"+testAnnotation.id());
14             System.out.println("msg:"+testAnnotation.msg());
15         }
16     }
17 }

View Code

参考

秒懂，Java 注解 （Annotation）你可以这样学

https://blog.csdn.net/briblue/article/details/73824058

自定义注解

https://how2j.cn/k/annotation/annotation-customize/1056.html#nowhere

[Java] 注解

原文：https://www.cnblogs.com/cxc1357/p/12463557.html