浅析 Java 注解（Annotation）

关注

VIP免费原创最新推荐文章于 2026-05-02 10:00:07 发布 285 阅读 AI 写同款· GEO 优化 ›

全面解析Java注解（Annotation）一、概念 Annotation（注解）就是Java提供了一种源程序中的元素关联任何信息和任何元数据（metadata）的途径和方法。定义：注解（Annotation），也叫元数据，是一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性，与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释，创建文档，跟踪代码中的依... 阅读详情

Java 5之后可以在源代码中嵌入一些补充信息，这种补充信息称为注解（Annotation），例如在方法覆盖中使用过的@Override注解，注解都是**@符号开头**的。

注解并不能改变程序运行的结果，不会影响程序运行的性能。有些注解可以在编译时给用户提示或警告，有的注解可以在运行时读写字节码文件信息。

五个基本注解

无论是哪一种注解，本质上都一种数据类型，是一种接口类型。到Java 8为止Java SE提供11种内置注解。其中有 5 种是基本注解，它们来自于java.lang包。有6个是元注解（Meta Annotation），它们来自于java.lang.annotation包，自定义注解会用到元注解。

元注解就是负责注解其他的注解。

基本注解包括：@Override、@Deprecated、@SuppressWarnings、@SafeVarargs和@FunctionalInterface。下面逐一介绍一下。

@Override只能用于方法，子类覆盖父类方法（或者实现接口的方法）时可以@Override注解。编译器会检查被@Override注解的方法，确保该方法父类中存在的方法，否则会有编译错误。

package java.lang;

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

@Deprecated用来指示API已经过时了

package java.lang;

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}

@SuppressWarnings 用来抑制编译器警告，如果你确认程序中的警告没有问题，可以不用理会。但是就是不想看到这些警告，可以使用@SuppressWarnings注解消除这些警告。

@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
@Retention(RetentionPolicy.SOURCE)
public @interface SuppressWarnings {
}

@SafeVarargs 例如在传递可变参数，参数是非泛型集合

 public class HelloWorld {

         public static void main(String[] args) {
             // 传递可变参数，参数是泛型集合
             display(10, 20, 30);                            
             // 传递可变参数，参数是非泛型集合