org.w3c.dom
인터페이스 NamedNodeMap

public interface NamedNodeMap

NamedNodeMap인터페이스를 구현하는 객체는 이름을 지정해 액세스 할 수 있는 노드의 컬렉션을 나타냅니다. NamedNodeMap는 NodeList를 상속하지 않습니다. 즉, 특정의 순서로 관리되는 일이 없습니다. NamedNodeMap를 구현하는 객체에 포함되는 객체에도 순서 인덱스를 사용해 액세스 할 수 있습니다만, 이것은 단지 NamedNodeMap 컨텐츠를 열거하기 쉽게하기 위해에서 만나며, DOM가 이러한 Node 순서를 지정한다고 하는 것이 아닙니다.

DOM 내의 NamedNodeMap객체는 라이브 객체입니다.

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

메서드 개요

int	getLength () 이 맵내의 노드수입니다.
Node	getNamedItem (String name) 지정된 이름의 노드를 취득합니다.
Node	getNamedItemNS (String namespaceURI, String localName) 로컬명과 이름 공간 URI를 지정해 노드를 취득합니다.
Node	item (int index) 맵내의 index 번째의 항목을 리턴합니다.
Node	removeNamedItem (String name) 지정된 이름의 노드를 삭제합니다.
Node	removeNamedItemNS (String namespaceURI, String localName) 지정된 로컬명과 이름 공간 URI 로 지정된 노드를 삭제합니다.
Node	setNamedItem (Node arg) nodeName 속성을 사용해 노드를 추가합니다.
Node	setNamedItemNS (Node arg) namespaceURI와 localName를 사용해 노드를 추가합니다.

메서드의 상세

getNamedItem

Node  getNamedItem(String  name)

지정된 이름의 노드를 취득합니다.

파라미터:

name - 얻는 노드의 nodeName

반환값:

지정된 nodeName를 가지는 임의의 형태의 Node. 이 맵내의 노드가 특정되지 않는 경우는 null

setNamedItem

Node  setNamedItem(Node  arg)
                  throws DOMException 

nodeName 속성을 사용해 노드를 추가합니다. 노드는 그 이름이 이미 이 맵내에 존재하는 경우, 새로운 노드로 옮겨집니다. 노드 자체에 옮겨놓아도 효과는 없습니다.
nodeName 속성은 노드의 포함명을 취득하므로 「특수한」캐릭터 라인치를 가지는 특정의 형태의 노드를 복수개 포함할 수 없습니다. 이것은 이름의 경합이 일어나 버리기 때문에입니다. 복수의 노드를 포함할 필요가 있는 경우는 노드에 별명을 붙입니다.

파라미터:

arg - 이 맵에 포함하는 노드. 이 노드에는 나중에 nodeName 속성의 값을 사용해 액세스 할 수 있다

반환값:

기존의 노드가 새로운 Node로 옮겨놓을 수 있는 경우는 치환의 대상이 되는 Node. 그 외의 경우는 null

예외:

DOMException - WRONG_DOCUMENT_ERR: 맵을 작성한 문서와는 다른 문서로부터 arg가 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR: 이 맵이 읽기 전용 인 경우
INUSE_ATTRIBUTE_ERR: arg가 이미 다른 Element 객체의 속성인 Attr인 경우. Attr 노드를 다른 요소로 재이용하려면, 이 노드를 DOM 사용자 의 손으로 명시적으로 복제할 필요가 있다
HIERARCHY_REQUEST_ERR: 이 NamedNodeMap에 소속하지 않는 노드를 추가하려고 했을 경우. 예를 들어 속성의 Element 맵에 Attr 노드 이외를 삽입하려고 했을 경우, 혹은 DocumentType Entity 맵에 비 Entity 노드를 삽입하려고 했을 경우

removeNamedItem

Node  removeNamedItem(String  name)
                     throws DOMException 

지정된 이름의 노드를 삭제합니다. 이 맵에 요소에 추가된 속성이 포함되어 있을 때, 삭제된 속성에 기본값이 있다면, 이름 공간 URI, 로컬명, 접두사 (적절한 경우) 외에 기본값을 가지는 새로운 속성이 즉석에서 작성됩니다.

파라미터:

name - 삭제하는 노드의 nodeName

반환값:

이 맵으로부터 삭제하는 노드 (지정된 이름의 노드가 존재하는 경우)

예외:

DOMException - NOT_FOUND_ERR: 이 맵에 name 라는 이름의 노드가 없는 경우
NO_MODIFICATION_ALLOWED_ERR: 이 맵이 읽기 전용 의 경우

item

Node  item(int index)

맵내의 index 번째의 항목을 리턴합니다. index가 이 맵내의 노드수와 같은가 그것보다 큰 경우는 null을 리턴합니다.

파라미터:

index - 이 맵의 인덱스

반환값:

