Java注解
Annotation，注解，可理解为对代码贴上的标签。
注解的定义： 跟接口类似，只是多了一个@符号
public @interface TestAnnotation {}
注解的使用：
@TestAnnotation
public class Test {}
元注解，或者元标签有 @Retention、@Documented、@Target、@Inherited、@Repeatable 5 种，是用来给普通的注解进行解释说明，可以理解为标签的标签。
@Retention:用来表明注解的有效时间，也就是生存时间，分为：源码时保留、编译时保留、运行时保留。
它的取值如下：
-
生存周期 RUNTIME > CLASS > SOURCE.- RetentionPolicy.SOURCE 注解只在源码阶段保留，在编译器进行编译时它将被丢弃忽视。 - RetentionPolicy.CLASS 注解只被保留到编译进行的时候，它并不会被加载到 JVM 中。 - RetentionPolicy.RUNTIME 注解可以保留到程序运行的时候，它会被加载进入到 JVM 中，所以在程序运行时可以获取到它们。
@Documented:表明可以将注解的元素包含到Document中。
@Target：目标，指定了注解应该运用的地方，如果没有此项，可以认为标签能够随便贴，如果使用Target了，则标签只能贴到指定的地方了。
取值如下：
ElementType.TYPE:可以给一个类型进行注解，包括类、接口、枚举。
ElementType.Method：可以给一个方法进行注解
ElementType.Filed：给成员变量注解
ElementType.CONSTRUCTOR：给构造方法注解
以及其他。
@Inherited 继承，当一个超类被Inherited注解过的A注解的话，那么如果这个超类的子类没有应用其他注解的话，它会继承超类的注解A。
@Repeatable:重复，Java8 的新特性。指注解的值可以同时取多个。例如一个人的身份可以是多重的，
@Person(role="artist")
@Person(role="coder")
@Person(role="PM")
public class SuperMan{
}
注解的属性
注解只有成员变量，没有成员方法，并且成员变量的定义形式需要使用无形参的方法来声明，包括 返回值+变量名+（）；返回值表示其类型。
如下：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {
int id();
String msg();
}
可以设置默认值：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {
int id() default -1;
String msg() default "Hi";
}
注解的成员属性值的设置如下：
@TestAnnotation(id=5, msg="Hello")
public class Test {}
如果只有一个成员，则可以直接将值写在括号中。
@TestAnn("one")
如果注解没有属性则连括号都可以省略。
@TestNoFiled
public class Test {}
Java预置的注解：@Override、@Deprecated、@SuppressWarnings、
@FunctionalInterface: java8新增的，表示这个接口是一个函数接口，即只有一个抽象方法。
前面把注解定义好，写好，然后像标签一样贴到代码相应的位置上，后续就是对标签的检阅，对注解的提取。
注解的提取方式是通过反射机制实现。
- 通过Class对象的方法： isAnnotationPresent()来判断该Class对象是否使用了某个注解。
public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) - 通过getAnnotation()来获取对应的注解对象。反射中的Class/Field/Method等都可以调用该方法。
public <A extends Annotation> A getAnnotation(Class<A> annotationClass) - 或者是通过 getAnnotations() 方法获取该类的所有注解对象，前面一个方法只是获取指定的注解对象。
public Annotation[] getAnnotations()
如果Annotation对象不为null,就可以读取它的属性了，如下：
@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {
int id() default -1;
String msg() default "Hi";
}
@TestAnnotation(id=3, msg="good")
public class Test {
public static void main(String[] args) {
boolean hasAnnotation = Test.class.isAnnotationPresent(TestAnnotation.class);
if (hasAnnotation) {
TestAnnotation annotation = Test.class.getAnnotation(TestAnnotation.class);
print(annotation.id());
print(annotation.msg());
}
}
}
需要注意的是，如果一个注解想要在运行时被获取，那么它应该有元注解：@Retention(RetentionPolicy.RUNTIME)
如果是对类的成员变量的注解进行提取解析，则需要借助反射
public @interface Check {
int value() default 0;
}
class Test {
```
@Check(5)
int age;
@Check(value = 9)
void setAge(int age) {
}
public static void main() throws Exception{
Field ageFiled = Test.class.getField("age");
ageFiled.setAccessible(true);
Check checkAnn = ageFiled.getAnnotation(Check.class);
print(checkAnn.value());
Method setAgeMethod = Test.class.getMethod("setAge", Integer.TYPE);
setAgeMethod.setAccessible(true);
if (setAgeMethod != null) {
checkAnn = setAgeMethod.getAnnotation(Check.class);
print(checkAnn.value());
}
}
```
}
注解的使用场景？
注解是一系列元数据，可以提供一些数据来解释程序代码，并非代码的一部分，也不会对代码的运行有影响的。主要作用有3个：
- 提供信息给编译器，编译器可以利用注解来探测错误或告警信息。
- 编译阶段的处理：某些软件工具可以根据注解信息生成代码、html文档或者进行其他处理。
- 运行阶段的处理：某些注解可以在代码运行时候，被代码提取出来使用。
即注解本身是不会生效或者执行什么动作，它是被别人拿来用的。被编译器、软件工具、代码使用，提供辅助信息，可以看成一种特殊的注释信息。
例子，一个测试框架，测试代码是否正常：
- 定义注解
@Retention(RetentionPolicy.RUNTIME)
public @interface Jiecha {}
- 对被测试的代码添加注解
public class NoBug {
@Jiecha
public void jiafa(){
System.out.println("1+1="+1+1);
}
@Jiecha
public void chufa(){
System.out.println("6 / 0="+ 6 / 0);
}
public void jianfa(){
System.out.println("1-1="+(1-1));
}
}
-
抽取注解，进行测试
public class TestTool { public static void main(String[] args) { NoBug nobug = new NoBug(); ``` Class clz = nobug.getClass(); Method[] methods = cls.getDeclaredMethods(); for (Method m : methods) { if (m.isAnnotationPresent(Jiecha.class) { try { m.setAccessible(true); m.invoke(nobug, null); } catch (Exception e) { print("错误报告"); } } } ``` } }
使用注解时，需要借助反射，但反射比较慢，所以需要谨慎计算时间成本。
网友评论