java注解核心知识总结

1. 前言

前几年咱们的项目还在structs 2 上跑，有一次问一个同事是否知道
Spring Boot,同事说那不是用注解来开发的吗。虽然这个答案并不彻底对，可是从客观上Spring Boot对刚刚接触它的人来讲最醒目的就是注解了。那么今天咱们来了解一下Java语言的核心功能——注解。

2.注解是什么

public @interface Anno {
}

以上就是一个最简单的注解声明。它能够注释到类、接口、方法以及变量上。经过向方法，接口，类或字段添加注释，为其绑定的源代码分配额外的元数据。

3.注解的用途

经过注解咱们能够通知编译器有关警告和错误的信息在编译时操做源代码在运行时修改或检查行为。jdk提供内置5个基本注解来处理代码检查。

• @Override 来标记该方法重写或替换继承的方法的行为。若是你重写了父类方法不带该注解会触发一些警告。
• @SuppressWarnings 表示咱们要忽略部分代码中的某些警告。如忽略潜在的类型不安全转换警告unchecked。
• @Deprecated 用来表示类、方法已通过时，不推荐使用。若是你强行使用编译器会在编译时进行警告。
• @Safevarargs 抑制“堆污染”警告。“堆污染”指的是将一个不带泛型的对象赋给带泛型的变量时引起的的类型问题。若是你不想看到该警告就可使用该注解来抑制。
• @FunctionalInterface java 8 新增注解，只能做用于接口上来标识该接口是函数式接口。java中函数式接口表示该接口只能有一个抽象方法。若是一个接口被此注解修饰，若是添加第二个抽象方法将没法经过编译。

注解能够将一些元数据传递给你编写的逻辑。好比Spring Mvc 中的一个经常使用注解@RequestMapping，咱们能够经过value参数来传递一个path路径，Spring Mvc经过对请求的路径的匹配来做出是否路由到该path上。 目前大量的的框架都依赖注解，好比Spring、hibernate、dubbo等等。

4.元注解

元注解是能够应用于其余注解的注解。来加强或者配置目标注解的机制。jdk目前提供了5个元注解。若是你须要开发自定义注解，请务必熟悉它们：

• @Retention 只能用于修饰注解，来指定被修饰注解能够保留多长时间。规定了三种策略：

  • RetentionPolicy.SOURCE 这种策略下被修饰的注解只能存在于源代码中，编译后被丢弃，经过反射没法获取到被修饰的注解。
  • RetentionPolicy.CLASS 这种策略下被修饰的注解会被编译进字节码文件中。可是JVM没法获取到被修饰的注解。这是一个默认值，当你声明的注解没有添加任何保留策略时，会默认指定该策略。
  • RetentionPolicy.RUNTIME 这种策略下被修饰的注解不但能够编译进字节码文件。并且JVM也能够获取被该注解修饰的注解。并且程序编码也能够经过反射来获取被该注解修饰的注解的一些元信息。

• @Target 用于指定被修饰注解的修饰目标类型。若是一个注解明确了可修饰的目标类型，则只能修饰指定的类型。由枚举ElementType来规定。

  • TYPE 只能修饰 类、接口、枚举。
  • FIELD 只能修饰成员变量，包含枚举内的常量。
  • METHOD 只能修饰方法。
  • PARAMETER 只能修饰参数。
  • CONSTRUCTOR 只能修饰构造器。
  • LOCAL_VARIABLE 只能修饰局部变量。
  • ANNOTATION_TYPE 只能修饰注解。
  • PACKAGE 只能修饰包定义。也就是package-info.java中
  • TYPE_PARAMETER java 8 新增 表示该注解能写在类型参数的声明语句中。 类型参数声明如： <T>、<T extends Person>
  • TYPE_USE java 8 新增 注解能够再任何用到类型的地方使用。
• @Documented 被该注解修饰的注解能够被javadoc工具提取为文档。
• @Inherited 被该注解修饰的注解有继承性。这里要注意一些要点首先这种继承性体现的类之间而不是接口之间，并且注解必须是对JVM可见。也就是@Retention为RetentionPolicy.RUNTIME 才起做用。
• @Repeatable java 8 新增。在此以前在同一个元素上同一个注解只能出现一次。@Repeatable可让一个注解屡次出如今一个元素上。

