org.w3c.dom
인터페이스 CharacterData

모든 슈퍼 인터페이스:

Node

기존의 서브 인터페이스의 일람:

CDATASection , Comment , Text

public interface CharacterData

extends Node

CharacterData 인터페이스는 속성과 메소드세트를 추가해 Node 를 확장하는 것으로써, DOM 내의 캐릭터 데이터에 액세스 할 수 있게 합니다. 이러한 세트에 대해서는 이것들을 실제로 사용하는 오브젝트의 항으로 설명하는 것이 아니라, 여기서 정리해 설명해 둡니다. 직접 CharacterData 에 대응하는 DOM 오브젝트는 존재하지 않습니다. 한편,Text 등의 그 외의 오브젝트는 CharacterData 로부터 인터페이스를 계승합니다. 이 인터페이스에 포함되는 모든 offsets 는 0 으로 시작됩니다.

DOMString 인터페이스의 해설에서도 접했습니다만, DOM 에 포함되는 텍스트 캐릭터 라인은 UTF-16, 즉 16 비트를 1 단위로 하는 순차 순서로 표현됩니다. 이하에서는 「16 비트 단위」라고 하는 표현으로, CharacterData 에의 인덱스부가 16 비트 단위로 행해진다고 하는 것을 나타냅니다.

「Document Object Model (DOM) Level 2 Core Specification」를 참조해 주세요.

필드의 개요

인터페이스 org.w3c.dom. Node 에서 상속받은 필드

ATTRIBUTE_NODE , CDATA_SECTION_NODE , COMMENT_NODE , DOCUMENT_FRAGMENT_NODE , DOCUMENT_NODE , DOCUMENT_TYPE_NODE , ELEMENT_NODE , ENTITY_NODE , ENTITY_REFERENCE_NODE , NOTATION_NODE , PROCESSING_INSTRUCTION_NODE , TEXT_NODE

메소드의 개요

void	appendData (String arg) 노드의 캐릭터 데이터의 말미에 캐릭터 라인을 추가합니다.
void	deleteData (int offset, int count) 노드로부터 일정 범위의 16 비트 단위를 삭제합니다.
String	getData () 이 인터페이스를 구현하는 노드의 캐릭터 데이터입니다.
int	getLength () 이하의 data 메소드 및 substringData 메소드를 개입시켜 취득 가능한 16 비트 단위의 수입니다.
void	insertData (int offset, String arg) 지정된 16 비트 단위의 오프셋(offset)에 캐릭터 라인을 삽입합니다.
void	replaceData (int offset, int count, String arg) 지정된 캐릭터 라인으로, 지정된 16 비트 단위의 오프셋(offset) 이후의 캐릭터를 옮겨놓습니다.
void	setData (String data) 이 인터페이스를 구현하는 노드의 캐릭터 데이터입니다.
String	substringData (int offset, int count) 노드로부터 소정의 데이터 범위를 추출합니다.

인터페이스 org.w3c.dom. Node 에서 상속받은 메소드

appendChild , cloneNode , getAttributes , getChildNodes , getFirstChild , getLastChild , getLocalName , getNamespaceURI , getNextSibling , getNodeName , getNodeType , getNodeValue , getOwnerDocument , getParentNode , getPrefix , getPreviousSibling , hasAttributes , hasChildNodes , insertBefore , isSupported , normalize , removeChild , replaceChild , setNodeValue , setPrefix

메소드의 상세

getData

public String  getData()
               throws DOMException 

이 인터페이스를 구현하는 노드의 캐릭터 데이터입니다. 통상, DOM 구현은 CharacterData 노드에 저장할 수 있는 데이터의 양을 제한하지 않습니다. 그러나, 어느 노드의 데이터 전체가 단일의 DOMString 에 들어가지 않는 경우는 구현의 제한이 유효하게 됩니다. 이 경우, 유저는 substringData 를 호출해, 데이터를 적절한 사이즈에 분할해 취득할 수가 있습니다.

예외:

DOMException - NO_MODIFICATION_ALLOWED_ERR: 노드가 읽어내 전용의 경우

DOMException - DOMSTRING_SIZE_ERR: 돌려주어지는 캐릭터수가 너무 많아서 구현 플랫폼상의 DOMString 변수에 들어가지 않는 경우

setData

public void setData(String  data)
             throws DOMException 

