Класс XMLReaderFactory
@Deprecated(since="9") public final class XMLReaderFactory extends Object
Этот класс содержит статические методы для создания XML-ридера с явно указанным именем класса или на основе значений по умолчанию во время выполнения:
try {
XMLReader myReader = XMLReaderFactory.createXMLReader();
} catch (SAXException e) {
System.err.println(e.getMessage());
}
Примечание для дистрибутивов, поставляемых вместе с парсерами: Вам следует изменить реализацию метода createXMLReader без аргументов, чтобы он обрабатывал случаи, когда внешние механизмы конфигурации не настроены. Этот метод должен по возможности возвращать парсер, если он есть в пути классов, даже если никакая настройка не связала его имя класса с org.xml.sax.driver, чтобы эти механизмы конфигурации могли его обнаружить.
- Начиная с:
- 1.4, SAX 2.0
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
static XMLReader |
createXMLReader() |
Устарело. Получает новый экземпляр XMLReader. |
static XMLReader |
createXMLReader |
Устарело. Попытка создать XML-ридер по имени класса. |
Подробное описание методов
createXMLReader
public static XMLReader createXMLReader() throws SAXException
XMLReader. Для поиска и загрузки класса реализации XMLReader этот метод использует следующую упорядоченную процедуру поиска: - Если системное свойство
org.xml.sax.driverимеет значение, оно используется как имя класса XMLReader. - Используется механизм загрузки поставщиков служб, определённый классом
ServiceLoader, для попытки найти и загрузить реализацию службыXMLReaderс помощью загрузчика классов контекста текущего потока. Если загрузчик классов контекста равен null, будет использоваться системный загрузчик классов. - Устарело. Поиск имени класса в файле
META-INF/services/org.xml.sax.driverв JAR-файле, доступном среде выполнения. -
В противном случае возвращается реализация, используемая по умолчанию в системе.
- Примечание API:
- Процесс поиска имени класса в файле
META-INF/services/org.xml.sax.driverв JAR-файле не соответствует спецификации механизма загрузки поставщиков служб, определённой вServiceLoader, и поэтому не поддерживает модульность. Он устарел начиная с Java SE 9 и может быть удалён в одном из будущих выпусков. - Возвращает:
- новый XMLReader.
- Выбрасывает:
-
SAXException— если класс XMLReader по умолчанию не удаётся определить и создать. - См. также:
createXMLReader
public static XMLReader createXMLReader(String className) throws SAXException
Получив имя класса, этот метод пытается загрузить и создать экземпляр класса в качестве XML-ридера.
Обратите внимание, что этот метод нельзя использовать в средах, где вызывающему коду (например, апплету) не разрешена динамическая загрузка классов.
- Параметры:
-
className— имя класса - Возвращает:
- Новый XML-ридер.
- Выбрасывает:
-
SAXException— если класс не удаётся загрузить, создать или привести к типу XMLReader. - См. также:
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/xml/sax/helpers/XMLReaderFactory.html
SAXParserFactory.