5.自定义注解

自定义注解跟自定义接口相似，可是还有一些区别，实际开发你须要对自定义注解进行元注解注释。注解中的成员变量以无参抽象方法来声明，成员变量并非全部类型都支持，目前只支持如下类型：

• 全部基本类型（int,float,boolean,byte,double,char,long,short）
• String
• Class (如：Class<?> 或 Class<T>)
• enum java枚举
• Annotation

  下面咱们就来自定义一个注解：

/**
 * 声明一个能够标记在类、接口、枚举、方法上的注解。
 * 而且JVM Runtime 可见、可生成文档
 *
 * @author Dax
 * @since 17 :27  2019/9/4
 */
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.METHOD})
public @interface Anno {
    /**
     * 若方法名为value且注解声明只须要声明value属性时，
     * value能够省略， @Anno("anno") 等同于 @Anno(value="anno")
     *
     * @return the string
     */
    String value();

    /**
     * 一个具备默认值的 String 类型属性。
     * name若不显式声明，则默认值为"" 。  
     * 声明默认值经过 default + 默认值 来声明
     *
     * @return the string
     */
    String name() default "";

    /**
     * 一个Class 类型属性，没有默认值。其余支持类型再也不举例
     *
     * @return the class
     */
    Class<?> clazz();
}

6.如何获取注解中的元数据

全部的注解都是java.lang.annotation.Annotation 的子类。只有RetentionPolicy为RUNTIME的 注解才能经过反射获取。在反射包中提供了AnnotatedElement 接口来对元素上的可捕捉到的注解进行处理。该接口是Class、Method、Constructor等程序元素对象的父接口。也就是说只要能获取程序元素对象就能对其存在的注解进行处理。主要方法有：

• boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) 判断是否存在 annotationClass类型的注解。
• <T extends Annotation> T getAnnotation(Class<T> annotationClass) 若是在当前元素上存在参数所指定类型（annotationClass）的注解，则返回对应的注解，不然将返回null。
• Annotation[] getAnnotations() 返回在这个元素上的全部注解。若是该元素没有注解，则返回值是长度为0的数组。该方法的调用者能够自由地修改返回的数组;它不会对返回给其余调用者的数组产生影响。
• <T extends Annotation> T[] getAnnotationsByType(Class<T> annotationClass) 返回与该元素相关联的注解。若是没有与此元素相关联的注解，则返回值是长度为0的数组。这个方法与getAnnotation(Class)的区别在于，该方法检测其参数是否为可重复的注解类型(JLS 9.6)，若是是，则尝试经过“looking through”容器注解来查找该类型的一个或多个注解。该方法的调用者能够自由地修改返回的数组;它不会对返回给其余调用者的数组产生影响。参考@Repeatable。
• <T extends Annotation> T getDeclaredAnnotation(Class<T> annotationClass) 若是参数中所指定类型的注解是直接存在于当前元素上的，则返回对应的注解，不然将返回null。这个方法忽略了继承的注解。(若是没有直接在此元素上显示注释，则返回null。)
• <T extends Annotation> T[] getDeclaredAnnotationsByType(Class<T> annotationClass) 可获取重复注解可是忽略掉继承注解。
• Annotation[] getDeclaredAnnotations() 跟上面的注解区别在于不能获取重复注解。

基本上对这个接口的方法进行学习后就能够知道如何获取注解的元数据了。下面咱们写一个例子，仍是上面的Anno注解为例：

/**
 * 被注解标记的类
 **/
@Anno("hello")
public class Foo {}


/**
 * 经过获取Foo 的Class 类，
 * 而后就能够根据上面已经介绍的方法来获取value的值了
 * @author dax
 * @since 2019/9/4 22:17
 */
public class Main {
    public static void main(String[] args) {
        Anno annotation = Foo.class.getAnnotation(Anno.class);

        String value = annotation.value();
        System.out.println("value = " + value);
    }
}

总结

今天咱们系统地对注解进行了概括，相信你已经对注解有了系统性的认识。其实注解还能够干一些花式操做，好比lombok框架。后面咱们会介绍相关的注解技术，多多关注。

关注公众号：码农小胖哥 获取更多资讯