Spec-Zone.ru › OpenJDK 21

Класс 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 так, чтобы эти механизмы конфигурации увидели его.

Since:
1.4, SAX 2.0

Краткое описание методов

Модификатор и тип Метод Описание
static XMLReader createXMLReader()
Устарело.
Получает новый экземпляр XMLReader.
static XMLReader createXMLReader(String className)
Устарело.
Попытка создать XML-ридер по имени класса.

Методы, объявленные в классе java.lang.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 Note:
Процесс поиска имени класса в файле 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()

© 1993, 2023, 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/21/docs/api/java.xml/org/xml/sax/helpers/XMLReaderFactory.html

Spec-Zone.ru

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