Java 内置注解

Java教程 - 什么是Java内置注解


内置注解

Java定义了许多内置注解。大多数是专门的,但七是通用的。

  • @Retention
  • @Documented
  • @Target
  • @Inherited
  • @Override
  • @Deprecated
  • @SuppressWarnings

@Retention

@Retention被设计为仅用作另一个注解的注解。它指定保留策略。

@Documented

@Documented注解是一个标记界面,它通知工具要注解标记。

@Target

@Target 注解指定了声明的类型可以应用注解。

它被设计为仅用作对另一注解的注解。 @Target接受一个参数,它必须是ElementType枚举的常量。

目标常量注解可以应用于

  • ANNOTATION_TYPE另一个注解
  • CONSTRUCTOR 构造函数
  • FIELD 领域
  • LOCAL_VARIABLE 局部变量
  • METHOD 方法
  • PACKAGE 包
  • PARAMETER 参数
  • TYPE 类, 接口, 或者 枚举

您可以在@Target注解中指定一个或多个这些值。 要指定多个值,必须在括号分隔列表中指定它们。 例如:

@Target( { ElementType.FIELD, ElementType.LOCAL_VARIABLE } )

@Inherited

@Inherited 是一个标记注解,只能用于另一个注解声明。它只影响将在类声明中使用的注解。 @Inherited 使得超类的注解由子类继承。

@Override

@Override是只能在方法上使用的标记注解。使用@Override注解的方法必须覆盖超类中的方法。

@Deprecated

@Deprecated是标记注解。它表示声明已过时,并已被较新的表单替换。

@SuppressWarnings

@SuppressWarnings 指定可能由编译器发出的一个或多个警告被抑制。要禁止的警告由名称以字符串形式指定。此注解可应用于任何类型的声明。