必知必会面试题之 Java 注解

title: 必知必会面试题之 Java 注解
date: 2021-02-24
updated: 2021-03-10
categories:

  • Java
  • 必知必会
    tags:
  • Java
  • 面试
  • 必知必会

不定期更新中……

元注解

@Documented

仅用在注解类上，表示在使用 javadoc 工具生成帮助文档时，使用该注解的类会在 API 文档中展示该注解。

注解版本：1.5+

场景举例：

  • 创建一个注解类 TestAnnotation

    package com.xs.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Target;

@Documented
@Target(ElementType.TYPE)
public @interface TestAnnotation {

  public String value() default "javadoc";
}

  • 创建一个使用该注解的类 DocumentTest

    package com.xs.annotation;

@TestAnnotation
public class DocumentedTest {
}

  • 生成 javadoc（使用 javadoc 命令 或 使用 eclipse、IDEA 等 IDE 提供的 javadoc 生成工具）

  • 打开生成的 API 文档（/doc/index.html），如下：

    图1

  • 若删除注解类 TestAnnotation 中的 @Documented 注解，再次生成 javadoc，注解消失。

    图2

@Inherited

仅用在注解类上，被它修饰的注解具有继承性。也就是说，在一个类上使用被 @Inherited 标注的注解，其子类也会继承这些被 @Inherited 标注的注解。

注解版本：1.5+

场景举例：

  • 创建一个带有 @Inherited 的注解类 InheritedAnnotation

    package com.xs.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Target;

@Inherited
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface InheritedAnnotation {

  public String value() default "Inherited";
}

  • 创建一个使用该注解的类 InheritedParent

    package com.xs.annotation;

import com.xs.annotation.TestInheritedAnnotation;

@InheritedAnnotation(value="parent")
public class InheritedParent {
  
}

  • 为 InheritedParent 类创建子类 InheritedChild

    package com.xs.annotation;

import com.xs.annotation.InheritedParent;

public class InheritedChild extends InheritedParent {
  
  public static void main(String[] args) {
		Class<InheritedChild> child = InheritedChild.class;
		InheritedAnnotation annotation = child.getAnnotation(InheritedAnnotation.class);
		System.out.println(annotation.value());
	}
}

  • 运行 main 方法，输出如下。

    parent

@Retention

仅用在注解类上，用来描述注解保留的时间范围。一共有三种策略，定义在 RetentionPolicy 枚举中，分别是：源文件保留、编译期保留、运行期保留，默认值为编译期保留。运行期保留可以用来获取注解信息。

注解版本：1.5+

场景举例：

  • 分别实现三种策略

    package com.xs.annotation.meta;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.SOURCE)
public @interface SourcePolicy {
 
}

@Retention(RetentionPolicy.CLASS)
public @interface ClassPolicy {
 
}

@Retention(RetentionPolicy.RUNTIME)
public @interface RuntimePolicy {
 
}

  • 创建一个类，并使用以上三种注解去注解三个方法

    package com.xs.annotation.meta;

public class RetentionTest {
 
	@SourcePolicy
	public void sourcePolicy() {
	}
 
	@ClassPolicy
	public void classPolicy() {
	}
 
	@RuntimePolicy
	public void runtimePolicy() {
	}
}

  • 生成字节码文件

    javap -verbose RetentionClass
### 以下为输出结果 ###
警告: 二进制文件RetentionClass包含com.xs.annotation.meta.RetentionClass
Classfile /Users/lihuiming/git/xs/xs-technology/xs-learning-annotation/target/classes/com/xs/annotation/meta/RetentionClass.class
  Last modified 2021-2-20; size 709 bytes
  MD5 checksum 88516f888e7e83d00ffe708e32d852a0
  Compiled from "RetentionClass.java"
public class com.xs.annotation.meta.RetentionClass
  minor version: 0
  major version: 52
  flags: ACC_PUBLIC, ACC_SUPER
