В javadocs некоторые API (вне java.lang и java.util) "Использовать" отсутствует.
Например, XMLStreamReader. Немного неприятно, что вы не можете сказать, какие классы API возвращают нужный вам класс, на основе javadoc, и вы должны использовать некоторые другие приемы (например, функции IDE), чтобы сделать это.
Есть ли причина не включать раздел «Использование» в эти API?
Ссылка, которую вы разместили для XMLStreamReader, была для javadocs в разделе http://java.sun.com/webservice, а не для основного API JavaSE.
Документ Javadoc для XMLStreamReader в Однако в core javadoc раздел «Использование» полностью заполнен.
Что касается того, почему они разные, я подозреваю, что это просто проблема контроля качества.
Такие классы, как javax.xml.stream.XMLStreamReader, являются частью расширения Java., поэтому их можно заменить конкретными реализациями (в данном случае, если я правильно помню, реализация налог).
Вы должны получить фактический класс службы с помощью фабричного метода, используя два общедоступных класса XMLInputFactory и XMLOutputFactory. По замыслу вам не нужно знать, что такое реальный реализующий класс.
EDIT: ссылка, которую вы предоставили для XMLStreamReader, взята из пакета веб-служб для java 1.5. Я не знаю, почему отсутствует раздел использования, но как бы там ни было, в java se 6 API он включен (см. здесь). Надеюсь это поможет ...
