org.xml.sax.helpers

Класс XMLReaderFactory

java.lang. Объект

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

С тех пор:

SAX 2.0

Сводка метода

Методы

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

Методы java.lang унаследованный от класса. Объект

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.
• JAR "API Служб" используется, чтобы искать имя класса в META-INF/services/org.xml.sax.driver файле в jarfiles, доступном времени выполнения.
• Дистрибутивы синтаксического анализатора SAX строго поощряются обеспечить имя класса XMLReader по умолчанию, которое вступит в силу только, когда предыдущие опции (в этом списке) не будут успешны.
• Наконец, если ParserFactory.makeParser() может возвратить системное значение по умолчанию синтаксический анализатор SAX1, тот синтаксический анализатор обертывается в a 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()