org.w3c.dom
인터페이스 NamedNodeMap

public interface NamedNodeMap

NamedNodeMap 인터페이스를 구현하는 오브젝트는 이름을 지정해 액세스 할 수 있는 노드의 집합을 나타냅니다. NamedNodeMap 는 NodeList 를 계승하지 않습니다. 즉, 특정의 순서로 관리되는 일이 없습니다. NamedNodeMap 를 구현하는 오브젝트에 포함되는 오브젝트에도 순서 인덱스를 사용해 액세스 할 수가 있습니다만, 이것은 단지 NamedNodeMap 의 컨텐츠를 열거하기 쉽게하기 위해(때문에)에서 만나며, DOM 가 이러한 Node 의 순서를 지정한다고 하는 것이 아닙니다.

DOM 내의 NamedNodeMap 오브젝트는 라이브 오브젝트입니다.

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

메소드의 개요

int	getLength () 이 MAP내의 노드수입니다.
Node	getNamedItem (String name) 지정된 이름의 노드를 취득합니다.
Node	getNamedItemNS (String namespaceURI, String localName) 지정된 로컬명과 네임 스페이스 URI 를 가지는 노드를 취득합니다.
Node	item (int index) MAP내의 index 번째의 항목을 돌려줍니다.
Node	removeNamedItem (String name) 지정된 이름의 노드를 삭제합니다.
Node	removeNamedItemNS (String namespaceURI, String localName) 지정된 로컬명과 네임 스페이스 URI 를 가지는 노드를 삭제합니다.
Node	setNamedItem (Node arg) nodeName 속성을 지정해 노드를 추가합니다.
Node	setNamedItemNS (Node arg) namespaceURI 와 localName 를 지정해 노드를 추가합니다.

메소드의 상세

getNamedItem

public Node  getNamedItem(String  name)

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

파라미터:

name - 취득하는 노드의 nodeName

반환값:

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

setNamedItem

public Node  setNamedItem(Node  arg)
                  throws DOMException 

nodeName 속성을 지정해 노드를 추가합니다. 그 이름의 노드가 벌써 MAP내에 존재하는 경우, 새로운 노드로 옮겨놓을 수 있습니다.
nodeName 속성은 노드의 저장명을 취득하므로, 특수한 캐릭터 라인치를 가지는 특정의 형태의 노드를 복수개 저장할 수 없습니다. 이것은 이름의 경합이 일어나 버리기 (위해)때문에입니다. 복수의 노드를 저장할 필요가 있는 경우는 노드에 별명을 붙입니다.

파라미터:

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

반환값:

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

예외:

DOMException - WRONG_DOCUMENT_ERR: arg 가 이 MAP의 작성 모토후미서 이외의 문서로 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR: 이 MAP가 읽어내 전용의 경우；
INUSE_ATTRIBUTE_ERR: arg 가 벌써 다른 Element 오브젝트의 Attr 로서 사용되고 있는 경우. Attr 노드를 다른 요소로 재이용하려면 , 이 노드를 DOM 유저의 손으로 명시적으로 복제할 필요가 있다
HIERARCHY_REQUEST_ERR: 이 NamedNodeMap 에 소속하지 않는 노드를 추가하려고 했을 경우. 예를 들어, 속성의 Element MAP에 Attr 노드 이외를 삽입하려고 했을 경우, 혹은 DocumentType 의 Entity 의 MAP에 비 Entity 노드를 삽입하려고 했을 경우

removeNamedItem

public Node  removeNamedItem(String  name)
                     throws DOMException 

지정된 이름의 노드를 삭제합니다. 이 MAP에 요소에 추가된 속성이 포함되어 있을 때, 삭제된 속성에 디폴트 값가 있다면, 네임 스페이스 URI, 로컬명, 전치수식자 (적절한 경우) 외에 디폴트 값를 가지는 새로운 속성이 즉석에서 작성됩니다.

파라미터:

name - 삭제하는 노드의 nodeName

반환값:

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

예외:

DOMException - NOT_FOUND_ERR: 이 MAP내로 지정된 name 의 노드가 존재하지 않는 경우
NO_MODIFICATION_ALLOWED_ERR: 이 MAP가 읽어내 전용의 경우

