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 指定可能由编译器发出的一个或多个警告被抑制。要禁止的警告由名称以字符串形式指定。此注释可应用于任何类型的声明。