org.w3c.dom

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

Все Суперинтерфейсы:

CharacterData, Узел, текст

public interface CDATASection
extends Text

Разделы CDATA используются, чтобы выйти из блоков текста, содержащего символы, которые были бы иначе расценены как разметка. Единственный разделитель, который распознается в разделе CDATA,"]]>" строка, которая заканчивает раздел CDATA. Разделы CDATA не могут быть вложены. Их основная цель для включения материала, такого как фрагменты XML, не будучи должен выйти из всех разделителей.

CharacterData.data атрибут содержит текст, который содержится разделом CDATA. Отметьте, что это может содержать символы, которых нужно оставить за пределами разделов CDATA и что, в зависимости от кодировки символов ("набор символов"), выбранный для сериализации, может быть невозможно выписать некоторые символы как часть раздела CDATA.

CDATASection интерфейс наследовался от CharacterData интерфейс через Text интерфейс. Смежный CDATASection узлы не объединяются при помощи normalize метод Node интерфейс.

Никакая лексическая проверка не делается на контенте раздела CDATA, и поэтому возможно иметь символьную последовательность "]]>" в контенте, который недопустим в разделе CDATA на раздел 2.7 из [XML 1.0]. Присутствие этой символьной последовательности должно генерировать фатальную ошибку во время сериализации, или раздел cdata должен быть splitted перед сериализацией (см. также параметр "split-cdata-sections" в DOMConfiguration интерфейс).

Отметьте: Поскольку никакая разметка не распознается в пределах a CDATASection, символьные числовые ссылки не могут использоваться в качестве механизма escape, сериализируя. Поэтому, меры должны быть предприняты, сериализируя a CDATASection с кодировкой символов, где некоторые из содержавших символов не могут быть представлены. Отказ сделать так не произвел бы правильно построенный XML.

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

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

Полевая Сводка

Поля, наследованные от интерфейса org.w3c.dom. Узел

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

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

Методы, наследованные от интерфейса org.w3c.dom. Текст

getWholeText, isElementContentWhitespace, replaceWholeText, splitText

Методы, наследованные от интерфейса org.w3c.dom. CharacterData

appendData, deleteData, getData, getLength, insertData, replaceData, setData, substringData

Методы, наследованные от интерфейса org.w3c.dom. Узел

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData