public class DTMNamedNodeMap extends Object implements NamedNodeMap
***** Note: this does _not_ current attempt to cache any of the data; if you ask for attribute 27 and then 28, you'll have to rescan the first 27. It should probably at least keep track of the last one retrieved, and possibly buffer the whole array.
***** Also note that there's no fastpath for the by-name query; we search linearly until we find it or fail to find it. Again, that could be optimized at some cost in object creation/storage.
Modifier and Type | Class and Description |
---|---|
class |
DTMNamedNodeMap.DTMException
Simple implementation of DOMException.
|
Constructor and Description |
---|
DTMNamedNodeMap(DTM dtm,
int element)
Create a getAttributes NamedNodeMap for a given DTM element node
|
Modifier and Type | Method and Description |
---|---|
int |
getLength()
Return the number of Attributes on this Element
|
Node |
getNamedItem(String name)
Retrieves a node specified by name.
|
Node |
getNamedItemNS(String namespaceURI,
String localName)
Retrieves a node specified by local name and namespace URI.
|
Node |
item(int i)
Returns the
index th item in the map. |
Node |
removeNamedItem(String name)
Removes a node specified by name.
|
Node |
removeNamedItemNS(String namespaceURI,
String localName)
Removes a node specified by local name and namespace URI.
|
Node |
setNamedItem(Node newNode)
Adds a node using its
nodeName attribute. |
Node |
setNamedItemNS(Node arg)
Adds a node using its
namespaceURI and
localName . |
public DTMNamedNodeMap(DTM dtm, int element)
dtm
- The DTM Reference, must be non-null.element
- The DTM element handle.public int getLength()
getLength
in interface NamedNodeMap
public Node getNamedItem(String name)
getNamedItem
in interface NamedNodeMap
name
- The nodeName
of a node to retrieve.Node
(of any type) with the specified
nodeName
, or null
if it does not identify
any node in this map.public Node item(int i)
index
th item in the map. If index
is greater than or equal to the number of nodes in this map, this
returns null
.item
in interface NamedNodeMap
i
- The index of the requested item.index
th position in the map, or
null
if that is not a valid index.public Node setNamedItem(Node newNode)
nodeName
attribute. If a node with
that name is already present in this map, it is replaced by the new
one.
nodeName
attribute is used to derive the name
which the node must be stored under, multiple nodes of certain types
(those that have a "special" string value) cannot be stored as the
names would clash. This is seen as preferable to allowing nodes to be
aliased.setNamedItem
in interface NamedNodeMap
newNode
- node to store in this map. The node will later be
accessible using the value of its nodeName
attribute.Node
replaces an existing node the
replaced Node
is returned, otherwise null
is returned.DOMException
- WRONG_DOCUMENT_ERR: Raised if arg
was created from a
different document than the one that created this map.
arg
is an
Attr
that is already an attribute of another
Element
object. The DOM user must explicitly clone
Attr
nodes to re-use them in other elements.public Node removeNamedItem(String name)
removeNamedItem
in interface NamedNodeMap
name
- The nodeName
of the node to remove.DOMException
- NOT_FOUND_ERR: Raised if there is no node named name
in
this map.
public Node getNamedItemNS(String namespaceURI, String localName)
getNamedItemNS
in interface NamedNodeMap
namespaceURI
- The namespace URI of the node to retrieve.localName
- The local name of the node to retrieve.Node
(of any type) with the specified local
name and namespace URI, or null
if they do not
identify any node in this map.public Node setNamedItemNS(Node arg) throws DOMException
namespaceURI
and
localName
. If a node with that namespace URI and that
local name is already present in this map, it is replaced by the new
one.
setNamedItemNS
in interface NamedNodeMap
arg
- A node to store in this map. The node will later be
accessible using the value of its namespaceURI
and
localName
attributes.Node
replaces an existing node the
replaced Node
is returned, otherwise null
is returned.DOMException
- WRONG_DOCUMENT_ERR: Raised if arg
was created from a
different document than the one that created this map.
arg
is an
Attr
that is already an attribute of another
Element
object. The DOM user must explicitly clone
Attr
nodes to re-use them in other elements.public Node removeNamedItemNS(String namespaceURI, String localName) throws DOMException
Node
interface. If so, an attribute
immediately appears containing the default value as well as the
corresponding namespace URI, local name, and prefix when applicable.
removeNamedItemNS
in interface NamedNodeMap
namespaceURI
- The namespace URI of the node to remove.localName
- The local name of the node to remove.DOMException
- NOT_FOUND_ERR: Raised if there is no node with the specified
namespaceURI
and localName
in this map.
Copyright © 2012 JBoss by Red Hat. All Rights Reserved.