Java 9增强了@Deprecated注释


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

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

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

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

  • since - 返回注释元素已过时的版本。 默认值是空字符串。

自此弃用

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

布尔类

布尔类javadoc

已弃用forRemoval

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

系统类

系统类javadoc