Java 9 - 增强的@Deprecated 注解
@Deprecated 注解是在 java 5 版本中引入的。带有 @Deprecated 注释的程序元素意味着它不应出于以下任何原因使用 -
- 它的使用可能会导致错误。
- 未来版本可能不兼容。
- 它可能会在未来的版本中被移除。
- 一种更好、更有效的替代方案已经取代了它。
每当使用不推荐使用的元素时,编译器都会生成警告。在 Java 9 中,@Deprecated 注解做了两个新的增强。
-
删除 − 指示带注释的元素是否会在未来版本中被删除。默认值为false。
-
因为 - 返回注释元素被弃用的版本。默认值为空字符串。
自弃用
以下 Java 9 上的 Boolean 类 javadoc 示例说明了在 @Deprecated 注解上使用 since 属性。
布尔类
forRemoval 已弃用
以下 Java 9 上的 System 类 javadoc 示例说明了在 @Deprecated 注释上使用 forRemoval 属性。
系统类
java