java 注解再学习

前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家。​​点击跳转到网站。​​

注解(Annotation)是在java 1.5开始引入的，它是java中很重要的一个知识点。现在使用的很多框架，例如：SpringBoot、Hibernate等都大量的使用了注解。

注解是什么

注释是元数据的一种形式，提供有关程序的数据，而不是程序本身的一部分。注解对它们所注解的代码的操作没有直接影响。
它是Java中的一种特殊标记。

注解的用途

我们说注解的用途的前提是默认它是跟反射一起使用的，不然的话注解也就失去了它本来的作用了。注解有很多用途，比如：日志、权限、Spring中IOC等等都可以用注解来完成的。但是，总的来说有以下用途：

• 编译器信息：可用于编译器检测错误或抑制警告。
• 编译时和部署时处理： 软件工具可以处理注释信息以生成代码、XML文件等。
• 运行时处理： 可以在运行时检查一些注解。
• 生成文档：可以通过使用@Documented元注解，在需要的时候生成文档

标准注解

标准注解有10个，其中java.lang包下有5个分别是以下五个：

@Override： 检查该方法是否是重写了父类或者接口的方法，如果父类或者接口的方法删除或者被更改，编译器将提示报错。

@Deprecated：标记某个类、方法、属性等是否被弃用，在不推荐使用某个方法、类、属性等时，可以使用。

@SuppressWarnings：告诉编译器还可以忽略这个警告。

@SafeVarargs： Java 7 开始支持，忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。

@FunctionalInterface：Java 8 开始支持，表明该接口是一个匿名函数或函数式接口。

元注解

元注解也是java标准注解，只不过它们比较特殊，是作用在注解上的注解。元注解都在java.lang.annotation包下。

@Documented：标记这些注解是否包含在用户文档中。

@Target：标记注解类型适用的java元素的种类。一些可能的值是 TYPE、METHOD、CONSTRUCTOR、FIELD 等。如果不存在目标元注释，则可以在任何程序元素上使用注释。

@Inherited：表示允许子类继承父类中的注解。如果父类中使用了@Inherited注解，子类也就拥有了这个注解，子类通过Class对象的​​getAnnotation()​​方法就能获取到父类中的注解。

@Retention：标识这个注解怎么保存，是只在代码中，还是编入class文件中，或者是在运行时可以通过反射访问。它采用 RetentionPolicy 参数，其可能值为 SOURCE、CLASS 和 RUNTIME

@Repeatable：Java 8 开始支持，标识某注解可以在同一个声明上使用多次。

注解的分类

注解有5类，分别是：

标记注解：唯一的目的是标记一个声明。这些注释不包含任何成员，也不包含任何数据。@Override是标记注解的一个示例。

单值注解：顾名思义就是只有一个成员的注解，并且允许以简写形式指定成员的值。我们只需要在应用注解时指定该成员的值，不需要指定成员的名称。例如：​​@TestAnnotation(“测试”)​​

完整注解：由多个数据成员、名称、值、对组成的注解。例如：​​@TestAnnotation(owner=”公众号：索玛理”, value=”suncodernote”)​​

类型注解：可以应用于任何使用类型的地方的注解。例如，可以作为方法的返回类型。

@Target(value = ElementType.TYPE_USE)
public @interface TypeAnnoDemo {
}

public class AnnotationTest {
public static void main(String[] args) {
@TypeAnnoDemo String string = "局部变量被类型注解注解";
type();
}
static @TypeAnnoDemo Integer type(){
System.out.println("返回值被类型注解注解");
return 0;
}
}

重复注解：重复注解指的就是被​​@Repeatable​​注解进行修饰的注解。

注解的定义

注解和接口的定义差不多，只不过注解多了个 @ 符号。定义一个注解时有以下4点比较重要：

注解中的方法不能有参数。

注解中方法的返回值必须是基本数据类型、String、枚举、注解或者数组。

注解中的方法可以有默认值

注解上可以使用元注解

自定义注解

要自定义一个注解，有两个关键参数ElementType和RetentionPolicy必须要了解一下：

ElementType

ElementType是一个枚举类型，它做为数组在@Target注解中出现。作用是对Java程序中注解可能出现的语法位置进行简单分类。

public enum ElementType {
TYPE,
FIELD,
METHOD,
PARAMETER,
CONSTRUCTOR,
LOCAL_VARIABLE,
ANNOTATION_TYPE,
PACKAGE,
TYPE_PARAMETER,
TYPE_USE
}

类型

可以应用的地方

TYPE

作用于类、接口(包括注解类型)或者枚举类

FIELD

作用于属性

METHOD

作用于声明的方法

PARAMETER

作用于方法参数

CONSTRUCTOR

作用于构造方法

LOCAL_VARIABLE

作用于局部变量

ANNOTATION_TYPE

作用于其他注解

PACKAGE

作用于包

TYPE_PARAMETER

java 1.8引入的，作用于泛型参数

