NamedNodeMap (Java Platform SE 7)

```
public interface NamedNodeMap
```
NamedNodeMap インタフェースを実装するオブジェクトは、名前を指定してアクセスできるノードのコレクションを表すために使用されます。NamedNodeMap は NodeList を継承しません。NamedNodeMaps は特定のどの順序でも管理されません。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 に属さないノードを追加しようとした場合に発生します。たとえば、Attr 以外のノードを Element の属性マップに挿入しようとしたり、Entity 以外のノードを DocumentType のエンティティーマップに挿入しようとしたりした場合が考えられます。
  - 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 に属さないノードを追加しようとした場合に発生します。たとえば、Attr 以外のノードを Element の属性マップに挿入しようとしたり、Entity 以外のノードを DocumentType のエンティティーマップに挿入しようとしたりした場合が考えられます。
    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

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

インタフェース NamedNodeMap

メソッドのサマリー

メソッドの詳細

getNamedItem

setNamedItem

removeNamedItem

item

getLength

getNamedItemNS

setNamedItemNS

removeNamedItemNS