Spec-Zone.ru › OpenJDK 25

Класс XMLReaderFactory

java.lang.Object
org.xml.sax.helpers.XMLReaderFactory
@Deprecated(since="9") public final class XMLReaderFactory extends Object
Устарело.
Рекомендуется использовать вместо него SAXParserFactory.
Фабрика для создания XML-ридера.

Этот класс содержит статические методы для создания 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(String className)
Устарело.
Попытка создать XML-ридер по имени класса.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание методов

createXMLReader

public static XMLReader createXMLReader() throws SAXException
Устарело.
Получает новый экземпляр XMLReader. Для поиска и загрузки класса реализации XMLReader этот метод использует следующую упорядоченную процедуру поиска:
  1. Если системное свойство org.xml.sax.driver имеет значение, оно используется как имя класса XMLReader.
  2. Используется механизм загрузки поставщиков служб, определённый классом ServiceLoader, для попытки найти и загрузить реализацию службы XMLReader с помощью загрузчика классов контекста текущего потока. Если загрузчик классов контекста равен null, будет использоваться системный загрузчик классов.
  3. Устарело. Поиск имени класса в файле META-INF/services/org.xml.sax.driver в JAR-файле, доступном среде выполнения.
  4. В противном случае возвращается реализация, используемая по умолчанию в системе.

Примечание API:
Процесс поиска имени класса в файле META-INF/services/org.xml.sax.driver в JAR-файле не соответствует спецификации механизма загрузки поставщиков служб, определённой в ServiceLoader, и поэтому не поддерживает модульность. Он устарел начиная с Java SE 9 и может быть удалён в одном из будущих выпусков.
Возвращает:
новый XMLReader.
Выбрасывает:
SAXException — если класс XMLReader по умолчанию не удаётся определить и создать.
См. также:
  • createXMLReader(java.lang.String)

createXMLReader

public static XMLReader createXMLReader(String className) throws SAXException
Устарело.
Попытка создать XML-ридер по имени класса.

Получив имя класса, этот метод пытается загрузить и создать экземпляр класса в качестве XML-ридера.

Обратите внимание, что этот метод нельзя использовать в средах, где вызывающему коду (например, апплету) не разрешена динамическая загрузка классов.

Параметры:
className — имя класса
Возвращает:
Новый XML-ридер.
Выбрасывает:
SAXException — если класс не удаётся загрузить, создать или привести к типу XMLReader.
См. также:
  • createXMLReader()

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API