compact2, compact3

org.xml.sax.helpers

Класс XMLReaderFactory

java.lang. Объект

org.xml.sax.helpers. XMLReaderFactory

public final class XMLReaderFactory
extends Object

Фабрика для того, чтобы создать средство чтения XML.

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

Этот class содержит статические методы для того, чтобы создать средство чтения XML из явного имени class, или основанный на значениях по умолчанию времени выполнения:

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

Отметьте к Дистрибутивам, связанным синтаксическими анализаторами: следует изменить реализацию createXMLReader без параметров, чтобы обработать случаи, где внешние механизмы конфигурации не устанавливаются. Тот метод должен приложить все усилия, чтобы возвратить синтаксический анализатор, когда каждый находится в пути class, даже когда ничто не связывало его имя class к org.xml.sax.driver таким образом, те механизмы конфигурации видели бы это.

С тех пор:

SAX 2.0

Версия:

2.0.1 (sax2r2)

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

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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь метода

createXMLReader

public static XMLReader createXMLReader()
                                 throws SAXException

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

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

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

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

Возвраты:

Новый XMLReader.

Броски:

SAXException - Если никакое значение по умолчанию XMLReader class не может быть идентифицировано и инстанцировано.

См. Также:

createXMLReader(java.lang.String)

createXMLReader

public static XMLReader createXMLReader(String className)
                                 throws SAXException

Попытка создать средство чтения XML из имени class.

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

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

Возвраты:

Новое средство чтения XML.

Броски:

SAXException - Если class не может быть загружен, инстанцировал, и бросал к XMLReader.

См. Также:

createXMLReader()