NamedNodeMap (Java Platform SE 8 )

```
public interface NamedNodeMap
```
实现NamedNodeMap接口的对象用于表示可以通过名称访问的节点集合。请注意， NamedNodeMap不继承NodeList ; NamedNodeMaps未按任何特定顺序进行维护。包含在实现一个对象的对象NamedNodeMap还可以通过一个顺序索引访问，但是这仅仅是允许的内容方便枚举NamedNodeMap ，并不意味着DOM指定的顺序对这些节点。
NamedNodeMap DOM中的对象是活的。

另见Document Object Model (DOM) Level 3 Core Specification 。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`int`	`getLength()` 该地图中的节点数。
`Node`	`getNamedItem(String name)` 检索由name指定的节点。
`Node`	`getNamedItemNS(String namespaceURI, String localName)` 检索由本地名称和命名空间URI指定的节点。
`Node`	`item(int index)` 返回地图中的 `index`项目。
`Node`	`removeNamedItem(String name)` 删除由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指定的节点。
    
    参数
    
    name - 要检索的节点的 nodeName 。
    
    结果
    
    A Node （任何类型的），具有指定的 nodeName ，或 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 ，则Element 。 DOM用户必须明确克隆Attr节点，以便在其他元素中重新使用它们。
    HIERARCHY_REQUEST_ERR：如果尝试添加节点不属于此NamedNodeMap，则引发。示例将包括尝试将Attr节点以外的其他东西插入到元素的属性图中，或将非实体节点插入到DocumentType的Entities映射中。
  - removeNamedItem
```
Node removeNamedItem(String name)
              throws DOMException
```
    删除由name指定的节点。当此映射包含附加到元素的属性时，如果已知已删除的属性具有默认值，则属性会立即显示，其中包含默认值以及相应的命名空间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 Namespaces ]，应用程序必须使用值null作为方法的namespaceURI参数，如果他们希望没有命名空间。
    
    参数
    
    namespaceURI - 要检索的节点的命名空间URI。
    
    localName - 要检索的节点的本地名称。
    
    结果
    
    具有指定的本地名称和命名空间URI的 Node （任何类型的），如果它们不标识此映射中的任何节点， null 。
    
    异常
    
    DOMException - NOT_SUPPORTED_ERR：如果实现不支持功能“XML”，并且通过文档公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能会被引发。
    
    从以下版本开始：
    
    DOM级别2
  - setNamedItemNS
```
Node setNamedItemNS(Node arg)
             throws DOMException
```
    使用其namespaceURI和localName添加节点。如果具有该名称空间URI和该本地名称的节点已经存在于该映射中，则该节点将被新映射替换。自行替换节点不起作用。
    Per [ XML Namespaces ]，应用程序必须使用值null作为方法的namespaceURI参数，如果他们希望没有命名空间。
    
    参数
    
    arg - 存储在此地图中的节点。稍后可以使用其namespaceURI和localName属性的值访问该节点。
    
    结果
    
    如果新 Node替换替换现有节点 Node返回，否则 null返回。
    
    异常
    
    DOMException - WRONG_DOCUMENT_ERR：如果arg是从与创建该地图的文档不同的文档创建的。
    NO_MODIFICATION_ALLOWED_ERR：如果此地图是只读的，则提高。
    INUSE_ATTRIBUTE_ERR：如果arg是已经是另一个Element对象的属性的Attr ，则Element 。 DOM用户必须明确克隆Attr节点，以便在其他元素中重新使用它们。
    HIERARCHY_REQUEST_ERR：如果尝试添加节点不属于此NamedNodeMap，则引发。示例将包括尝试将Attr节点以外的其他东西插入到元素的属性图中，或将非实体节点插入到DocumentType的Entities映射中。
    NOT_SUPPORTED_ERR：如果实现不支持功能“XML”，并且通过文档公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能会被引发。
    
    从以下版本开始：
    
    DOM级别2
  - removeNamedItemNS
```
Node removeNamedItemNS(String namespaceURI,
                       String localName)
                throws DOMException
```
    删除由本地名称和命名空间URI指定的节点。当此映射包含附加到元素的属性（如Node接口的Node属性返回）时，已知删除的属性可能具有默认值。如果是这样，属性会立即出现，包含默认值以及相应的命名空间URI，本地名称和前缀（如果适用）。
    按照[ XML Namespaces ]，应用程序必须使用值null作为方法的namespaceURI参数，如果他们希望没有命名空间。
    
    参数
    
    namespaceURI - 要删除的节点的命名空间URI。
    
    localName - 要删除的节点的本地名称。
    
    结果
    
    如果具有这样的本地名称和命名空间URI的节点存在，则从该映射中删除该节点。
    
    异常
    
    DOMException - NOT_FOUND_ERR：如果此地图中没有指定的namespaceURI和localName节点，则将其提升。
    NO_MODIFICATION_ALLOWED_ERR：如果此地图是只读的，则提高。
    NOT_SUPPORTED_ERR：如果实现不支持功能“XML”，并且通过文档公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能会被引发。
    
    从以下版本开始：
    
    DOM级别2

Interface NamedNodeMap

方法摘要

方法详细信息

getNamedItem

setNamedItem

removeNamedItem

item

getLength

getNamedItemNS

setNamedItemNS

removeNamedItemNS