Constant pool:
   #1 = Methodref          #3.#20         // java/lang/Object."<init>":()V
   #2 = Class              #21            // com/xs/annotation/meta/RetentionClass
   #3 = Class              #22            // java/lang/Object
   #4 = Utf8               <init>
   #5 = Utf8               ()V
   #6 = Utf8               Code
   #7 = Utf8               LineNumberTable
   #8 = Utf8               LocalVariableTable
   #9 = Utf8               this
  #10 = Utf8               Lcom/xs/annotation/meta/RetentionClass;
  #11 = Utf8               sourcePolicy
  #12 = Utf8               classPolicy
  #13 = Utf8               RuntimeInvisibleAnnotations
  #14 = Utf8               Lcom/xs/annotation/meta/RetentionClassPolicy;
  #15 = Utf8               runtimePolicy
  #16 = Utf8               RuntimeVisibleAnnotations
  #17 = Utf8               Lcom/xs/annotation/meta/RetentionRuntimePolicy;
  #18 = Utf8               SourceFile
  #19 = Utf8               RetentionClass.java
  #20 = NameAndType        #4:#5          // "<init>":()V
  #21 = Utf8               com/xs/annotation/meta/RetentionClass
  #22 = Utf8               java/lang/Object
{
  public com.xs.annotation.meta.RetentionClass();
    descriptor: ()V
    flags: ACC_PUBLIC
    Code:
      stack=1, locals=1, args_size=1
         0: aload_0
         1: invokespecial #1                  // Method java/lang/Object."<init>":()V
         4: return
      LineNumberTable:
        line 8: 0
      LocalVariableTable:
        Start  Length  Slot  Name   Signature
            0       5     0  this   Lcom/xs/annotation/meta/RetentionClass;

  public void sourcePolicy();
    descriptor: ()V
    flags: ACC_PUBLIC
    Code:
      stack=0, locals=1, args_size=1
         0: return
      LineNumberTable:
        line 12: 0
      LocalVariableTable:
        Start  Length  Slot  Name   Signature
            0       1     0  this   Lcom/xs/annotation/meta/RetentionClass;

  public void classPolicy();
    descriptor: ()V
    flags: ACC_PUBLIC
    Code:
      stack=0, locals=1, args_size=1
         0: return
      LineNumberTable:
        line 16: 0
      LocalVariableTable:
        Start  Length  Slot  Name   Signature
            0       1     0  this   Lcom/xs/annotation/meta/RetentionClass;
    RuntimeInvisibleAnnotations:
      0: #14()

  public void runtimePolicy();
    descriptor: ()V
    flags: ACC_PUBLIC
    Code:
      stack=0, locals=1, args_size=1
         0: return
      LineNumberTable:
        line 20: 0
      LocalVariableTable:
        Start  Length  Slot  Name   Signature
            0       1     0  this   Lcom/xs/annotation/meta/RetentionClass;
    RuntimeVisibleAnnotations:
      0: #17()
}
SourceFile: "RetentionClass.java"

  • 从字节码可以看出，编译器没有记录下 sourcePolicy() 方法的注解信息，分别使用了 RuntimeInvisibleAnnotations 和 RuntimeVisibleAnnotations 属性去记录了classPolicy()方法 和 runtimePolicy()方法 的注解信息。

@Target

仅用在注解类上，用来标注注解的元素类型（ElementType），即设置注解的适用范围。如果没有标注 @Target，那么该注解可以作用在任何地方。

注解版本：1.5+

场景举例：

package javax.validation;

import static java.lang.annotation.ElementType.CONSTRUCTOR;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.PARAMETER;
import static java.lang.annotation.ElementType.TYPE_USE;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

