JavaTM Platform
Standard Ed. 6

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
 


JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.