item

public Node  item(int index)

MAP내의 index 번째의 항목을 돌려줍니다. index 가 이 MAP내의 노드수와 같은가 그것보다 큰 경우는 null 를 돌려줍니다.

파라미터:

index - 이 MAP의 인덱스

반환값:

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

getLength

public int getLength()

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

getNamedItemNS

public Node  getNamedItemNS(String  namespaceURI,
                           String  localName)

지정된 로컬명과 네임 스페이스 URI 를 가지는 노드를 취득합니다.
"XML" 기능을 서포트하지 않는 문서에서는 요소나 속성을 작성 또는 설정하는 DOM 레벨 1 호출만이 허가됩니다. 따라서, null 이외의 네임 스페이스 URI 를 지정하면(자), 일치하는 노드는 검출되지 않습니다.

파라미터:

namespaceURI - 취득하는 노드의 네임 스페이스 URI

localName - 취득하는 노드의 로컬명

반환값:

지정된 로컬명과 네임 스페이스 URI 를 가지는 임의의 형태의 Node. 아이의 MAP내의 노드가 특정되지 않는 경우는 null

도입된 버젼:

DOM Level 2

setNamedItemNS

public Node  setNamedItemNS(Node  arg)
                    throws DOMException 

namespaceURI 와 localName 를 지정해 노드를 추가합니다. 지정된 네임 스페이스 URI 및 로컬명을 가지는 노드가 벌써 MAP내에 존재하는 경우, 새로운 노드로 옮겨놓을 수 있습니다.

파라미터:

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

반환값:

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

예외:

DOMException - WRONG_DOCUMENT_ERR: arg 가 이 MAP의 작성 모토후미서 이외의 문서로 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR: 이 MAP가 읽어내 전용의 경우
INUSE_ATTRIBUTE_ERR: arg 가 벌써 다른 Element 오브젝트의 Attr 로서 사용되고 있는 경우. Attr 노드를 다른 요소로 재이용하려면 , 이 노드를 DOM 유저의 손으로 명시적으로 복제할 필요가 있다
HIERARCHY_REQUEST_ERR: 이 NamedNodeMap 에 소속하지 않는 노드를 추가하려고 했을 경우. 예를 들어, 속성의 Element MAP에 Attr 노드 이외를 삽입하려고 했을 경우, 혹은 DocumentType 의 Entity 의 MAP에 비 Entity 노드를 삽입하려고 했을 경우
NOT_SUPPORTED_ERR: 현재의 문서가 "XML" 를 서포트하지 않는 경우 (네임 스페이스는 XML 에 의해 정의되고 있다)

도입된 버젼:

DOM Level 2

removeNamedItemNS

public Node  removeNamedItemNS(String  namespaceURI,
                              String  localName)
                       throws DOMException 

지정된 로컬명과 네임 스페이스 URI 를 가지는 노드를 삭제합니다. 이 MAP에 요소에 추가된 속성이 포함되어 있을 때, 삭제된 속성이 Node 인터페이스의 attributes 속성에 의해 돌려주어지는 디폴트 값를 가진다면, 대응하는 네임 스페이스 URI, 로컬명, 전치수식자 (적절한 경우) 외에 디폴트 값를 가지는 새로운 속성이 즉석에서 작성됩니다.
"XML" 기능을 서포트하지 않는 문서에서는 요소나 속성을 작성 또는 설정하는 DOM 레벨 1 호출만이 허가됩니다. 따라서, null 이외의 네임 스페이스 URI 를 지정하면(자), 일치하는 노드는 검출되지 않습니다.

파라미터:

namespaceURI - 삭제하는 노드의 네임 스페이스 URI

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

반환값:

이 MAP로부터 삭제하는 노드 (지정된 로컬명 및 네임 스페이스 URI 를 가지는 노드가 존재하는 경우)

예외:

DOMException - NOT_FOUND_ERR: 지정된 namespaceURI 및localName 를 가지는 노드가 MAP내에 존재하지 않는 경우
NO_MODIFICATION_ALLOWED_ERR: 이 MAP가 읽어내 전용의 경우

도입된 버젼:

DOM Level 2