org.w3c.dom
인터페이스 CDATASection

모든 슈퍼 인터페이스:

CharacterData, Node, Text

public interface CDATASection
extends Text 

CDATA 섹션은 마크 업이라고 보여지는 문자를 포함한 텍스트 블록을 이스케이프 하기 위해서 사용됩니다. CDATA 섹션으로 단락지어 문자로서 인식되는 것은 이 섹션의 말미의 캐릭터 라인 ]]> 뿐입니다. CDATA 섹션을 상자로 할 수 없습니다. 이 섹션의 주목적은 모든 단락 문자를 이스케이프 하는 일 없이 XML fragment등의 데이타를 뽑아 붐비는 것입니다.

CharacterData.data 속성은 CDATA 섹션에 포함되는 텍스트를 보관 유지합니다. 여기에는 CDATA 섹션에는 포함되지 않지만 이스케이프 할 필요가 있는 문자도 포함됩니다. 직렬화용으로 선택된 문자 인코딩 (charset)에 따라서는 CDATA 섹션의 일부로서 써낼 수가 없는 문자도 있습니다.

CDATASection인터페이스는 Text인터페이스를 개입시켜 CharacterData인터페이스를 상속합니다. 인접하는 CDATASection 노드는 Node인터페이스의 normalize 메서드에서는 머지 되지 않습니다.

CDATA 섹션의 내용의 자구는 확인되지 않기 때문에 캐릭터 라인「]]>」가 포함되는 일이 있습니다. 이 캐릭터 라인은, 「XML 1.0」의 섹션 2.7에 준거하고 있는 CDATA 에서는 부정합니다. 이 캐릭터 라인이 존재하는 경우에는 직렬화중에 치명적인 에러가 발생합니다. 즉, 직렬화하기 전에 이 CDATA 섹션을 분할할 필요가 있습니다 (DOMConfiguration인터페이스의 파라미터 「split-cdata-sections」인터페이스도 참조).

주: CDATASection 내에서는 일절의 마크 업이 인식되지 않기 때문에 직렬화때, 문자나 숫자의 참조를 이스케이프 수단으로서 이용할 수 없습니다. 따라서, 표시할 수 없는 문자를 포함한 캐릭터 라인 인코딩을 사용해 CDATASection 직렬화를 실시하는 경우는 어떠한 액션을 실시할 필요가 있습니다. 그렇게 하지 않으면 정형식의 XML를 생성할 수 없습니다.

주: 직렬화 처리의 문제의 해결 방법의 1개에 는 문자의 직전에 CDATA 섹션을 종료해, 문자 참조 또는 실체 참조를 사용해 그 문자를 출력해, 그 이후, 텍스트 노드에 포함되는 문자용으로 새로운 CDATA 섹션을 개시한다고 하는 방법이 있습니다. 다만, 일부의 코드 변환 라이브러리는 출력시에 encode 되지 않는 문자가 있어도, 에러나 예외를 돌려주지 않습니다. 이 때문에 직렬화중에 파괴된 데이터가 있는지 없는지를 특정하는 것은 곤란합니다.

「Document Object Model (DOM) Level 3 Core Specification」도 참조하십시오.

필드 개요

인터페이스 org.w3c.dom. Node 로부터 상속된 필드

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. Text 로부터 상속된 메서드

getWholeText, isElementContentWhitespace, replaceWholeText, splitText

인터페이스 org.w3c.dom. CharacterData 로부터 상속된 메서드

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

인터페이스 org.w3c.dom. Node 로부터 상속된 메서드

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