Spec-Zone.ru › OpenJDK 24

Класс 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, 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/xml/sax/helpers/XMLReaderFactory.html

Spec-Zone.ru

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