Module  java.xml
软件包  org.w3c.dom

Interface NamedNodeMap



  • public interface NamedNodeMap
    实现NamedNodeMap接口的对象用于表示可以通过名称访问的节点集合。 请注意, NamedNodeMap不继承自NodeList ; NamedNodeMaps没有以任何特定的顺序进行维护。 包含在实现NamedNodeMap的对象中的对象也可以由序数索引访问,但这只是为了方便地枚举NamedNodeMap的内容,并不意味着DOM指定这些节点的顺序。

    NamedNodeMap DOM中的对象是活的。

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

    • 方法详细信息

      • 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节点,则name
        NO_MODIFICATION_ALLOWED_ERR:如果此地图是只读的,则提高。
      • item

        Node item​(int index)
        返回地图中的index项目。 如果index大于或等于此映射中的节点数,则返回null
        参数
        index - 索引到此地图。
        结果
        该节点在地图上的 index位置,或 null如果不是有效索引。
      • getLength

        int getLength​()
        该地图中的节点数。 有效子节点索引的范围为0length-1含)。
      • getNamedItemNS

        Node getNamedItemNS​(String namespaceURI,
                            String localName)
                     throws DOMException
        检索由本地名称和命名空间URI指定的节点。
        Per [ XML Namespaces ],应用程序必须使用值null作为方法的namespaceURI参数,如果他们希望没有命名空间。
        参数
        namespaceURI - 要检索的节点的命名空间URI。
        localName - 要检索的节点的本地名称。
        结果
        具有指定的本地名称和命名空间URI的 Node (任何类型的),如果它们不标识此映射中的任何节点, null
        异常
        DOMException - NOT_SUPPORTED_ERR:如果实现不支持功能“XML”,并且通过文档公开的语言不支持XML命名空间(例如[ HTML 4.01 ]),则可能会被引发。
        从以下版本开始:
        1.4,DOM Level 2
      • setNamedItemNS

        Node setNamedItemNS​(Node arg)
                     throws DOMException
        使用其namespaceURIlocalName添加节点。 如果具有该名称空间URI和该本地名称的节点已经存在于该映射中,则该节点将被新映射替换。 自行替换节点不起作用。
        Per [ XML Namespaces ],如果希望没有命名空间,应用程序必须使用值null作为方法的namespaceURI参数。
        参数
        arg - 存储在此地图中的节点。 稍后可以使用其namespaceURIlocalName属性的值访问该节点。
        结果
        如果新 Node替换替换现有节点 Node返回,否则 null返回。
        异常
        DOMException - WRONG_DOCUMENT_ERR:如果由不同于创建此地图的文档创建了arg ,则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 ]),则可能会被引发。
        从以下版本开始:
        1.4,DOM Level 2
      • removeNamedItemNS

        Node removeNamedItemNS​(String namespaceURI,
                               String localName)
                        throws DOMException
        删除由本地名称和命名空间URI指定的节点。 当该映射包含连接到元素的属性(由Node接口的attributes属性返回)时,已知删除的属性可能具有默认值。 如果是这样,属性会立即出现,包含默认值以及相应的命名空间URI,本地名称和前缀(如果适用)。
        Per [ XML Namespaces ],应用程序必须使用值null作为方法的namespaceURI参数,如果他们希望没有命名空间。
        参数
        namespaceURI - 要删除的节点的命名空间URI。
        localName - 要删除的节点的本地名称。
        结果
        如果具有这样的本地名称和命名空间URI的节点存在,则从该映射中删除该节点。
        异常
        DOMException - NOT_FOUND_ERR:如果此地图中没有指定namespaceURIlocalName节点, namespaceURIlocalName
        NO_MODIFICATION_ALLOWED_ERR:如果此地图是只读的,则提高。
        NOT_SUPPORTED_ERR:如果实现不支持功能“XML”,并且通过文档公开的语言不支持XML命名空间(例如[ HTML 4.01 ]),则可能会被引发。
        从以下版本开始:
        1.4,DOM Level 2