org.w3c.dom

Интерфейсный DOMConfiguration

public interface DOMConfiguration

DOMConfiguration интерфейс представляет конфигурацию документа и поддерживает таблицу распознанных параметров. Используя конфигурацию, возможно измениться Document.normalizeDocument() поведение, такое как замена CDATASection узлы с Text узлы или определение типа схемы, которая должна использоваться когда проверка допустимости Document требуется. DOMConfiguration объекты также используются в [ДОМ Левель 3 Загрузки и Сохраняют] в DOMParser и DOMSerializer интерфейсы.

Названия параметра, используемые DOMConfiguration объект определяется всюду по ДОМУ Левелю 3 спецификации. Имена являются нечувствительными к регистру. Избегать возможных конфликтов, как соглашение, имена, обращающиеся к параметрам, определенным вне спецификации ДОМА, должны быть сделаны уникальными. Поскольку параметры представляются, поскольку свойствам на имена рекомендуют следовать за разделом 5.16 Идентификаторов [Unicode] с добавлением символа '-' (ДЕФИС - МИНУС), но это не осуществляется реализацией ДОМА. ДОМ Левель 3 Базовых Реализации обязан распознавать все параметры, определенные в этой спецификации. Некоторые значения параметра могут также быть обязаны поддерживаться реализацией. Сошлитесь на определение параметра, чтобы знать, должно ли значение поддерживаться или нет.

Отметьте: Параметры подобны функциям и свойствам, используемым в SAX2 [SAX].

Следующий список параметров определил в ДОМЕ:

"canonical-form"

true

[дополнительный] Канонизируют документ согласно правилам, определенным в [Канонический XML], таким как удаление DocumentType узел (если любой) от дерева, или удаления лишних объявлений пространства имен от каждого элемента. Отметьте, что это ограничивается тем, что может быть представлено в ДОМЕ; в частности нет никакого способа определить порядок атрибутов в ДОМЕ. Кроме того, Устанавливая эти параметры к true также установит состояние упомянутых ниже параметров. Более поздние изменения к состоянию одного из тех параметров вернутся "каноническая форма" назад к false. Набор параметров к false: "объекты", "нормализовать-символы", "cdata-разделы". Набор параметров к true: "пространства имен", "объявления пространства имен", "правильно построенные", "пробел контента элемента". Другие параметры не изменяются если явно не определено в описании параметров.

false

[необходимый] (значение по умолчанию) не канонизируют документ.

"cdata-sections"

true

[необходимое] Хранение (по умолчанию) CDATASection узлы в документе.

false

[требуемый] Преобразовывают CDATASection узлы в документе в Text узлы. Новое Text узел тогда объединяется с любым смежным Text узел.

"check-character-normalization"

true

[дополнительная] Проверка, если символы в документе полностью нормализуются, как определено в приложении B [XML 1.1]. Когда с последовательностью символов встречаются что проверка нормализации сбоев, ошибка с DOMError.type равняется "отказу нормализации контрольного символа", выпускается.

false

[необходимый] (значение по умолчанию) не проверяют, нормализуются ли символы.

"comments"

true

[необходимое] Хранение (по умолчанию) Comment узлы в документе.

false

[необходимое] Отбрасывание Comment узлы в документе.

"datatype-normalization"

true

[дополнительный] Представляют схему нормализованные значения в дереве, такие как XML-схема нормализованные значения в случае XML-схемы. Так как этот параметр требует, чтобы иметь информацию о схеме, "проверить" параметры будут также установлены к true. Активирование этого параметра, когда "проверяют", false не имеет никакого эффекта, и никакая нормализация схемы не произойдет.

Отметьте: Так как документ содержит результат обработки XML 1.0, этот параметр не применяется к нормализации значения атрибута как определено в разделе 3.3.3 из [XML 1.0] и только предназначается для языков схемы кроме Определения типа документа (DTD).

false

[необходимый] (значение по умолчанию) не выполняют нормализацию схемы на дереве.

"element-content-whitespace"

true

[необходимое] Хранение (по умолчанию) все пробелы в документе.

false

[дополнительное] Отбрасывание все Text узлы, которые содержат пробелы в контенте элемента, как описано в [пробел контента элемента]. Реализация, как ожидают, будет использовать атрибут Text.isElementContentWhitespace определить если a Text узел должен быть отброшен или нет.

"entities"

true

[необходимое] Хранение (по умолчанию) EntityReference узлы в документе.

false

[требуемый] Удаляют все EntityReference узлы из документа, помещая расширения объекта непосредственно в их место. Text узлы нормализуются, как определено в Node.normalize. Только нерасширенные ссылки на сущность сохраняются в документе.

Отметьте: Этот параметр не влияет Entity узлы.

"error-handler"

[требуемый] Содержит a DOMErrorHandler объект. Если с ошибкой встретятся в документе, то реализация перезвонит DOMErrorHandler зарегистрированное использование этого параметра. Реализация может обеспечить значение по умолчанию DOMErrorHandler объект. Когда вызвано, DOMError.relatedData будет содержать самый близкий узел туда, где ошибка произошла. Если реализация неспособна определить узел, где ошибка происходит, DOMError.relatedData будет содержать Document узел. Мутации к документу изнутри обработчика ошибок приведут к зависящему от реализации поведению.

