| java.lang.Object
 org.apache.xerces.dom.NamedNodeMapImpl
All known Subclasses: org.apache.xerces.dom.AttributeMap,
| NamedNodeMapImpl | | public class NamedNodeMapImpl implements NamedNodeMap,Serializable(Code) | | NamedNodeMaps represent collections of Nodes that can be accessed
by name. Entity and Notation nodes are stored in NamedNodeMaps
attached to the DocumentType. Attributes are placed in a NamedNodeMap
attached to the elem they're related too. However, because attributes
require more work, such as firing mutation events, they are stored in
a subclass of NamedNodeMapImpl.
Only one Node may be stored per name; attempting to
store another will replace the previous value.
NOTE: The "primary" storage key is taken from the NodeName attribute of the
node. The "secondary" storage key is the namespaceURI and localName, when
accessed by DOM level 2 nodes. All nodes, even DOM Level 2 nodes are stored
in a single Vector sorted by the primary "nodename" key.
NOTE: item()'s integer index does _not_ imply that the named nodes
must be stored in an array; that's only an access method. Note too
that these indices are "live"; if someone changes the map's
contents, the indices associated with nodes may change.
version:
$Id: NamedNodeMapImpl.java 449328 2006-09-23 22:58:23Z mrglavas $
since:
PR-DOM-Level-1-19980818. |
| Method Summary | |
| protected int | addItem(Node arg)
| | final boolean | changed()
| | final void | changed(boolean value)
| | protected void | cloneContent(NamedNodeMapImpl srcmap)
| | public NamedNodeMapImpl | cloneMap(NodeImpl ownerNode)
Cloning a NamedNodeMap is a DEEP OPERATION; it always clones
all the nodes contained in the map. | | protected Vector | cloneMap(Vector list)
NON-DOM: copy content of this map into the specified vector
Parameters:
list - Vector to copy information into. | | protected int | findNamePoint(String name, int start)
Subroutine: Locate the named item, or the point at which said item
should be added. | | protected int | findNamePoint(String namespaceURI, String name)
This findNamePoint is for DOM Level 2 Namespaces. | | protected Object | getItem(int index)
| | public int | getLength()
Report how many nodes are currently stored in this NamedNodeMap. | | public Node | getNamedItem(String name)
Retrieve a node by name.
Parameters:
name - Name of a node to look up. | | protected int | getNamedItemIndex(String namespaceURI, String localName)
| | public Node | getNamedItemNS(String namespaceURI, String localName)
Introduced in DOM Level 2. | | boolean | getReadOnly()
Internal subroutine returns this NodeNameMap's (shallow) readOnly value. | | final boolean | hasDefaults()
| | final void | hasDefaults(boolean value)
| | final boolean | isReadOnly()
| | final void | isReadOnly(boolean value)
| | public Node | item(int index)
Retrieve an item from the map by 0-based index.
Parameters:
index - Which item to retrieve. | | protected boolean | precedes(Node a, Node b)
| | public void | removeAll()
| | protected void | removeItem(int index)
| | public Node | removeNamedItem(String name)
| | public Node | removeNamedItemNS(String namespaceURI, String name)
Introduced in DOM Level 2. | | public Node | setNamedItem(Node arg)
Adds a node using its nodeName attribute.
As the 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. | | public Node | setNamedItemNS(Node arg)
Adds a node using its namespaceURI and localName.
See Also: org.w3c.dom.NamedNodeMap.setNamedItem If the new Node replaces an existing node the replaced Node is returned,otherwise null is returned. | | protected void | setOwnerDocument(CoreDocumentImpl doc)
| | void | setReadOnly(boolean readOnly, boolean deep)
Internal subroutine to allow read-only Nodes to make their contained
NamedNodeMaps readonly too. |
| CHANGED | | final protected static short CHANGED(Code) | | |
| HASDEFAULTS | | final protected static short HASDEFAULTS(Code) | | |
| READONLY | | final protected static short READONLY(Code) | | |
| flags | | protected short flags(Code) | | |
| serialVersionUID | | final static long serialVersionUID(Code) | | Serialization version.
|
| NamedNodeMapImpl | | protected NamedNodeMapImpl(NodeImpl ownerNode)(Code) | | Constructs a named node map.
|
| changed | | final boolean changed()(Code) | | |
| changed | | final void changed(boolean value)(Code) | | |
| cloneMap | | public NamedNodeMapImpl cloneMap(NodeImpl ownerNode)(Code) | | Cloning a NamedNodeMap is a DEEP OPERATION; it always clones
all the nodes contained in the map.
|
| cloneMap | | protected Vector cloneMap(Vector list)(Code) | | NON-DOM: copy content of this map into the specified vector
Parameters:
list - Vector to copy information into. A copy of this node named map |
| findNamePoint | | protected int findNamePoint(String name, int start)(Code) | | Subroutine: Locate the named item, or the point at which said item
should be added.
Parameters:
name - Name of a node to look up. If positive or zero, the index of the found item.If negative, index of the appropriate point at which to insertthe item, encoded as -1-index and hence reconvertable by subtractingit from -1. (Encoding because I don't want to recompare the stringsbut don't want to burn bytes on a datatype to hold a flagged value.) |
| findNamePoint | | protected int findNamePoint(String namespaceURI, String name)(Code) | | This findNamePoint is for DOM Level 2 Namespaces.
|
| getLength | | public int getLength()(Code) | | Report how many nodes are currently stored in this NamedNodeMap.
Caveat: This is a count rather than an index, so the
highest-numbered node at any time can be accessed via
item(getLength()-1).
|
| getNamedItem | | public Node getNamedItem(String name)(Code) | | Retrieve a node by name.
Parameters:
name - Name of a node to look up. the Node (of unspecified sub-class) stored with that name, ornull if no value has been assigned to that name. |
| getNamedItemIndex | | protected int getNamedItemIndex(String namespaceURI, String localName)(Code) | | |
| getNamedItemNS | | public Node getNamedItemNS(String namespaceURI, String localName)(Code) | | Introduced in DOM Level 2.
Retrieves a node specified by local name and namespace URI.
Parameters:
namespaceURI - The namespace URI of the node to retrieve.When it is null or an empty string, thismethod behaves like getNamedItem.
Parameters:
localName - The local name of the node to retrieve. Node A Node (of any type) with the specified name, or null if the specifiedname did not identify any node in the map. |
| getReadOnly | | boolean getReadOnly()(Code) | | Internal subroutine returns this NodeNameMap's (shallow) readOnly value.
|
| hasDefaults | | final boolean hasDefaults()(Code) | | |
| hasDefaults | | final void hasDefaults(boolean value)(Code) | | |
| isReadOnly | | final boolean isReadOnly()(Code) | | |
| isReadOnly | | final void isReadOnly(boolean value)(Code) | | |
| item | | public Node item(int index)(Code) | | Retrieve an item from the map by 0-based index.
Parameters:
index - Which item to retrieve. Note that indices are just anenumeration of the current contents; they aren't guaranteed to bestable, nor do they imply any promises about the order of theNamedNodeMap's contents. In other words, DO NOT assume either thatindex(i) will always refer to the same entry, or that there is anystable ordering of entries... and be prepared for double-reportingor skips as insertion and deletion occur. the node which currenly has the specified index, or null if indexis greater than or equal to getLength(). |
| removeAll | | public void removeAll()(Code) | | NON-DOM remove all elements from this map
|
| removeItem | | protected void removeItem(int index)(Code) | | NON-DOM: Remove attribute at specified index
|
| removeNamedItemNS | | public Node removeNamedItemNS(String namespaceURI, String name) throws DOMException(Code) | | Introduced in DOM Level 2.
Removes a node specified by local name and namespace URI.
Parameters:
namespaceURI - The namespace URI of the node to remove.When it is null or an empty string, thismethod behaves like removeNamedItem.
Parameters:
name - The local name of the node to remove. Node The node removed from the map if a node with sucha local name and namespace URI exists.
throws:
NOT_FOUND_ERR - : Raised if there is no node namedname in the map. |
| setNamedItem | | public Node setNamedItem(Node arg) throws DOMException(Code) | | Adds a node using its nodeName attribute.
As the 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.
See Also: org.w3c.dom.NamedNodeMap.setNamedItem If the new Node replaces an existing node the replaced Node is returned,otherwise null is returned.
Parameters:
arg - A node to store in a named node map. The node will later beaccessible using the value of the namespaceURI and localNameattribute of the node. If a node with those namespace URI andlocal name is already present in the map, it is replaced by the newone.
exception:
org.w3c.dom.DOMException - The exception description. |
| setNamedItemNS | | public Node setNamedItemNS(Node arg) throws DOMException(Code) | | Adds a node using its namespaceURI and localName.
See Also: org.w3c.dom.NamedNodeMap.setNamedItem If the new Node replaces an existing node the replaced Node is returned,otherwise null is returned.
Parameters:
arg - A node to store in a named node map. The node will later beaccessible using the value of the namespaceURI and localNameattribute of the node. If a node with those namespace URI andlocal name is already present in the map, it is replaced by the newone. |
| setOwnerDocument | | protected void setOwnerDocument(CoreDocumentImpl doc)(Code) | | NON-DOM
set the ownerDocument of this node, and the attributes it contains
|
| setReadOnly | | void setReadOnly(boolean readOnly, boolean deep)(Code) | | Internal subroutine to allow read-only Nodes to make their contained
NamedNodeMaps readonly too. I expect that in fact the shallow
version of this operation will never be
Parameters:
readOnly - boolean true to make read-only, false to permit editing.
Parameters:
deep - boolean true to pass this request along to the containednodes, false to only toggle the NamedNodeMap itself. I expect thatthe shallow version of this operation will never be used, but I wantto design it in now, while I'm thinking about it. |
|
|