十三、Java 9 新特性 – 增强 @Deprecated 注解

文章永久连接：https://tech.souyunku.com/?p=2431

@Deprecated 注解很早就存在了，如果我记得没错的话，好像是 Java 5 ( 后来我去查了资料，也的确是 Java 5 就引入了 ) 。

一个使用 @Deprecated 注解的元素，无论是一个类或是一个方法，可能是由以下原因导致了不应该再使用它

1、 使用它可能会导致错误
2、 在未来的版本中不被兼容
3、 在未来的版本中可能会被删除
4、 存在更好的更有效的替代方法

如果一个程序或代码片段使用了 @Deprecated 注解的元素，那么编译器就会生成一个警告信息，表明这个元素是不被推荐使用的。

我们都一直延续了这样的习惯好久，直到 Java 9 的发布，我才发现 @Deprecated 注解还可以做的更好

Java 9 对 @Deprecated 注解做了两项重要的增强。

1、 forRemoval – 指示在将来的版本中是否要删除带注解的元素。默认值为 false
2、 since – 返回注解元素刚添加 @Deprecated 注解的版本。

一看不知道，看了很吃惊，这两个属性，还是蛮有作用的

@Deprecated 的 since 属性

对 since 的使用，你可以查阅 Java 9 的官方文档中 Boolean 类型的文档，在该文档中演示了如何在 @Deprecated 注解上使用 since 属性

文档地址 https://docs.oracle.com/javase/9/docs/api/java/lang/Boolean.html#Boolean-boolean-

可以看到下图中粉色框框的内容

@Deprecated 的 forRemoval 属性

关于 @Deprecated 的 forRemoval 属性的使用，可以查看官方提供的文档中的有关 System 类的部分，该部分演示了 @Deprecated 注解使用 forRemoval 属性

文档地址 https://docs.oracle.com/javase/9/docs/api/java/lang/System.html#runFinalizersOnExit-boolean-

可以看到下图中粉色框框的内容

干货推荐

本站推荐：精选优质专栏

附录：Java 9 新特性 系列文章

• 一、Java 9 新特性 – 介绍
• 二、Java 9 新特性 – 特性简介
• 三、Java 9 新特性 – 环境配置
• 四、Java 9 新特性 – 模块化
• 五、Java 9 新特性 – REPL ( JShell )
• 六、Java 9 新特性 – 改进 JavaDocs
• 七、Java 9 新特性 – 多版本共存 JAR
• 八、Java 9 新特性 – 集合不可变实例工厂方法
• 九、Java 9 新特性 – 接口 ( interface ) 的私有方法
• 十、Java 9 新特性 – 改进进程管理 API
• 十一、Java 9 新特性 – 增强流 ( Stream ) API
• 十二、Java 9 新特性 – try-with-resources 语句
• 十三、Java 9 新特性 – 增强 @Deprecated 注解
• 十四、Java 9 新特性 – 内部类的方块操作符
• 十五、Java 9 新特性 – Option 类
• 十六、Java 9 新特性 – 多分辨率图像 API
• 十七、Java 9 新特性 – CompletableFuture API ( 上 )
• 十八、Java 9 新特性 – CompletableFuture API ( 中 )
• 十九、Java 9 新特性 – CompletableFuture API ( 下 )
• 二十、Java 9 新特性 – 其它特性