Java 教程

Java 控制语句

面向对象编程

Java 内置类

Java 文件处理

Java 错误和异常

Java 多线程

Java 同步

Java 网络编程

Java 集合

Java 接口

Java 数据结构

Java 集合算法

高级 Java

Java 其他

Java API 和框架

Java 类引用

Java 有用资源

Java - 增强的 @Deprecated 注解



@Deprecated 注解是在 Java 5 版本中引入的。用 @Deprecated 注解的程序元素表示不应该使用它,原因如下:

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

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

  • forRemoval - 指示被注解的元素是否可能在将来的版本中被移除。默认值为 false。

  • since - 返回被注解的元素何时被弃用的版本。默认值为空字符串。

使用 since 的弃用

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

Boolean 类

Boolean Class javadoc

使用 forRemoval 的弃用

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

System 类

System Class javadoc
广告