Java 9 - 增强的@Deprecated Annotation

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

  • 它的使用可能会导致错误.

  • 未来版本可能不兼容.

  • 未来版本可能会将其删除.

  • 一个更好,更有效的替代方案已取代它.

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

  • forRemoval : 指示在将来的版本中是否要删除带注释的元素.默认值为false.

  • ,因为 : 返回已注释元素已弃用的版本.默认值为空字符串.

不推荐使用自

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

布尔类

布尔类javadoc

使用forRemoval弃用

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

System Class

系统类javadoc