无涯教程-Java9 - @Deprecated增强

71 阅读1分钟

@Deprecated注释是在Java 5版本中引入的。用@Deprecated注释的程序元素表示,由于以下任何原因,不建议使用它-

  • 其用法可能会导致错误。
  • 它在将来的版本中可能不被兼容。
  • 它在将来的版本中可能会被删除。
  • 一个更好,更高效的替代方法取代了它。

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

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

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

Since 注释

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

Boolean Class javadoc

forRemoval 注释

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

System Class javadoc

参考链接

www.learnfk.com/java/java9-…