Класс SAXParserFactory

protected SAXParserFactory()

Защищённый конструктор для принудительного использования newInstance().

public static SAXParserFactory newInstance()

Получить новый экземпляр SAXParserFactory. Этот статический метод создаёт новый экземпляр фабрики. Этот метод использует следующую процедуру поиска для определения реализации SAXParserFactory класса для загрузки:

• Используйте свойство javax.xml.parsers.SAXParserFactory системы.
• Используйте файл свойств "lib/jaxp.properties" в каталоге JRE. Этот файл конфигурации находится в стандартном формате java.util.Properties и содержит полное имя класса реализации с ключом, являющимся системным свойством, определённым выше. Файл jaxp.properties считывается только один раз реализацией JAXP, а его значения кэшируются для последующего использования. Если файл не существует при первой попытке чтения из него, дальнейшие попытки проверки его существования не предпринимаются. Изменить значение любого свойства в jaxp.properties после первого чтения невозможно.
• Используйте средства загрузки поставщиков услуг, определённые классом ServiceLoader, чтобы попытаться найти и загрузить реализацию службы, используя стандартный механизм загрузки: средство загрузки поставщика услуг будет использовать класс загрузки контекста текущей потока, чтобы попытаться загрузить службу. Если класс загрузки контекста равен null, будет использован системный класс загрузки.
• В противном случае возвращается системная реализация по умолчанию.

После того, как приложение получило ссылку на SAXParserFactory, оно может использовать фабрику для настройки и получения экземпляров анализатора.

Совет по устранению неполадок

Установка системного свойства jaxp.debug заставит этот метод печатать множество сообщений отладки в System.err о том, что он делает и где ищет.

Если у вас возникли проблемы с загрузкой SAXParser, попробуйте:

java -Djaxp.debug=1 YourProgram ....

public static SAXParserFactory newInstance(String factoryClassName,
                                           ClassLoader classLoader)

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

После того, как приложение получило ссылку на SAXParserFactory, оно может использовать фабрику для настройки и получения экземпляров анализатора.

Совет по устранению неполадок

Установка системного свойства jaxp.debug заставит этот метод печатать множество сообщений отладки в System.err о том, что он делает и где ищет.

Если у вас возникли проблемы, попробуйте:

java -Djaxp.debug=1 YourProgram ....

public abstract SAXParser newSAXParser()
                                throws ParserConfigurationException,
                                       SAXException

Создаёт новый экземпляр SAXParser, используя текущие параметры конфигурации фабрики.

public void setNamespaceAware(boolean awareness)

public void setValidating(boolean validating)

Указывает, будет ли анализатор, созданный этим кодом, проверять документы по мере их разбора. По умолчанию значение установлено в false.

Обратите внимание, что «валидация» здесь означает валидирующий анализатор, как определено в рекомендации по XML. Другими словами, это в основном просто управляет валидацией DTD. (за исключением устаревших двух свойств, определённых в JAXP 1.2.)

Для использования современных языков схем, таких как W3C XML Schema или RELAX NG вместо DTD, вы можете настроить свой анализатор как невалидирующий анализатор, оставив метод setValidating(boolean) false, а затем использовать метод setSchema(Schema) для сопоставления схемы с анализатором.

public boolean isNamespaceAware()

public boolean isValidating()

public abstract void setFeature(String name,
                                boolean value)
                         throws ParserConfigurationException,
                                SAXNotRecognizedException,
                                SAXNotSupportedException

Устанавливает определённый параметр в базовой реализации org.xml.sax.XMLReader. Список основных параметров и свойств можно найти по адресу http://www.saxproject.org/

Все реализации обязаны поддерживать параметр XMLConstants.FEATURE_SECURE_PROCESSING. Когда параметр

• true: реализация ограничит обработку XML в соответствии с ограничениями реализации. Примеры включают ограничения расширения сущностей и конструкции XML Schema, которые потребляют большие объёмы ресурсов. Если обработка XML ограничена по соображениям безопасности, это будет сообщено с помощью вызова зарегистрированного обработчика ErrorHandler.fatalError(SAXParseException exception). См. методы SAXParser parse для указания обработчика.
• Когда параметр false, реализация будет обрабатывать XML в соответствии со спецификациями XML, не учитывая возможные ограничения реализации.

public abstract boolean getFeature(String name)
                            throws ParserConfigurationException,
                                   SAXNotRecognizedException,
                                   SAXNotSupportedException

Возвращает запрашиваемый параметр в базовой реализации org.xml.sax.XMLReader.

public Schema getSchema()

public void setSchema(Schema schema)

Установите Schema для использования парсерами, созданными из этой фабрики.

Когда Schema не равен null, парсер будет использовать созданный из него валидатор для проверки документов перед передачей информации приложению.

Если валидатор обнаружит предупреждения/ошибки/критические ошибки, парсер должен обработать их так, как если бы эти ошибки были обнаружены самим парсером. Другими словами, если пользователь указал ErrorHandler, он должен получить эти ошибки; в противном случае они должны обрабатываться в соответствии с правилами обработки ошибок по умолчанию, специфичными для реализации.

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

Изначально null устанавливается в качестве Schema.

Эта обработка будет выполняться даже если метод isValidating() возвращает false.

Использование свойств http://java.sun.com/xml/jaxp/properties/schemaSource и/или http://java.sun.com/xml/jaxp/properties/schemaLanguage в сочетании с объектом Schema, не равным null, является ошибкой. Такая конфигурация вызовет исключение SAXException при установке этих свойств на SAXParser.

Примечание для разработчиков

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

public void setXIncludeAware(boolean state)

Устанавливает состояние обработки XInclude.

Если в экземпляре документа найден тег XInclude, должен ли он обрабатываться в соответствии со спецификацией XML Включения (XInclude) Версия 1.0.

Обработка XInclude по умолчанию false.

public boolean isXIncludeAware()

Получить состояние обработки XInclude.