Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс среды выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного периода реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного периода реального времени.

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

createXMLReader

public static XMLReader createXMLReader() throws SAXException

Устарело.

Получает новый экземпляр XMLReader. Этот метод использует следующую упорядоченную процедуру поиска, чтобы найти и загрузить класс реализации XMLReader:

Если системное свойство org.xml.sax.driver имеет значение, оно используется как имя класса XMLReader.
Для поиска и загрузки реализации службы XMLReader используется механизм загрузки поставщиков служб, определенный классом ServiceLoader, с помощью загрузчика классов контекста текущего потока. Если загрузчик классов контекста равен 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-считыватель по имени класса.

Получив имя класса, этот метод пытается загрузить и создать экземпляр класса в качестве 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.