Java 9 - 增强的@Deprecated 注解


@Deprecated 注解是在 java 5 版本中引入的。用 @Deprecated 注释的程序元素意味着不应出于以下任何原因使用它 -

  • 它的使用可能会导致错误。
  • 未来版本可能不兼容。
  • 它可能会在未来版本中被删除。
  • 更好、更高效的替代方案已经取代了它。

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

  • forRemoval - 指示带注释的元素是否会在未来版本中被删除。默认值为 false。

  • 因为- 返回带注释的元素被弃用的版本。默认值为空字符串。

自此后已弃用

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

布尔类

布尔类 javadoc

已弃用 forRemoval

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

系统类

系统类javadoc