Node (Java 2 플랫폼 SE v1. 4.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2
Platform
Std. Ed. v1. 4.0

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | constructor | 메소드

상세: 필드 | constructor | 메소드

org.w3c.dom
인터페이스 Node

기존의 서브 인터페이스의 일람:: Attr , CDATASection , CharacterData , Comment , Document , DocumentFragment , DocumentType , Element , Entity , EntityReference , Notation , ProcessingInstruction , Text

기존의 구현 클래스의 일람:: IIOMetadataNode

public interface Node

Node 인터페이스는 문서 오브젝트 모델 전체에 대한 주데이터형이며, 문서 트리내의 단일의 노드를 나타냅니다. Node 인터페이스를 구현하는 모든 오브젝트는 아이를 처리하기 위한 메소드를 가지고 있습니다만,Node 인터페이스를 구현하는 모든 오브젝트가 아이를 가질 수가 있는 것은 아닙니다. 아이를 가질 수가 있는 오브젝트의 1 개에,Text 노드가 있습니다. Text 노드는 DOMException 를 생성하는 것 같은 노드에 자신의 아이를 추가합니다.

nodeName 속성,nodeValue 속성,attributes 속성은 특정의 파생 인터페이스에 사로 잡히지 않고 노드 정보를 취득하는 메카니즘입니다. Element 에 대해서 nodeValue,Comment 에 대해서 attributes 와 같이, 이러한 속성이 특정의 nodeType 에 명확하게 매핑되어 있지 않은 경우는 null 를 돌려줍니다. 각종 전용 인터페이스는 이외에도, 관련 정보를 취득 및 설정하는 편리한 메카니즘을 다수 갖추고 있습니다.

nodeName,nodeValue,attributes 의 값은 이하와 같이 노드형에 따라서 다릅니다.

인터페이스 nodeName nodeValue 속성

Attr 속성명 속성치 null

CDATASection "#cdata-section" CDATA 섹션의 컨텐츠 null

Comment "#comment" 코멘트의 컨텐츠 null

Document "#document" null null

DocumentFragment "#document-fragment" null null

DocumentType 문서형명 null null

Element 태그명 null NamedNodeMap

Entity 엔티티명 null null

EntityReference 참조되는 엔티티의 이름 null null

Notation 표기 법명 null null

ProcessingInstruction 타겟 타겟을 제외한 모든 컨텐츠 null

Text "#text" 텍스트 노드의 컨텐츠 null

인터페이스	nodeName	nodeValue	속성
Attr	속성명	속성치	null
CDATASection	`"#cdata-section"`	CDATA 섹션의 컨텐츠	null
Comment	`"#comment"`	코멘트의 컨텐츠	null
Document	`"#document"`	null	null
DocumentFragment	`"#document-fragment"`	null	null
DocumentType	문서형명	null	null
Element	태그명	null	NamedNodeMap
Entity	엔티티명	null	null
EntityReference	참조되는 엔티티의 이름	null	null
Notation	표기 법명	null	null
ProcessingInstruction	타겟	타겟을 제외한 모든 컨텐츠	null
Text	`"#text"`	텍스트 노드의 컨텐츠	null

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

필드의 개요

static short ATTRIBUTE_NODE
          노드는 Attr 입니다.

static short CDATA_SECTION_NODE
          노드는 CDATASection 입니다.

static short COMMENT_NODE
          노드는 Comment 입니다.

static short DOCUMENT_FRAGMENT_NODE
          노드는 DocumentFragment 입니다.

static short DOCUMENT_NODE
          노드는 Document 입니다.

static short DOCUMENT_TYPE_NODE
          노드는 DocumentType 입니다.

static short ELEMENT_NODE
          노드는 Element 입니다.

static short ENTITY_NODE
          노드는 Entity 입니다.

static short ENTITY_REFERENCE_NODE
          노드는 EntityReference 입니다.

static short NOTATION_NODE
          노드는 Notation 입니다.

static short PROCESSING_INSTRUCTION_NODE
          노드는 ProcessingInstruction 입니다.

static short TEXT_NODE
          노드는 Text 노드입니다.

메소드의 개요

Node appendChild (Node newChild)
          노드 newChild 를 이 노드의 아이 리스트의 말미에 추가합니다.

Node cloneNode (boolean deep)
          노드의 범용 copy constructor로서 이 노드의 복제를 돌려줍니다.

NamedNodeMap getAttributes ()
          이 노드가 Element 의 경우, 이 노드의 속성을 포함한 NamedNodeMap 입니다.

NodeList getChildNodes ()
          이 노드의 아이를 모두 포함한 NodeList 입니다.

Node getFirstChild ()
          이 노드의 최초의 아이 노드입니다.

Node getLastChild ()
          이 노드의 마지막 아이 노드입니다.

String getLocalName ()
          이 노드의 수식명의 로컬 부분을 돌려줍니다.

String getNamespaceURI ()
          이 노드의 네임 스페이스 URI 입니다.

Node getNextSibling ()
          이 노드의 직하의 노드입니다.

String getNodeName ()
          이 노드의 이름입니다.

short getNodeType ()
          오브젝트의 형태를 나타내는 코드입니다.

String getNodeValue ()
          이 노드의 값입니다.

Document getOwnerDocument ()
          이 노드에 관련지을 수 있었던 Document 오브젝트입니다.

Node getParentNode ()
          이 노드의 친노드입니다.

String getPrefix ()
          이 노드의 네임 스페이스앞치수식자입니다.

Node getPreviousSibling ()
          이 노드의 바로 위의 노드입니다.

boolean hasAttributes ()
          이 노드가 요소인 경우, 속성을 가지고 있을지 어떨지를 판단합니다.

boolean hasChildNodes ()
          이 노드가 아이 노드를 가지고 있을지 어떨지를 판단합니다.

Node insertBefore (Node newChild, Node refChild)
          기존의 아이 노드 refChild 의 전에 newChild 노드를 삽입합니다.

boolean isSupported (String feature, String version)
          DOM 구현이 특정의 기능을 구현하고 있어, 이 노드가 그 기능을 서포트하고 있을지 어떨지를 판단합니다.

void normalize ()
          이 Node 의 서브 트리의 최심부까지 존재하는 모든 Text 노드 (속성 노드를 포함한다)를,Text 노드가 구조 (요소, 코멘트, 처리 인스트럭션, CDATA 섹션, 엔티티 참조등)에만 따라 분리되는 「통상」형식으로 고칩니다.

Node removeChild (Node oldChild)
          아이 리스트로부터 oldChild 로 나타나는 아이 노드를 삭제해, 이 아이 노드를 돌려줍니다.

Node replaceChild (Node newChild, Node oldChild)
          아이 리스트안의 아이 노드 oldChild 를 newChild 로 옮겨놓아oldChild 노드를 돌려줍니다.

void setNodeValue (String nodeValue)
          이 노드의 값입니다.

void setPrefix (String prefix)
          이 노드의 네임 스페이스앞치수식자입니다.

필드의 상세

ELEMENT_NODE

public static final short ELEMENT_NODE

노드는 Element 입니다.

관련 항목:: 정수 필드치

ATTRIBUTE_NODE

public static final short ATTRIBUTE_NODE

노드는 Attr 입니다.

관련 항목:: 정수 필드치

TEXT_NODE

public static final short TEXT_NODE

노드는 Text 노드입니다.

관련 항목:: 정수 필드치

CDATA_SECTION_NODE

public static final short CDATA_SECTION_NODE

노드는 CDATASection 입니다.

관련 항목:: 정수 필드치

ENTITY_REFERENCE_NODE

public static final short ENTITY_REFERENCE_NODE

노드는 EntityReference 입니다.

관련 항목:: 정수 필드치

ENTITY_NODE

public static final short ENTITY_NODE

노드는 Entity 입니다.

관련 항목:: 정수 필드치

PROCESSING_INSTRUCTION_NODE

public static final short PROCESSING_INSTRUCTION_NODE

노드는 ProcessingInstruction 입니다.

관련 항목:: 정수 필드치

COMMENT_NODE

public static final short COMMENT_NODE

노드는 Comment 입니다.

관련 항목:: 정수 필드치

DOCUMENT_NODE

public static final short DOCUMENT_NODE

노드는 Document 입니다.

관련 항목:: 정수 필드치

DOCUMENT_TYPE_NODE

public static final short DOCUMENT_TYPE_NODE

노드는 DocumentType 입니다.

관련 항목:: 정수 필드치

DOCUMENT_FRAGMENT_NODE

public static final short DOCUMENT_FRAGMENT_NODE

노드는 DocumentFragment 입니다.

관련 항목:: 정수 필드치

NOTATION_NODE

public static final short NOTATION_NODE

노드는 Notation 입니다.

관련 항목:: 정수 필드치

메소드의 상세

getNodeName

public String  getNodeName()

이 노드의 이름입니다. 이 이름은 형태에 따라서 다릅니다. 상기의 겉(표)를 참조해 주세요.

getNodeValue

public String  getNodeValue()
                    throws DOMException

이 노드의 값입니다. 이 값은 형태에 따라서 다릅니다. 상기의 겉(표)를 참조해 주세요. null 가 되도록(듯이) 정의했을 경우는 이 노드를 설정해도 변화는 없습니다.

예외:: DOMException - NO_MODIFICATION_ALLOWED_ERR: 노드가 읽어내 전용의 경우; DOMException - DOMSTRING_SIZE_ERR: 돌려주어지는 캐릭터수가 너무 많아서 구현 플랫폼상의 DOMString 변수에 들어가지 않는 경우

setNodeValue

public void setNodeValue(String  nodeValue)
                  throws DOMException

예외:: DOMException - NO_MODIFICATION_ALLOWED_ERR: 노드가 읽어내 전용의 경우; DOMException - DOMSTRING_SIZE_ERR: 돌려주어지는 캐릭터수가 너무 많아서 구현 플랫폼상의 DOMString 변수에 들어가지 않는 경우

getNodeType

public short getNodeType()

오브젝트의 형태를 나타내는 코드입니다. 상기의 정의를 참조해 주세요.

getParentNode

public Node  getParentNode()

이 노드의 친노드입니다. Attr,Document,DocumentFragment,Entity,Notation 를 제외하는 모든 노드는 친노드를 가질 가능성이 있습니다. 다만, 노드가 작성되었던 바로 직후로 아직 트리에 추가되어 있지 않은 경우나 트리로부터 삭제되었을 경우는 null 가 돌려주어집니다.

getChildNodes

public NodeList  getChildNodes()

이 노드의 아이를 모두 포함한 NodeList 입니다. 아이가 존재하지 않는 경우, 노드를 가지지 않는 NodeList 가 돌려주어집니다.

getFirstChild

public Node  getFirstChild()

이 노드의 최초의 아이 노드입니다. 해당하는 노드가 존재하지 않는 경우는 null 가 돌려주어집니다.

getLastChild

public Node  getLastChild()

이 노드의 마지막 아이 노드입니다. 해당하는 노드가 존재하지 않는 경우는 null 가 돌려주어집니다.

getPreviousSibling

public Node  getPreviousSibling()

이 노드의 바로 위의 노드입니다. 해당하는 노드가 존재하지 않는 경우는 null 가 돌려주어집니다.

getNextSibling

public Node  getNextSibling()

이 노드의 직하의 노드입니다. 해당하는 노드가 존재하지 않는 경우는 null 가 돌려주어집니다.

getAttributes

public NamedNodeMap  getAttributes()

이 노드가 Element 의 경우, 이 노드의 속성을 포함한 NamedNodeMap 입니다. 그 이외의 경우는 null 입니다.

getOwnerDocument

public Document  getOwnerDocument()

이 노드에 관련지을 수 있었던 Document 오브젝트입니다. 이것은 새로운 노드를 작성하는 Document 오브젝트이기도 합니다. 이 노드가 아직 어느 Document 에서도 사용되어 있지 않은 Document 또는 DocumentType 인 경우,null 가 됩니다.

insertBefore

public Node  insertBefore(Node  newChild,
                         Node  refChild)
                  throws DOMException

기존의 아이 노드 refChild 의 전에 newChild 노드를 삽입합니다. refChild 가 null 의 경우,newChild 는 아이 리스트의 말미에 삽입됩니다.
newChild 가 DocumentFragment 오브젝트인 경우,refChild 의 전에 newChild 의 아이 전부가 같은 순서로 삽입됩니다. newChild 가 트리내에 벌써 존재하는 경우, 최초로 기존의 것이 삭제됩니다.

파라미터:: newChild - 삽입되는 노드; refChild - 참조 노드. 새로운 노드는 이 노드의 직전에 삽입된다
반환값:: 삽입되는 노드
예외:: DOMException - HIERARCHY_REQUEST_ERR: 이 노드가 newChild 노드형의 아이를 받아들이지 않는 형태의 노드인 경우. 또는 삽입되는 노드가 이 노드의 조상 또는 이 노드 자체인 경우
WRONG_DOCUMENT_ERR: newChild 가 이 노드의 작성 모토후미서 이외의 문서로 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용인 경우. 또는 삽입되는 노드의 친노드가 읽어내 전용인 경우
NOT_FOUND_ERR: refChild 가 이 노드의 아이 노드가 아닌 경우

replaceChild

public Node  replaceChild(Node  newChild,
                         Node  oldChild)
                  throws DOMException

아이 리스트안의 아이 노드 oldChild 를 newChild 로 옮겨놓아oldChild 노드를 돌려줍니다.
newChild 가 DocumentFragment 오브젝트인 경우,oldChild 는 삭제되어 그 대신에 DocumentFragment 의 아이 전부가 같은 순서로 삽입됩니다. newChild 가 트리내에 벌써 존재하는 경우, 최초로 기존의 것이 삭제됩니다.

파라미터:: newChild - 자 리스트에 삽입하는 새로운 노드; oldChild - 치환의 대상이 되는 리스트내의 노드
반환값:: 치환의 대상이 된 노드
예외:: DOMException - HIERARCHY_REQUEST_ERR: 이 노드가 newChild 노드형의 아이를 받아들이지 않는 형태의 노드인 경우. 또는 삽입되는 노드가 이 노드의 조상 또는 이 노드 자체인 경우
WRONG_DOCUMENT_ERR: newChild 가 이 노드의 작성 모토후미서 이외의 문서로 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드 또는 새로운 노드의 친노드가 읽어내 전용인 경우
NOT_FOUND_ERR: oldChild 가 이 노드의 아이 노드가 아닌 경우

removeChild

public Node  removeChild(Node  oldChild)
                 throws DOMException

아이 리스트로부터 oldChild 로 나타나는 아이 노드를 삭제해, 이 아이 노드를 돌려줍니다.

파라미터:: oldChild - 삭제되는 노드
반환값:: 삭제되는 노드
예외:: DOMException - NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우
NOT_FOUND_ERR: oldChild 가 이 노드의 아이 노드가 아닌 경우

appendChild

public Node  appendChild(Node  newChild)
                 throws DOMException

노드 newChild 를 이 노드의 아이 리스트의 말미에 추가합니다. newChild 가 트리내에 벌써 존재하는 경우, 최초로 기존의 것이 삭제됩니다.

파라미터:: newChild - 추가하는 노드. 추가하는 노드가 DocumentFragment 인 경우, 문서 fragment의 전컨텐츠가 이 노드의 아이 리스트로 이동한다
반환값:: 추가된 노드
예외:: DOMException - HIERARCHY_REQUEST_ERR: 이 노드가 newChild 노드형의 아이를 받아들이지 않는 형태의 노드인 경우. 또는 추가되는 노드가 이 노드의 조상 또는 이 노드 자체인 경우
WRONG_DOCUMENT_ERR: newChild 가 이 노드의 작성 모토후미서 이외의 문서로 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용인 경우. 또는 삽입되는 노드의 이전의 친노드가 읽어내 전용인 경우

hasChildNodes

public boolean hasChildNodes()

이 노드가 아이 노드를 가지고 있을지 어떨지를 판단합니다.

반환값:: 이 노드가 아이를 가지고 있는 경우는 true, 가지고 있지 않은 경우는 false

cloneNode

public Node  cloneNode(boolean deep)

노드의 범용 copy constructor로서 이 노드의 복제를 돌려줍니다. 복제 노드는 친노드를 가지지 않습니다 (parentNode 가 null).
Element 를 복제하면(자), 그 속성 및 속성치 전부 (XML 프로세서에 의해 생성된 것을 포함한다)가 카피되어 생략시 속성이 됩니다. 다만,Element 에 포함되는 텍스트는 깊은 복제를 실시하지 않는 한 카피되지 않습니다. 이것은 텍스트가 Text 노드에 포함되어 있기 때문입니다. Element 의 복제의 일환으로서가 아니고,Attribute 를 직접 복제하면(자), 지정된 속성이 돌려주어집니다 (specified 는 true). 그 외의 노드형을 복제하면(자), 이 노드의 카피가 돌려주어집니다.
불변의 서브 트리를 복제하면(자) 가변의 카피가 작성됩니다만,EntityReference 의 복제의 아이는 읽어내 전용이 됩니다. 또, 미지정의 Attr 노드의 복제가 지정됩니다. Document,DocumentType,Entity,Notation 의 각 노드의 복제는 구현 의존입니다.

파라미터:: deep - true 의 경우, 지정된 노드의 서브 트리를 재귀적으로 복제. false 의 경우, 지정된 노드만을 복제. 지정된 노드가 Element 인 경우는 그 속성도 복제
반환값:: 복제 노드

normalize

public void normalize()

이 Node 의 서브 트리의 최심부까지 존재하는 모든 Text 노드 (속성 노드를 포함한다)를,Text 노드가 구조 (요소, 코멘트, 처리 인스트럭션, CDATA 섹션, 엔티티 참조등)에만 따라 분리되는 「통상」형식으로 고칩니다. 그 결과, 인접하는Text 노드도 하늘의 Text 노드도 존재하지 않는 상태가 됩니다. 이 조작은 문서의 DOM 뷰를 보존 후 다시 로드한 상태로 할 수 있다고 하는 점으로써, 특정의 문서 트리 구조에 의존하는 조작 (XPointer look 업등)을 실시할 필요가 있는 경우에 편리합니다. 문서에 CDATASections 가 포함되는 경우, 이 normalize 조작만이 올바르게 행해지지 않을 가능성이 있습니다. 이것은 XPointer 가 Text 노드와 CDATASection 노드를 구별하지 않기 때문입니다.

isSupported

public boolean isSupported(String  feature,
                           String  version)

DOM 구현이 특정의 기능을 구현하고 있어, 이 노드가 그 기능을 서포트하고 있을지 어떨지를 판단합니다.

파라미터:: feature - 테스트하는 기능의 이름. DOMImplementation 상의 hasFeature 메소드에게 건네지는 이름과 같게 되는; version - 테스트하는 기능의 버젼 번호. 레벨 2, 버젼 1 에서는 캐릭터 라인 "2.0". 버젼을 지정하지 않으면 임의의 버젼의 기능이 서포트되어 메소드의 반환값은 true 가 된다
반환값:: 지정된 기능이 이 노드로 서포트되고 있는 경우는 true, 그 이외의 경우는 false
도입된 버젼:: DOM Level 2

getNamespaceURI

public String  getNamespaceURI()

이 노드의 네임 스페이스 URI 입니다. 미지정의 경우는 null 가 됩니다.
이 값은 스코프내의 네임 스페이스 선언의 검사에 근거한 네임 스페이스 검색의 결과로서 계산된 값은 아니고, 작성시로 지정된 네임 스페이스 URI 입니다.
ELEMENT_NODE 와ATTRIBUTE_NODE 이외의 형태의 노드와Document 인터페이스의 createElement 와 같이 DOM 레벨 1 메소드로 작성된 노드에 대해서는 항상 null 가 돌려주어집니다. XML 사양의 네임 스페이스의 규정에 의하면, 속성은 그 접속처 요소로부터 네임 스페이스를 계승하지 않습니다. 속성에 대해서 명시적으로 네임 스페이스를 지정하지 않는 한, 그 속성은 네임 스페이스를 가지지 않게 됩니다.

도입된 버젼:: DOM Level 2

getPrefix

public String  getPrefix()

이 노드의 네임 스페이스앞치수식자입니다. 미지정의 경우는 null 가 됩니다.
이 속성을 설정하면(자), 허용 되는 경우는 nodeName 속성이 변경됩니다. 이 속성은 Element 인터페이스와 Attr 인터페이스의 tagName 및 name 속성과 함께, 수식명을 가지고 있습니다 (그것이 적절한 경우).
디폴트 값를 가지는 속성의 전치수식자를 변경해도,namespaceURI 와 localName 가 그대로이므로, 디폴트 값와 원의 전치수식자를 가지는 새로운 속성은 작성되지 않습니다.
ELEMENT_NODE 와ATTRIBUTE_NODE 이외의 형태의 노드와Document 인터페이스의 createElement 와 같이 DOM 레벨 1 메소드로 작성된 노드에 대해서는 항상 null 가 돌려주어집니다.

예외:: DOMException - INVALID_CHARACTER_ERR: 지정된 전치수식자에 XML 1.0 사양에 정해져 있는 부정한 캐릭터가 포함되어 있는 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우
NAMESPACE_ERR: 지정된prefix 가 XML 사양의 네임 스페이스의 정의에 따른 것 나오지 않는 경우. 이 노드의 namespaceURI 가 null 의 경우. 지정된 전치수식자가 "xml" 이며, 이 노드의 namespaceURI 가 "http://www.w3.org/XML/1998/namespace" 이외인 경우. 이 노드가 속성이며, 지정된 전치수식자가 "xmlns" 이며, 이 노드의 namespaceURI 가 "http://www.w3.org/2000/xmlns/" 이외인 경우. 이 노드가 속성이며, 이 노드의 qualifiedName 가 "xmlns" 인 경우
도입된 버젼:: DOM Level 2

setPrefix

public void setPrefix(String  prefix)
               throws DOMException

예외:: DOMException - INVALID_CHARACTER_ERR: 지정된 전치수식자에 XML 1.0 사양에 정해져 있는 부정한 캐릭터가 포함되어 있는 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우
NAMESPACE_ERR: 지정된prefix 가 XML 사양의 네임 스페이스의 정의에 따른 것 나오지 않는 경우. 이 노드의 namespaceURI 가 null 의 경우. 지정된 전치수식자가 "xml" 이며, 이 노드의 namespaceURI 가 "http://www.w3.org/XML/1998/namespace" 이외인 경우. 이 노드가 속성이며, 지정된 전치수식자가 "xmlns" 이며, 이 노드의 namespaceURI 가 "http://www.w3.org/2000/xmlns/" 이외인 경우. 이 노드가 속성이며, 이 노드의 qualifiedName 가 "xmlns" 인 경우
도입된 버젼:: DOM Level 2

getLocalName

public String  getLocalName()

이 노드의 수식명의 로컬 부분을 돌려줍니다.
ELEMENT_NODE 와ATTRIBUTE_NODE 이외의 형태의 노드와Document 인터페이스의 createElement 와 같이 DOM 레벨 1 메소드로 작성된 노드에 대해서는 항상 null 가 돌려주어집니다.

도입된 버젼:: DOM Level 2

hasAttributes

public boolean hasAttributes()

이 노드가 요소인 경우, 속성을 가지고 있을지 어떨지를 판단합니다.

반환값:: 이 노드가 속성을 가지고 있는 경우는 true, 가지고 있지 않은 경우는 false
도입된 버젼:: DOM Level 2

개요