Пакет org.xml.sax

Этот пакет обеспечивает базовые API SAX.

См.: Описание

Интерфейсная Сводка

Интерфейс	Описание
AttributeList	Осуждаемый Этот интерфейс был заменен SAX2 Attributes интерфейс, который включает поддержку Пространства имен.
Атрибуты	Интерфейс для списка атрибутов XML.
ContentHandler	Получите уведомление о логическом контенте документа.
DocumentHandler	Осуждаемый Этот интерфейс был заменен SAX2 ContentHandler интерфейс, который включает поддержку Пространства имен.
DTDHandler	Получите уведомление об основных связанных с DTD событиях.
EntityResolver	Основной интерфейс для того, чтобы разрешить объекты.
ErrorHandler	Основной интерфейс для обработчиков ошибок SAX.
Локатор	Интерфейс для того, чтобы связать событие SAX с расположением документа.
Синтаксический анализатор	Осуждаемый Этот интерфейс был заменен SAX2 XMLReader интерфейс, который включает поддержку Пространства имен.
XMLFilter	Интерфейс для фильтра XML.
XMLReader	Интерфейс для того, чтобы считать использование XML-документа обратные вызовы.

Сводка класса

Класс	Описание
HandlerBase	Осуждаемый Этот класс работает с осуждаемым DocumentHandler интерфейс.
InputSource	Единственный входной источник для объекта XML.

Сводка исключения

Исключение	Описание
SAXException	Инкапсулируйте общую ошибку SAX или предупреждение.
SAXNotRecognizedException	Класс исключений для нераспознанного идентификатора.
SAXNotSupportedException	Класс исключений для недопустимой операции.
SAXParseException	Инкапсулируйте ошибку синтаксического анализа XML или предупреждение.

Пакет org.xml.sax Описание

Этот пакет обеспечивает базовые API SAX. Некоторые API SAX1 осуждаются, чтобы поощрить интеграцию понимания пространства имен в проекты новых приложений и в обслуживание существующей инфраструктуры.

См. http://www.saxproject.org для получения дополнительной информации о SAX.

Значения параметра Стандарта SAX2

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

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

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

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

Обработчик Стандарта SAX2 и ID Свойства

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

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

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