NamedNodeMap (Java Platform SE 8)

```
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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

インタフェースNamedNodeMap

メソッドのサマリー

メソッドの詳細

getNamedItem

setNamedItem

removeNamedItem

item

getLength

getNamedItemNS

setNamedItemNS

removeNamedItemNS