java - 查找 Java 文档已弃用的消息

Question

关闭。这个问题需要多问 focused 。目前不接受答案。

---

想要改进此问题吗？更新问题，使其仅关注一个问题 editing this post .

已关闭 5 年前。

Improve this question

如何导航到 Java 文档中有关已弃用类的信息性消息？

我在其他答案中看到过类似的内容:

来自 StringTokenizer 文档:

StringTokenizer is a legacy class that is retained for compatibility reasons although its use is discouraged in new code. It is recommended that anyone seeking this functionality use the split method of String or the java.util.regex package instead.

但是如何在 Java 文档中获取此信息性消息？我只能看到顶部有一个已弃用的链接。我需要额外的信息，以便我可以了解它被弃用的原因并使用它的替代方案。

Answer 1

没有任何可靠的方法可以做到这一点。您找到的文本是关于类(class)的非正式建议。此类尚未正式弃用。已弃用意味着 Java 上下文中非常具体的事物。它比“不鼓励在新代码中使用”强得多。

如果某个类或类成员在 Java 中确实被弃用，您将在源代码中看到一个 @Deprecated 注释。这就是Java工具链所关注的。在适当的情况下，还可能有一个 @deprecated javadoc 标记，其中包含替代方案的解释和建议。这就是 javadoc 中的“Deprecated:”标题。

查找像您所识别的示例这样的非正式建议可能需要在 Java 库代码库或 javadoc 树中搜索“遗留”和“不推荐”等关键短语。然后，您需要手动过滤掉误报。