"infoset"

true

[требуемый] Хранят в документе информацию, определенную в Наборе Информации XML [Набор Информации XML].This вызывает следующие параметры к false: "проверьте, если схема", "объекты", "нормализация типа данных", "cdata-разделяет" силы.This следующие параметры к true: "объявления пространства имен", "правильно построенные", "пробел контента элемента", "комментарии", "пространства имен".Other параметры, не изменяются если явно не определено в описании параметров. Отметьте что, запрашивая этот параметр с getParameter возвраты true только если отдельные параметры, определенные выше, соответственно устанавливаются.

false

Установка infoset к false не имеет никакого эффекта.

"namespaces"

true

[необходимый] (значение по умолчанию) Выполняют пространство имен, обрабатывающее как определено в.

false

[дополнительный] не выполняют обработку пространства имен.

"namespace-declarations"

Этот параметр не имеет никакого эффекта, если параметры "пространства имен" устанавливаются к false.

true

[необходимый] (значение по умолчанию) Включают атрибуты объявления пространства имен, определенные, или принимал значение по умолчанию из схемы, в документе. См. также разделы "Объявление Пространств имен" в [XML Пространства имен] и [XML Пространства имен 1.1].

false

[необходимое] Отбрасывание все атрибуты объявления пространства имен. Префиксы пространства имен ( Node.prefix) сохраняются, даже если эти параметры устанавливаются к false.

"normalize-characters"

true

[дополнительный] Полностью нормализовал символы в документе как определено в приложении B [XML 1.1].

false

[необходимый] (значение по умолчанию) не выполняют символьную нормализацию.

"schema-location"

[дополнительный] Представляют a DOMString объект, содержащий список URI, разделенных пробелами (символы, соответствующие нетерминальное производство S определенный в разделе 2.3 [XML 1.0]), который представляет схемы, против которых проверка допустимости должна произойти, то есть текущая схема. Типы схем, на которые ссылаются в этом списке, должны соответствовать тип, определенный с schema-type, иначе поведение реализации неопределено. Схемы определили, что использование этого свойства имеет приоритет к информации о схеме, определенной в документе непосредственно. Для пространства имен осведомленная схема, если схема определила использование этого свойства и схемы, определенной в экземпляре документа (то есть использование schemaLocation атрибут) в документе схемы (то есть схема использования import механизмы), совместно используют то же самое targetNamespace, схема, определенная пользователем, использующим это свойство, будет использоваться. Если две схемы определили, что использование этого свойства совместно использует то же самое targetNamespace или не имейте никакого пространства имен, поведение является зависящим от реализации. Если никакое расположение не было обеспечено, этот параметр null.

Отметьте: "schema-location" параметр игнорируется, если значение параметра "типа схемы" не устанавливается. Этому строго рекомендуют это Document.documentURI будет установлен так, чтобы реализация могла успешно разрешить любые внешние объекты, на которые ссылаются.

"schema-type"

[дополнительный] Представляют a DOMString объект, содержащий абсолютный URI и представляющий тип языка схемы, используемого, чтобы проверить документа против. Отметьте, что никакая лексическая проверка не делается на абсолютном URI. Если эти параметры не устанавливаются, значение по умолчанию может быть обеспечено реализацией, основанной на поддерживаемых языках схемы и на языке схемы, используемом во время загрузки. Если никакое значение не обеспечивается, этот параметр null.

Отметьте: Для XML-схемы [Часть 1 XML-схемы], приложения должны использовать значение "http://www.w3.org/2001/XMLSchema". Для DTD XML [XML 1.0] приложения должны использовать значение "http://www.w3.org/TR/REC-xml". Другие языки схемы выходят за рамки W3C и поэтому должны рекомендовать абсолютный URI, чтобы использовать этот метод.

"split-cdata-sections"

true

[необходимое] Разделение (по умолчанию) разделы CDATA, содержащие CDATA, разделяет маркер завершения']]>'. Когда раздел CDATA разделяется, предупреждение выпускается с a DOMError.type равняется "cdata-sections-splitted" и DOMError.relatedData равняется первому CDATASection узел в порядке документа, следующем из разделения.

false

[необходимый] Сигнал ошибка, если a CDATASection содержит непредставимый символ.

"validate"

true

[дополнительный] Требуют проверки допустимости против схемы (то есть XML-схема, DTD, любой другой тип или представление схемы) документа, поскольку это нормализуется как определено [XML 1.0]. Если ошибки проверки допустимости находятся, или никакая схема не была найдена, обработчик ошибок уведомляется. Нормализованные схемой значения не будут представлены согласно схеме в используемом, если параметр "нормализация типа данных" не будет true. Этот параметр переоценит:

• Узлы атрибута с Attr.specified равняется false, как определено в описании Attr интерфейс;
• Значение атрибута Text.isElementContentWhitespace для всех Text узлы;
• Значение атрибута Attr.isId для всех Attr узлы;
• Атрибуты Element.schemaTypeInfo и Attr.schemaTypeInfo.

