Java9 - 增强的@Deprecated 注解

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

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

每当使用已弃用的元素时,编译器都会生成警告。 在 Java9 中,对 @Deprecated 注解进行了两项新的增强。

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

  • since − 返回已弃用注解元素的版本。 默认值为空字符串。


已弃用 since

以下 Java9 上 Boolean 类 javadoc 的示例说明了在 @Deprecated 注解上使用 since 属性。

Boolean 类

Boolean Class javadoc

已弃用 forRemoval

以下 Java9 System 类 javadoc 示例说明了在 @Deprecated 注解上使用 forRemoval 属性。

System 类

System Class javadoc