Класс XMLReaderFactory

java.lang.Object
- org.xml.sax.helpers.XMLReaderFactory

public final class XMLReaderFactory
extends Object

Фабрика для создания XML-ридера.

Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не имеет ГАРАНТИЙ. См. http://www.saxproject.org для получения дополнительной информации.

Этот класс содержит статические методы для создания XML-ридера по явному имени класса или на основе значений по умолчанию во время выполнения:

try {
   XMLReader myReader = XMLReaderFactory.createXMLReader();
 } catch (SAXException e) {
   System.err.println(e.getMessage());
 }

Примечание для дистрибутивов, объединенных с парсерами: Вы должны изменить реализацию метода createXMLReader без аргументов для обработки случаев, когда внешние механизмы конфигурации не настроены. Этот метод должен по возможности возвращать парсер, когда он находится в пути класса, даже когда ничего не связывает его имя класса с org.xml.sax.driver, чтобы эти механизмы конфигурации его видели.

Since:: SAX 2.0
Version:: 2.0.1 (sax2r2)

Методы

Модификатор и тип	Метод и описание
`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 определяется путем последовательного перебора этих вариантов и использования первого, который выполняется успешно:

Если системная переменная org.xml.sax.driver имеет значение, оно используется в качестве имени класса XMLReader.
Используется API "Сервисы JAR" для поиска имени класса в файле META-INF/services/org.xml.sax.driver в доступных jar-файлах среды выполнения.
Дистрибутивы SAX-парсеров настоятельно рекомендуются предоставить имя класса XMLReader по умолчанию, которое будет действовать только в том случае, если предыдущие варианты (в этом списке) не увенчались успехом.
Наконец, если ParserFactory.makeParser() может вернуть системный парсер SAX1 по умолчанию, этот парсер оборачивается в ParserAdapter. (Это средство миграции для сред SAX1, где системная переменная org.xml.sax.parser часто может быть использована.)

В таких средах, как небольшие встраиваемые системы, которые не могут поддерживать такую гибкость, могут использоваться другие механизмы определения значений по умолчанию.

Обратите внимание, что во многих средах Java системные переменные могут быть инициализированы в командной строке. Это означает, что в большинстве случаев установка хорошего значения для этой переменной гарантирует успешное выполнение вызовов этого метода, за исключением случаев вмешательства политик безопасности. Это также позволит максимизировать переносимость приложения в более старые среды SAX с менее надежными реализациями этого метода.

Возвращает:: Новый XMLReader.
Исключения:: SAXException - Если класс XMLReader по умолчанию не может быть идентифицирован и создан.
См. также:: createXMLReader(java.lang.String)

createXMLReader

public static XMLReader createXMLReader(String className)
                                 throws SAXException

Попытка создать XML-ридер по имени класса.

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

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

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

© 1993, 2020, 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.