Пожалуйста, учтите, что спецификации и другая информация, содержащаяся здесь, не являются заключительными и могут быть изменены. Информация доступна для вас исключительно ради ознакомления.
 Платформа Java™
Стандарт Эд. 8

Проект сборка-b92

Пакет org.xml.sax

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

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

Пакет 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 не должны поддерживать их.

 Платформа Java™
Стандарт Эд. 8

Проект сборка-b92

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.

Проект сборка-b92




Spec-Zone.ru - all specs in one place