맵내의 index 번째의 노드. 인덱스가 유효하지 않은 경우는 null

getLength

int getLength()

이 맵내의 노드수입니다. 유효한자식 노드 인덱스의 범위는 0 이상 length-1 이하입니다.

getNamedItemNS

Node  getNamedItemNS(String  namespaceURI,
                    String  localName)
                    throws DOMException 

로컬명과 이름 공간 URI를 지정해 노드를 취득합니다.
이름 공간을 보유하고 싶지 않은 경우는 XML 이름 공간에 따라, 어플리케이션으로 메서드의 namespaceURI 파라미터에 null 치를 사용할 필요가 있습니다.

파라미터:

namespaceURI - 얻는 노드의 이름 공간 URI

localName - 얻는 노드의 로컬명

반환값:

지정된 로컬명과 이름 공간 URI를 가지는 임의의 형태의 Node.자식 의 맵내의 노드가 특정되지 않는 경우는 null

예외:

DOMException - NOT_SUPPORTED_ERR: 구현이 「XML」기능을 지원 하고 있지 않고, 문서를 통해서 공개된 언어가 XML 이름 공간 (「HTML 4.01」등)을 지원 하고 있지 않는 경우

도입된 버전 :

DOM Level 2

setNamedItemNS

Node  setNamedItemNS(Node  arg)
                    throws DOMException 

namespaceURI와 localName를 사용해 노드를 추가합니다. 이 맵에 이름 공간 URI와 로컬명을 가지는 노드가 이미 존재하는 경우, 새로운 노드로 옮겨집니다. 노드를 노드 자체로 치환해도 영향은 전혀 없습니다.
이름 공간을 보유하고 싶지 않은 경우는 XML 이름 공간에 따라, 어플리케이션으로 메서드의 namespaceURI 파라미터에 null 치를 사용할 필요가 있습니다.

파라미터:

arg - 이 맵에 포함하는 노드. 이 노드에는 나중에 namespaceURI 속성과 localName 속성의 값을 사용해 액세스 할 수 있다

반환값:

기존의 노드가 새로운 Node로 옮겨놓을 수 있는 경우는 치환의 대상이 되는 Node. 그 외의 경우는 null

예외:

DOMException - WRONG_DOCUMENT_ERR: arg가 이 맵을 작성한 문서와는 다른 문서로부터 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR: 이 맵이 읽기 전용 의 경우
INUSE_ATTRIBUTE_ERR: arg가 다른 Element 객체의 속성인 Attr인 경우. Attr 노드를 다른 요소로 재이용하려면, 이 노드를 DOM 사용자 의 손으로 명시적으로 복제할 필요가 있다.
HIERARCHY_REQUEST_ERR: 이 NamedNodeMap에 소속하지 않는 노드를 추가하려고 했을 경우. 예를 들어 속성의 Element 맵에 Attr 노드 이외를 삽입하려고 했을 경우, 혹은 DocumentType Entity 맵에 비 Entity 노드를 삽입하려고 했을 경우
NOT_SUPPORTED_ERR: 구현이 「XML」기능을 지원 하고 있지 않고, 문서를 통해서 공개된 언어가 XML 이름 공간 (「HTML 4.01」등)을 지원 하고 있지 않는 경우

도입된 버전 :

DOM Level 2

removeNamedItemNS

Node  removeNamedItemNS(String  namespaceURI,
                       String  localName)
                       throws DOMException 

지정된 로컬명과 이름 공간 URI 로 지정된 노드를 삭제합니다. 이 맵에 요소에 추가된 속성이 포함되어 있을 때, 삭제된 속성이 Node인터페이스의 attributes 속성에 의해 리턴된 기본값을 가진다면, 대응하는 이름 공간 URI, 로컬명, 접두사 (적절한 경우) 외에 기본값을 가지는 새로운 속성이 즉석에서 작성됩니다.
이름 공간을 보유하고 싶지 않은 경우는 XML 이름 공간에 따라, 어플리케이션으로 메서드의 namespaceURI에 null 치를 사용할 필요가 있습니다.

파라미터:

namespaceURI - 삭제하는 노드의 이름 공간 URI

localName - 삭제하는 노드의 로컬명

반환값:

이 맵으로부터 삭제하는 노드 (지정된 로컬명 및 이름 공간 URI를 가지는 노드가 존재하는 경우)

예외:

DOMException - NOT_FOUND_ERR: 지정된 namespaceURI와 localName를 가지는 노드가 이 맵에 없는 경우
NO_MODIFICATION_ALLOWED_ERR: 이 맵이 읽기 전용 의 경우
NOT_SUPPORTED_ERR: 구현이 「XML」기능을 지원 하고 있지 않고, 문서를 통해서 공개된 언어가 XML 이름 공간 (「HTML 4.01」등)을 지원 하고 있지 않는 경우

도입된 버전 :

DOM Level 2