在博客文章《 应用JDK 9 @Deprecated增强功能》中 ,我讨论了JDK 9中 @Deprecated批注中对forRemoval()和since()可选元素(方法)的添加 。 我在那篇文章中说:“在Java SE API上应用新的JDK 9 @Deprecated方法也可以指导如何使用它们。” 在本文中,我将研究增强的@Deprecated
批注对JDK类java.util.Observable的应用 。
几乎从一开始就存在java.util.Observable
类(自Java 1.0起)。 从JDK 9开始,它将被标记为已弃用。 以下屏幕快照显示了Web浏览器中此类的Javadoc表示形式的一部分。
这是我上一篇博文中描述的 “不建议删除计划”类别中的一个类的示例。 since()
的存在提供了有关何时不推荐使用的信息(JDK 9),而缺少forRemoval()
表明缺少具体的计划来实际删除该类。 还以类似的方式弃用了java.util.Observer接口 ,并且其文档引用了Observable
类的文档。
Observable
文档不仅在不推荐使用时进行中继,而且还记录了Observable
的问题,这些问题使不推荐使用,并提供了有关可能使用的替代方案的重要信息,而不是Observable
:
此类和Observer接口已被弃用。 Observer和Observable支持的事件模型非常有限,Observable传递的通知顺序未指定,并且状态更改与通知不一一对应。 对于更丰富的事件模型,请考虑使用java.beans包。 为了在线程之间进行可靠且有序的消息传递,请考虑使用java.util.concurrent包中的并发数据结构之一。 有关React式流样式的编程,请参见Flow API。
这是一个很好的示例,说明Java开发人员如何使用Javadoc标记@deprecated
来提供与弃用相关的更详细的信息,即使使用增强的@Deprecated
注释也无法提供。 JEP 277 (“增强的弃用”)明确列出了统一的Javadoc标签@deprecated
和注释@Deprecated
为“非目标”:“该项目的目标不是将@deprecated的Javadoc标签与@Deprecated注释统一。 ”
可以弃用Observable
和Observer
其他详细信息可以在JDK-8154801中找到(“弃用Observer和Observable”)。 Josh Bloch 于1999年2月发表了一个引用,作为JDK-4180466的一部分(“为什么java.util.Observable类无法序列化。”):
此类不再处于积极开发中。 它在JDK中基本上未使用,并且在大多数情况下已被1.1 Beans / AWT事件模型取代。 …可观察性已被废弃,并且不再活跃。
在大多数情况下,似乎Observer
和Observable
的使用并不多 ,因此弃用不应该是一个大问题,尤其是考虑到没有明确的计划将其完全删除时。
翻译自: https://www.javacodegeeks.com/2017/05/javas-observer-observable-deprecated-jdk-9.html