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()

이 맵내의 노드수입니다. 유효한 자식(child) 노드 인덱스의 범위는 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