Java9 强化的@Deprecated注解
@Deprecated注解被引入在Java 5版本中。使用@Deprecated注解标记的程序元素表明它不应该被使用,原因如下:
- 它的使用可能导致错误。
- 在未来版本中可能不兼容。
- 在未来版本中可能被移除。
- 有更好和更高效的替代方案。
当使用被弃用元素时,编译器会产生警告。Java 9对@Deprecated注解进行了两个新的增强。
- forRemoval - 表示注解元素是否会在未来版本中被移除。默认值是false。
-
since - 返回注解元素被声明为弃用的版本。默认值为空字符串。
弃用注解 with since
Java 9中的Boolean类javadoc的以下示例说明了@Deprecated注解上since属性的使用。
Boolean 类
已弃用,用于移除
下面是Java 9中System类javadoc的示例,说明了@Deprecated注解上forRemoval属性的使用方法。
System类