@Target({ METHOD, FIELD, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
@Documented
public @interface Valid {
}

常用注解

@Deprecated

标注在类、接口、成员方法和成员变量上，表示某个元素（类、方法等）已过时。当其他程序使用已过时的元素时，编译器将会给出警告。

注解版本：1.5+

场景举例：

@Deprecated
public class DeprecatedClass {
  
  @Deprecated
  public int value;
  
  @Deprecated
  public void m1() {
    System.out.println("Deprecated");
  }
}

@FunctionalInterface

Java 8 版本后，Java引入函数式编程。@FunctionalInterface 就是 Java 8 版本新增的注解，用来标注函数式接口。

什么是函数式接口？如果接口中只有一个抽象方法（可以包含多个默认方法或多个 static 方法），那么该接口就是函数式接口。函数式接口是为 Java 8 的 Lambda 表达式准备的。

@FunctionalInterface 本身只起到标注作用，用来告诉编译器检查这个接口是否符合函数式接口的规范（只能包含一个抽象方法）。

注解版本：1.8+

场景举例：

package org.springframework.boot;

@FunctionalInterface
public interface ApplicationRunner {
  void run(ApplicationArguments args) throws Exception;
}

@Override

标注在方法上，用来标注方法为重写方法。

注解版本：1.5+

场景举例：

public class Parent {
  
  public void m1() {
    System.out.println("Parent");
  }
}

public class Child extends Parent {
  
  @Override
  public void m1() {
    System.out.println("Child");
  }
}

@PostConstruct

@PostConstruct 该注解被用来修饰一个非静态的 void() 方法。被 @PostConstruct 修饰的方法会在服务器加载 Servlet 的时候运行，并且只会被服务器执行一次。PostConstruct 在构造函数之后执行，init() 方法之前执行。

该注解的方法在 Spring 整个 Bean 初始化中的执行顺序：Constructor（构造方法） -> @Autowired（依赖注入） -> @PostConstruct（注释的方法）。

注解版本：Common Annotations 1.0+

场景举例：

public class Test {
  private static Test test = new Test();
  
  @Autowired
  private OtherService otherService;
  
  @PostConstruct
  public void init() {
    System.out.println("init");
    test.otherService = otherService;
  }
}

@PreDestroy

注解版本：Common Annotations 1.0+

场景举例：

@Qualifier

注解版本：

场景举例：

@SafeVarargs

标注在 static 或 final 方法上，表示被该注解修饰的方法取消显示指定的编译器警告。

注解版本：1.7+

场景举例：

public class SafeVarargsClass {
  
  public static void main(String[] args) {
    // 没有 @SafeVarargs 会有编译警告
    display("10", 20, 30);
  }
  
  @SafeVarargs
  public static <T> void m1(T... array) {
    for (T arg : array) {
      System.out.println(arg.getClass().getName() + "：" + arg);
    }
  }
}

@Scope

注解版本：

场景举例：

@Singleton

注解版本：

场景举例：

@SuppressWarnings

标注在类或方法上，表示被该注解修饰的程序元素（以及该程序元素中的所有子元素）取消显示指定的编译器警告，且会一直作用于该程序元素的所有子元素。

注解的使用有以下三种：

  • 抑制单类型的警告：@SuppressWarnings("unchecked")

  • 抑制多类型的警告：@SuppressWarnings("unchecked","rawtypes")

  • 抑制所有类型的警告：@SuppressWarnings("unchecked")

全部关键字请参考附录：[@SuppressWarnings 关键字](#@SuppressWarnings 关键字)

注解版本：1.5+

场景举例：

@SuppressWarnings("unchecked","rawtypes")
public class SuppressWarningsClass {
  
  @SuppressWarnings("unchecked")
  public void m1() {
    System.out.println("unchecked");
  }
}

附录

ElementType

The constants of this enumerated type provide a simple classification of the syntactic locations where annotations may appear in a Java program. These constants are used in {@link Target java.lang.annotation.Target} meta-annotations to specify where it is legal to write annotations of a given type.

版本：1.5+

取值 释义
TYPE 用于描述类、接口（包括注解类型）、枚举
FIELD 用于描述字段（包括枚举、常量）
METHOD 用于描述方法
PARAMETER 用于描述形参
CONSTRUCTOR 用于描述构造器
LOCAL_VARIABLE 用于描述局部变量
ANNOTATION_TYPE 用于描述注解类型
PACKAGE 用于描述包
TYPE_PARAMETER JAVA 8 新增，作用在泛型上
TYPE_USE JAVA 8 新增，用于描述任何类型

RetentionPolicy

Annotation retention policy. The constants of this enumerated type describe the various policies for retaining annotations. They are used in conjunction with the {@link Retention} meta-annotation type to specify how long annotations are to be retained.

版本：1.5+

取值 释义
SOURCE 注解只保留在源文件，当Java文件编译成class文件的时候，注解被遗弃；
CLASS 注解被保留到 class文件，但jvm加载class文件时候被遗弃，默认为该级别；
RUNTIME 注解不仅被保存到 class文件中，jvm加载class文件之后，仍然存在；

@SuppressWarnings 关键字

关键字 用途
all 抑制所有警告
boxing 抑制装箱、拆箱操作时候的警告
cast 抑制映射相关的警告
dep-ann 抑制启用注释的警告
deprecation 抑制过期方法警告
fallthrough 抑制在 switch 中缺失 breaks 的警告
finally 抑制 finally 模块没有返回的警告
hiding 抑制相对于隐藏变量的局部变量的警告
incomplete-switch 忽略不完整的 switch 语句
nls 忽略非 nls 格式的字符
null 忽略对 null 的操作
rawtypes 使用 generics 时忽略没有指定相应的类型
restriction 抑制禁止使用劝阻或禁止引用的警告
serial 忽略在 serializable 类中没有声明 serialVersionUID 变量
static-access 抑制不正确的静态访问方式警告
synthetic-access 抑制子类没有按最优方法访问内部类的警告
unchecked 抑制没有进行类型检查操作的警告
unqualified-field-access 抑制没有权限访问的域的警告
unused 抑制没被使用过的代码的警告
【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/lihuimingxs/p/must-know-java-annotation.html