TYPE_USE

java 1.8引入的，作用于任何使用类型的地方

ElementType 中有些作用范围广的常量是可以替代其他常量的，就比如TYPE_USE可以可以替代PARAMETER 、LOCAL_VARIABLE 、FIELD等。

RetentionPolicy

注解的保留策略，在注解​​@Retention​​中声明，它表示要保留注解到哪种地步。

public enum RetentionPolicy {
SOURCE,
CLASS,
RUNTIME
}

• SOURCE：源码级别，编译期就会被抛弃用不到
• CLASS：默认级别，编译期会被编译到类文件中，但在运行时获取不到。
• RUNTIME：编译期会被编译到类文件中，运行时可以获取到，可以通过反射获取到。

小试牛刀

自定义一个注解CustomAnnotation
ElementType枚举一共有10常量，这里就不一一测试了，感兴趣的自己可以来回测测。
自定义的注解想要在运行时获取到RetentionPolicy一定要设置成RUNTIME，否则找不到会报错。

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE , ElementType.METHOD , ElementType.FIELD , ElementType.TYPE_PARAMETER, ElementType.LOCAL_VARIABLE , ElementType.PARAMETER , ElementType.TYPE_USE})
public @interface CustomAnnotation {
String name() default "";

/**
* 在某个地方只有某个ElementType能起作用
* @return
*/
ElementType type() default ElementType.TYPE;

/**
* 能多个ElementType在同一个地方起作用的数组
* @return
*/
ElementType[] types() default {};
}

测试使用
下面是对上面自定义注解@CustomAnnotation的使用，可以看到有的地方使用了types方法，有的使用了type方法。可以发现使用types 的地方都有ElementType.TYPE_USE的身影，java 8加的这个常量使用范围是真的广，能代替其他大部分常量了已经。

@CustomAnnotation(types ={ElementType.TYPE_USE , ElementType.TYPE} )
public class AnnotationTest<@CustomAnnotation(name = "泛型参数" , types ={ElementType.TYPE_USE , ElementType.TYPE_PARAMETER} ) T> {

@CustomAnnotation(types ={ElementType.TYPE_USE , ElementType.FIELD})
private String field;

public static void main(String[] args) {
@CustomAnnotation(types ={ElementType.TYPE_USE , ElementType.PARAMETER}) String string = "局部变量被类型注解注解";

}

static @CustomAnnotation(types ={ElementType.TYPE_USE , ElementType.METHOD} ) Integer type(){
System.out.println("返回值被类型注解注解");
return 0;
}

@CustomAnnotation(type = ElementType.METHOD)
static void method(){
System.out.println("作用在方法");
}

static void param(@CustomAnnotation(types ={ElementType.TYPE_USE , ElementType.PARAMETER}) Integer p){}
}

在自定义注解​​@CustomAnnotation​​​中，将​​@Targe​​​t元注解中的​​ElementType.TYPE_PARAMETER​​​删除，测试类​​AnnotationTest​​​不会报错，但是如果把​​ElementType.TYPE_USE , ElementType.TYPE_PARAMETER​​​两个都删除的话，就会看到报错，这是因为 ​​ElementType.TYPE_USE​​​能代替​​ElementType.TYPE_PARAMETER​​。具体ElementType.TYPE_USE能代替几个ElementType枚举中的常量，感兴趣的话，自己可以动手测试一下。

获取注解
前面说过注解要搭配着反射使用才有用，没有要注解也没啥大的用处。

static void getCustomAnnotation() throws NoSuchMethodException {

AnnotationTest<String> annotationTest = new AnnotationTest<>();
final Class<? extends AnnotationTest> annotationTestClass = annotationTest.getClass();
//获取类上的注解
final CustomAnnotation classAnnotation = annotationTestClass.getAnnotation(CustomAnnotation.class);
System.out.println("类上的注解"+Arrays.toString(classAnnotation.types()));

//获取泛型上的注解
final TypeVariable<? extends Class<? extends AnnotationTest>>[] typeParameters = annotationTestClass.getTypeParameters();

for (TypeVariable<? extends Class<? extends AnnotationTest>> typeParameter : typeParameters) {
final CustomAnnotation annotation = typeParameter.getAnnotation(CustomAnnotation.class);
System.out.println("泛型上的注解："+annotation);
}

//获取方法上的注解
final Method[] declaredMethods = annotationTestClass.getDeclaredMethods();
for (Method declaredMethod : declaredMethods) {
final Annotation[] declaredAnnotations = declaredMethod.getDeclaredAnnotations();
for (Annotation declaredAnnotation : declaredAnnotations) {
System.out.println("方法名="+declaredMethod+",注解="+declaredAnnotation);
}
}
}

结果：

总结

注解是Java中很重要的一个知识点，用起来也简单。它是类、方法、属性等的一个标记，搭配反射使用能够出奇效。

参考资料：

​​https://www.geeksforgeeks.org/annotations-in-java/​​