Javadoc「使用」部分 - 爲什麼缺少？

在javadoc中的一些API（java.lang和java.util之外）缺少"Use"部分。例如Javadoc「使用」部分 - 爲什麼缺少？

XMLStreamReader。你不能根據javadoc知道API的哪些類返回需要的類，並且你必須使用其他一些技巧（如IDE功能）來完成此操作。

是否有任何理由不在這些API中包含「使用」部分？

2010-01-22 Bozho

您爲XMLStreamReader發佈的鏈接適用於http://java.sun.com/webservice下的javadocs，而不是核心JavaSE API。

但是，對於XMLStreamReader in the core javadoc的javadoc確實已將「使用」部分完全填充。

至於他們爲什麼不同，我懷疑這只是一個質量控制問題。

2010-01-23 15:42:22 skaffman

像javax.xml.stream.XMLStreamReader這樣的類是Java extension機制的一部分，因此它們可以用特定實現（在這種情況下，如果我正確記得，stax的實現）替換。

通過使用兩個公共類XMLInputFactory和XMLOutputFactory，您應該通過工廠方法獲得實際的服務類。在設計上，你不需要知道什麼是實際的實施課程。

編輯：您爲XMLStreamReader提供的鏈接來自Java 1.5的Web服務包。我不知道爲什麼使用部分丟失，但是無論它的價值如何，它都包含在內（參見here）。希望這有助於...

2010-01-22 16:26:24 Yoni

是的，但是在__中使用__特別有用。「另見」部分通常很有用，但並非總是如此。 XMLStreamReader是boostrap類的一部分 - 它在rt.jar – Bozho 2010-01-22 20:46:34

中，您能否提供一個帶有示例的鏈接？也許我誤解了你指的是什麼「用法」。 – Yoni 2010-01-22 23:28:32

http://java.sun.com/javase/6/docs/api/java/util/class-use/List.html – Bozho 2010-01-23 15:30:12

回答