Java 简明教程

Java - Enhanced @Deprecated Annotation

@Deprecated 注释在 java 5 版本中引入。用 @Deprecated 注释的程序元素表示不应使用该元素,原因如下 -

  1. 其用法可能导致错误。

  2. 它可能与未来版本不兼容。

  3. 它可能在未来版本中被删除。

  4. 一个更好且高效的替代方案已经取代了它。

每当使用已过期的元素时,编译器都会生成警告。使用 Java 9,会在 @Deprecated 注释中进行两项新增强。

  1. forRemoval - 表示已注释的元素是否会在未来版本中移除。默认值为 false。

  2. since - 返回已注释的元素已过期的版本。默认值为一个空字符串。

Deprecated with since

以下 Java 9 中 Boolean 类 javadoc 的示例说明了如何在 @Deprecated 注释中使用 since 属性。

boolean

Deprecated with forRemoval

以下 Java 9 中 System 类 javadoc 的示例说明了如何在 @Deprecated 注释中使用 forRemoval 属性。

system