Пакет org.xml.sax

Предоставляет интерфейсы для простого API для XML (SAX). Поддерживает как SAX1, так и SAX2 API.

Флаги стандартных функций SAX2

Одной из ключевых особенностей SAX2 является добавление флагов функций, которые могут использоваться для проверки и, возможно, изменения режимов анализатора, особенно таких режимов, как валидация. Поскольку функции идентифицируются (абсолютными) URI, любой может определить такие функции. Текущие определенные стандартные URI функций имеют префикс http://xml.org/sax/features/ перед идентификатором, например, validation. Включите или выключите функции с помощью setFeature. Эти стандартные идентификаторы следующие:

Стандартные функции

Идентификатор функции	Доступ	Значение по умолчанию	Описание
external-general-entities	чтение/запись	не определено	Указывает, обрабатывает ли этот анализатор внешние общие сущности; всегда истинно, если валидация включена.
external-parameter-entities	чтение/запись	не определено	Указывает, обрабатывает ли этот анализатор внешние параметры сущностей; всегда истинно, если валидация включена.
is-standalone	(анализ) только для чтения, (без анализа) нет	не применимо	Может быть проверен только во время анализа, после завершения обратного вызова startDocument(); только для чтения. Значение равно true, если документ указал standalone="yes" в своей декларации XML, в противном случае — false.
lexical-handler/parameter-entities	чтение/запись	не определено	Значение "true" означает, что обработчик лексических единиц будет сообщать о начале и конце сущностей параметров.
namespaces	чтение/запись	true	Значение "true" означает, что URI пространства имен и локальные имена без префиксов для имен элементов и атрибутов будут доступны.
namespace-prefixes	чтение/запись	false	Значение "true" означает, что квалифицированные имена XML (с префиксами) и атрибуты (включая атрибуты xmlns*) будут доступны.
resolve-dtd-uris	чтение/запись	true	Значение "true" означает, что идентификаторы систем в декларациях будут абсолютизированы (относительно их базовых URI) перед сообщением. (Это поведение по умолчанию для всех парсеров XML SAX2.) Значение "false" означает, что эти идентификаторы не будут абсолютизированы; парсеры предоставят базовый URI из Locator.getSystemId(). Это относится к идентификаторам систем, переданным в DTDHandler.notationDecl(), DTDHandler.unparsedEntityDecl(), и DeclHandler.externalEntityDecl(). Это не относится к EntityResolver.resolveEntity(), который не используется для сообщения о декларациях, или к LexicalHandler.startDTD(), который уже предоставляет неабсолютизированный URI.
string-interning	чтение/запись	не определено	Имеет значение "true", если все имена XML (для элементов, префиксов, атрибутов, сущностей, обозначений и локальных имен), а также URI пространства имен, будут интернированы с использованием java.lang.String.intern. Это поддерживает быстрое тестирование равенства/неравенства с константами строк, а не принудительные медленные вызовы String.equals().
unicode-normalization-checking	чтение/запись	false	Управляет тем, сообщает ли анализатор об ошибках нормализации Юникода, как описано в разделе 2.13 и Приложении B рекомендации XML 1.1. Если true, об ошибках нормализации Юникода сообщается с помощью обратного вызова ErrorHandler.error(). Такие ошибки не являются фатальными сами по себе (хотя, очевидно, другие ошибки кодирования, связанные с Юникодом, могут быть таковыми).
use-attributes2	только для чтения	не применимо	Возвращает "true", если объекты Attributes, передаваемые этим анализатором в ContentHandler.startElement(), реализуют интерфейс org.xml.sax.ext.Attributes2. Этот интерфейс предоставляет дополнительную информацию, связанную с DTD, например, указано ли атрибут в исходном тексте или задано по умолчанию.
use-locator2	только для чтения	не применимо	Возвращает "true", если объекты Locator, передаваемые этим анализатором в ContentHandler.setDocumentLocator(), реализуют интерфейс org.xml.sax.ext.Locator2. Этот интерфейс предоставляет дополнительную информацию об объекте, например, кодировку символов и используемую версию XML.
use-entity-resolver2	чтение/запись	true	Возвращает "true", если при вызове setEntityResolver с объектом, реализующим интерфейс org.xml.sax.ext.EntityResolver2, будут использоваться новые методы. Возвращает "false", чтобы указать, что эти методы не будут использоваться.
validation	чтение/запись	не определено	Управляет тем, сообщает ли анализатор все ошибки валидации; если true, все внешние сущности будут прочитаны.
xmlns-uris	чтение/запись	false	Управляет тем, рассматривает ли анализатор атрибуты объявления пространства имен, когда функция namespace-prefixes установлена, как находящиеся в пространстве имен http://www.w3.org/2000/xmlns/. По умолчанию SAX2 соответствует исходной рекомендации "Пространства имен в XML", которая явно указывает, что такие атрибуты не находятся ни в каком пространстве имен. Установка этого необязательного флага в "true" приведет к тому, что события SAX2 будут соответствовать более поздней несовместимой с обратной совместимостью редакции этой рекомендации, размещая эти атрибуты в пространстве имен.
xml-1.1	только для чтения	не применимо	Возвращает "true", если анализатор поддерживает как XML 1.1, так и XML 1.0. Возвращает "false", если анализатор поддерживает только XML 1.0.

Поддержка значений по умолчанию свойств namespaces и namespace-prefixes обязательна. Поддержка любых других флагов функций является необязательной.

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

Стандартные идентификаторы обработчиков и свойств SAX2

Для характеристик интерфейса парсера, описанных как объекты, определено отдельное пространство имен. Объекты в этом пространстве имен снова идентифицируются URI, и стандартные URI свойств имеют префикс http://xml.org/sax/properties/ перед идентификатором, например lexical-handler или dom-node. Управляйте этими свойствами с помощью setProperty(). Эти идентификаторы:

Стандартные идентификаторы свойств

Идентификатор свойства	Описание
declaration-handler	Используется для просмотра большинства деклараций DTD, за исключением тех, которые обрабатываются как лексические ("имя элемента документа равно ...") или которые являются обязательными для всех парсеров SAX (DTDHandler). Объект должен реализовывать org.xml.sax.ext.DeclHandler.
document-xml-version	Может быть проверен только во время анализа, после завершения обратного вызова startDocument(); только для чтения. Это свойство представляет собой строку, описывающую фактическую версию XML документа, например "1.0" или "1.1".
dom-node	Для парсеров типа "DOM Walker", которые игнорируют свои параметры parser.parse(), это используется для указания поддерева DOM, по которому проходит парсер. Объект должен реализовывать интерфейс org.w3c.dom.Node.
lexical-handler	Используется для просмотра некоторых событий синтаксиса, которые важны в некоторых приложениях: комментарии, разделители CDATA, выбранные включения общих сущностей и начало и конец DTD (и объявление имени элемента документа). Объект должен реализовывать org.xml.sax.ext.LexicalHandler.
xml-string	Доступно только во время вызова парсера, оно экспонирует блок символов TBS, ответственный за текущее событие.

Все эти стандартные свойства являются необязательными. Реализации XMLReader не обязаны их поддерживать.