이 인터페이스를 구현하는 노드의 캐릭터 데이터입니다. 통상, DOM 구현은 CharacterData 노드에 저장할 수 있는 데이터의 양을 제한하지 않습니다. 그러나, 어느 노드의 데이터 전체가 단일의 DOMString 에 들어가지 않는 경우는 구현의 제한이 유효하게 됩니다. 이 경우, 유저는 substringData 를 호출해, 데이터를 적절한 사이즈에 분할해 취득할 수가 있습니다.

예외:

DOMException - NO_MODIFICATION_ALLOWED_ERR: 노드가 읽어내 전용의 경우

DOMException - DOMSTRING_SIZE_ERR: 돌려주어지는 캐릭터수가 너무 많아서 구현 플랫폼상의 DOMString 변수에 들어가지 않는 경우

getLength

public int getLength()

이하의 data 메소드 및 substringData 메소드를 개입시켜 취득 가능한 16 비트 단위의 수입니다. CharacterData 노드가 비었을 경우, 값은 제로가 됩니다.

substringData

public String  substringData(int offset,
                            int count)
                     throws DOMException 

노드로부터 소정의 데이터 범위를 추출합니다.

파라미터:

offset - 추출하는 부분 캐릭터 라인의 개시 오프셋(offset)

count - 추출하는 16 비트 단위의 수

반환값:

지정된 부분 캐릭터 라인. offset 와 count 의 합계가 length 를 넘는 경우, 데이터의 말미까지 포함되는 모든 16 비트 단위가 돌려주어진다

예외:

DOMException - INDEX_SIZE_ERR: 지정된 offset 의 값이 부의 값인지 data 내의 16 비트 단위의 수보다 큰 경우. 또는 지정된 count 가 부의 값인 경우
DOMSTRING_SIZE_ERR: 지정된 텍스트 범위가 DOMString 내에 들어가지 않는 경우

appendData

public void appendData(String  arg)
                throws DOMException 

노드의 캐릭터 데이터의 말미에 캐릭터 라인을 추가합니다. 성공했을 경우,data 에 의해, 지정된 data 와 DOMString 의 연결에의 액세스가 제공됩니다.

파라미터:

arg - 추가되는 DOMString

예외:

DOMException - NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우

insertData

public void insertData(int offset,
                       String  arg)
                throws DOMException 

지정된 16 비트 단위의 오프셋(offset)에 캐릭터 라인을 삽입합니다.

파라미터:

offset - 삽입 위치의 캐릭터 오프셋(offset)

arg - 삽입되는 DOMString

예외:

DOMException - INDEX_SIZE_ERR: 지정된 offset 의 값이 부의 값인지 data 내의 16 비트 단위의 수보다 큰 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우

deleteData

public void deleteData(int offset,
                       int count)
                throws DOMException 

노드로부터 일정 범위의 16 비트 단위를 삭제합니다. 성공했을 경우,data 와 length 로 변경이 반영됩니다.

파라미터:

offset - 삭제를 개시하는 위치의 오프셋(offset)

count - 삭제하는 16 비트 단위의 수. offset 와 count 의 합계가 length 를 넘는 경우,offset 로부터 데이터의 말미까지 존재하는 모든 16 비트 단위가 삭제된다

예외:

DOMException - INDEX_SIZE_ERR: 지정된 offset 의 값이 부의 값인지 data 내의 16 비트 단위의 수보다 큰 경우. 또는 지정된 count 가 부의 값인 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우

replaceData

public void replaceData(int offset,
                        int count,
                        String  arg)
                 throws DOMException 

지정된 캐릭터 라인으로, 지정된 16 비트 단위의 오프셋(offset) 이후의 캐릭터를 옮겨놓습니다.

파라미터:

offset - 치환을 개시하는 위치의 오프셋(offset)

count - 옮겨놓는 16 비트 단위의 수. offset 와 count 의 합계가 length 를 넘는 경우,offset 로부터 데이터의 말미까지 존재하는 모든 16 비트 단위를 옮겨놓을 수 있는 (그 범위에 대해서 remove 메소드와 append 메소드를 연속해 호출했을 경우와 같은 결과)

arg - 소정의 범위와 옮겨놓을 수 있는 DOMString

예외:

DOMException - INDEX_SIZE_ERR: 지정된 offset 의 값이 부의 값인지 data 내의 16 비트 단위의 수보다 큰 경우. 또는 지정된 count 가 부의 값인 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우