Отметьте: "проверьте, если схема" и "проверяет", являются взаимоисключающими, устанавливая одного из них к true установит другой один в false. Приложения должны также считать устанавливание параметров "правильно построенным" к true, который является значением по умолчанию для той опции, проверяя документа.

false

[необходимый] (значение по умолчанию) не выполняют обработку схемы, включая внутреннюю обработку подмножества. Информация значений атрибута по умолчанию хранится. Отметьте, что проверка допустимости могла бы все еще произойти, если "проверяют, если схема" true .

"validate-if-schema"

true

[дополнительная] проверка допустимости Включения, только если объявление для элемента документа может быть найдено в схеме (независимо от того, где это находится, то есть XML-схема, DTD, или любой другой тип или представление схемы). Если проверка допустимости включается, у этого параметра есть то же самое поведение, как параметр "проверяет" набора к true.

Отметьте: "проверьте, если схема" и "проверяет", являются взаимоисключающими, устанавливая одного из них к true установит другой один в false.

false

[необходимый] (значение по умолчанию) Никакая обработка схемы не должна быть выполнена, если у документа есть схема, включая внутреннюю обработку подмножества. Информация значений атрибута по умолчанию хранится. Отметьте, что проверка допустимости должна все еще произойти, если "проверяют", true.

"well-formed"

true

[необходимая] Проверка (по умолчанию), если все узлы являются XML, хорошо сформированным согласно версии XML в использовании в Document.xmlVersion:

• проверьте если атрибут Node.nodeName содержит недопустимые символы согласно его узлу, вводят и генерируют a DOMError из типа "wf-invalid-character-in-node-name", с a DOMError.SEVERITY_ERROR серьезность, в случае необходимости;
• проверьте если текстовый контент внутри Attr, Element, Comment, Text, CDATASection узлы для недопустимых символов и генерируют a DOMError из типа "wf-invalid-character", с a DOMError.SEVERITY_ERROR серьезность, в случае необходимости;
• проверьте если данные внутри ProcessingInstruction узлы для недопустимых символов и генерируют a DOMError из типа "wf-invalid-character", с a DOMError.SEVERITY_ERROR серьезность, в случае необходимости;

false

[дополнительный] не проверяют на отмеченность XML.

Разрешение системных идентификаторов, связанных с объектами, делается, используя Document.documentURI. Однако, когда функция "LS", определенный в [ДОМ Левель, которого 3 Загрузки и Спасают], поддерживается реализацией ДОМА, параметр "преобразователь ресурса" может также использоваться на DOMConfiguration объекты, присоединенные к Document узлы. Если эти параметры устанавливаются, Document.normalizeDocument() вызовет преобразователь ресурса вместо использования Document.documentURI.

См. также Объектную модель документа (ДОМ) Спецификация Ядра Уровня 3.

С тех пор:

ДОМ Левель 3

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

Методы

Модификатор и Тип	Метод и Описание
boolean	canSetParameter(String name, Object value) Проверьте, если устанавливание параметров к определенному значению поддерживается.
Объект	getParameter(String name) Возвратите значение параметра если известный.
DOMStringList	getParameterNames() Список параметров поддерживается этим DOMConfiguration возразите и для которого по крайней мере одно значение может быть установлено приложением.
void	setParameter(String name, Object value) Установите значение параметра.

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

setParameter

void setParameter(String name,
                Object value)
                  throws DOMException

Установите значение параметра.

Параметры:

name - Имя параметра, чтобы установить.

value - Новое значение или null если пользователь хочет сбросить параметр. В то время как тип параметра, передаваемого по значению определяется как DOMUserData, объектный тип должен соответствовать тип, определенный определением параметра. Например, если параметр является "обработчиком ошибок", значение должно иметь тип DOMErrorHandler.

Броски:

DOMException - NOT_FOUND_ERR: Повышенный, когда название параметра не распознается.
NOT_SUPPORTED_ERR: Повышенный, когда название параметра распознается, но требуемое значение не может быть установлено.
TYPE_MISMATCH_ERR: Повышенный, если тип значения для этого названия параметра является несовместимым с типом математического ожидания.

getParameter

Object getParameter(String name)
                    throws DOMException

Возвратите значение параметра если известный.

Параметры:

name - Имя параметра.

Возвраты:

Текущий объект, связанный с указанным параметром или null если никакой объект не был связан или если параметр не поддерживается.

Броски:

DOMException - NOT_FOUND_ERR: Повышенный, когда название параметра не распознается.

canSetParameter

boolean canSetParameter(String name,
                      Object value)

Проверьте, если устанавливание параметров к определенному значению поддерживается.

Параметры:

name - Имя параметра, чтобы проверить.

value - Объект. если null, возвращенное значение true.

Возвраты:

true если параметры могли бы быть успешно установлены к указанному значению, или false если параметр не распознается, или требуемое значение не поддерживается. Это не изменяет текущую стоимость параметра непосредственно.

getParameterNames

DOMStringList getParameterNames()

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