@Deprecated
注解很早就存在了,如果我记得没错的话,好像是 Java 5 ( 后来我去查了资料,也的确是 Java 5 就引入了 ) 。
一个使用 @Deprecated
注解的元素,无论是一个类或是一个方法,可能是由以下原因导致了不应该再使用它
- 使用它可能会导致错误
- 在未来的版本中不被兼容
- 在未来的版本中可能会被删除
- 存在更好的更有效的替代方法
如果一个程序或代码片段使用了 @Deprecated
注解的元素,那么编译器就会生成一个警告信息,表明这个元素是不被推荐使用的。
我们都一直延续了这样的习惯好久,直到 Java 9 的发布,我才发现 @Deprecated
注解还可以做的更好
Java 9 对 @Deprecated
注解做了两项重要的增强。
- forRemoval - 指示在将来的版本中是否要删除带注解的元素。默认值为
false
- 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 面试宝典是大明哥全力打造的 Java 精品面试题,它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题,而是一套完整的 Java 知识体系,一套你 Java 知识点的扫盲贴。
它的内容包括:
- 大厂真题:Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
- 原创内容:Java 面试宝典内容全部都是大明哥原创,内容全面且通俗易懂,回答部分可以直接作为面试回答内容。
- 持续更新:一次购买,永久有效。大明哥会持续更新 3+ 年,累计更新 1000+,宝典会不断迭代更新,保证最新、最全面。
- 覆盖全面:本宝典累计更新 1000+,从 Java 入门到 Java 架构的高频面试题,实现 360° 全覆盖。
- 不止面试:内容包含面试题解析、内容详解、知识扩展,它不仅仅只是一份面试题,更是一套完整的 Java 知识体系。
- 宝典详情:https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
- 宝典总览:https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
- 宝典进展:https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw
目前 Java 面试宝典累计更新 400+ 道,总字数 42w+。大明哥还在持续更新中,下图是大明哥在 2024-12 月份的更新情况:
想了解详情的小伙伴,扫描下面二维码加大明哥微信【daming091】咨询
同时,大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ,回复【面试题】 即可免费领取。