Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
java.lang.Object
org.apache.axis.message.NodeImpl
Field Summary | |
protected boolean | |
protected Attributes | |
protected ArrayList | |
protected Document | |
protected static Log | |
protected String | |
protected String | |
protected NodeImpl | |
protected String | |
protected CharacterData |
Constructor Summary | |
| |
|
Method Summary | |
Node |
|
Node |
|
short |
|
protected NamedNodeMap |
|
void |
|
NamedNodeMap |
|
String | |
NodeList |
|
Object |
|
Node |
|
Node |
|
String |
|
String |
|
Node |
|
String |
|
short |
|
String |
|
Document |
|
protected NodeImpl |
|
SOAPElement |
|
Node |
|
String |
|
Node |
|
String | |
Object |
|
String |
|
boolean |
|
boolean |
|
protected void |
|
Node |
|
boolean |
|
boolean |
|
boolean |
|
boolean |
|
boolean |
|
String |
|
String |
|
protected AttributesImpl |
|
void |
|
void |
|
void |
|
Node |
|
Node |
|
void |
|
void |
|
void |
|
void |
|
void |
|
protected void | |
void |
|
void |
|
void |
|
Object |
|
void |
|
protected boolean _isDirty
protected Attributes attributes
protected ArrayList children
protected Document document
protected static Log log
protected String name
protected String namespaceURI
protected String prefix
protected CharacterData textRep
public NodeImpl()
empty constructor
public NodeImpl(CharacterData text)
constructor which adopts the name and NS of the char data, and its text
- Parameters:
text
-
public Node appendChild(Node newChild) throws DOMException
Adds the nodenewChild
to the end of the list of children of this node. If thenewChild
is already in the tree, it is first removed.
- Parameters:
newChild
- The node to add.If it is aDocumentFragment
object, the entire contents of the document fragment are moved into the child list of this node
- Returns:
- The node added.
public Node cloneNode(boolean deep)
Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent; (parentNode
isnull
.).
Cloning anElement
copies all attributes and their values, including those generated by the XML processor to represent defaulted attributes, but this method does not copy any text it contains unless it is a deep clone, since the text is contained in a childText
node. Cloning anAttribute
directly, as opposed to be cloned as part of anElement
cloning operation, returns a specified attribute (specified
istrue
). Cloning any other type of node simply returns a copy of this node.
Note that cloning an immutable subtree results in a mutable copy, but the children of anEntityReference
clone are readonly . In addition, clones of unspecifiedAttr
nodes are specified. And, cloningDocument
,DocumentType
,Entity
, andNotation
nodes is implementation dependent.
- Parameters:
deep
- Iftrue
, recursively clone the subtree under the specified node; iffalse
, clone only the node itself (and its attributes, if it is anElement
).
- Returns:
- The duplicate node.
public short compareDocumentPosition(Node foo)
protected NamedNodeMap convertAttrSAXtoDOM(Attributes saxAttr)
The internal representation of Attributes cannot help being changed It is because Attribute is not immutible Type, so if we keep out value and just return it in another form, the application may chnae it, which we cannot detect without some kind back track method (call back notifying the chnage.) I am not sure which approach is better.
public void detachNode()
Removes thisNode
object from the tree. Once removed, this node can be garbage collected if there are no application references to it.
- Specified by:
- detachNode in interface Node
public NamedNodeMap getAttributes()
ANamedNodeMap
containing the attributes of this node (if it is anElement
) ornull
otherwise.
public String getBaseURI()
public NodeList getChildNodes()
ANodeList
that contains all children of this node. If there are no children, this is aNodeList
containing no nodes.
public Object getFeature(String foo, String foo2)
public Node getFirstChild()
The first child of this node. If there is no such node, this returnsnull
.
public Node getLastChild()
The last child of this node. If there is no such node, this returnsnull
.
public String getLocalName()
Returns the local part of the qualified name of this node.
For nodes of any type other thanELEMENT_NODE
andATTRIBUTE_NODE
and nodes created with a DOM Level 1 method, such ascreateElement
from theDocument
interface, this is alwaysnull
.
- Since:
- DOM Level 2
public String getNamespaceURI()
The namespace URI of this node, ornull
if it is unspecified.
This is not a computed value that is the result of a namespace lookup based on an examination of the namespace declarations in scope. It is merely the namespace URI given at creation time.
For nodes of any type other thanELEMENT_NODE
andATTRIBUTE_NODE
and nodes created with a DOM Level 1 method, such ascreateElement
from theDocument
interface, this is alwaysnull
.Per the Namespaces in XML Specification an attribute does not inherit its namespace from the element it is attached to. If an attribute is not explicitly given a namespace, it simply has no namespace.
- Since:
- DOM Level 2
public Node getNextSibling()
The node immediately following this node. If there is no such node, this returnsnull
.
public String getNodeName()
The name of this node, depending on its type; see the table above.
public short getNodeType()
A code representing the type of the underlying object, as defined above.
public String getNodeValue() throws DOMException
The value of this node, depending on its type; see the table above. When it is defined to benull
, setting it has no effect.
public Document getOwnerDocument()
TheDocument
object associated with this node. This is also theDocument
object used to create new nodes. When this node is aDocument
or aDocumentType
which is not used with anyDocument
yet, this isnull
.
public SOAPElement getParentElement()
Returns the parent element of thisNode
object. This method can throw anUnsupportedOperationException
if the tree is not kept in memory.
- Specified by:
- getParentElement in interface Node
- Returns:
- the
SOAPElement
object that is the parent of thisNode
object ornull
if thisNode
object is root
public Node getParentNode()
The parent of this node. All nodes, exceptAttr
,Document
,DocumentFragment
,Entity
, andNotation
may have a parent. However, if a node has just been created and not yet added to the tree, or if it has been removed from the tree, this isnull
.
public String getPrefix()
The namespace prefix of this node, ornull
if it is unspecified.
Note that setting this attribute, when permitted, changes thenodeName
attribute, which holds the qualified name, as well as thetagName
andname
attributes of theElement
andAttr
interfaces, when applicable.
Note also that changing the prefix of an attribute that is known to have a default value, does not make a new attribute with the default value and the original prefix appear, since thenamespaceURI
andlocalName
do not change.
For nodes of any type other thanELEMENT_NODE
andATTRIBUTE_NODE
and nodes created with a DOM Level 1 method, such ascreateElement
from theDocument
interface, this is alwaysnull
.
- Since:
- DOM Level 2
public Node getPreviousSibling()
The node immediately preceding this node. If there is no such node, this returnsnull
.
public String getTextContent()
public Object getUserData(String foo)
public String getValue()
Returns the the value of the immediate child of thisNode
object if a child exists and its value is text.
- Returns:
- a
String
with the text of the immediate child of thisNode
object if (1) there is a child and (2) the child is aText
object;null
otherwise
public boolean hasAttributes()
Returns whether this node (if it is an element) has any attributes.
- Returns:
true
if this node has any attributes,false
otherwise.
- Since:
- DOM Level 2
public boolean hasChildNodes()
Returns whether this node has any children.
- Returns:
true
if this node has any children,false
otherwise.
protected void initializeChildren()
Initialize the children array
public Node insertBefore(Node newChild, Node refChild) throws DOMException
Inserts the nodenewChild
before the existing child noderefChild
. IfrefChild
isnull
, insertnewChild
at the end of the list of children.
IfnewChild
is aDocumentFragment
object, all of its children are inserted, in the same order, beforerefChild
. If thenewChild
is already in the tree, it is first removed.
- Parameters:
newChild
- The node to insert.refChild
- The reference node, i.e., the node before which the new node must be inserted.
- Returns:
- The node being inserted.
public boolean isDefaultNamespace(String foo)
public boolean isDirty()
get the dirty bit
- Returns:
public boolean isEqualNode(Node foo)
public boolean isSameNode(Node foo)
public boolean isSupported(String feature, String version)
Tests whether the DOM implementation implements a specific feature and that feature is supported by this node.
- Parameters:
feature
- The name of the feature to test. This is the same name which can be passed to the methodhasFeature
onDOMImplementation
.version
- This is the version number of the feature to test. In Level 2, version 1, this is the string "2.0". If the version is not specified, supporting any version of the feature will cause the method to returntrue
.
- Returns:
- Returns
true
if the specified feature is supported on this node,false
otherwise.
- Since:
- DOM Level 2
public String lookupNamespaceURI(String foo)
public String lookupPrefix(String foo)
protected AttributesImpl makeAttributesEditable()
make the attributes editable
- Returns:
- AttributesImpl
public void normalize()
Puts allText
nodes in the full depth of the sub-tree underneath thisNode
, including attribute nodes, into a "normal" form where only structure (e.g., elements, comments, processing instructions, CDATA sections, and entity references) separatesText
nodes, i.e., there are neither adjacentText
nodes nor emptyText
nodes. This can be used to ensure that the DOM view of a document is the same as if it were saved and re-loaded, and is useful when operations (such as XPointer lookups) that depend on a particular document tree structure are to be used.In cases where the document containsCDATASections
, the normalize operation alone may not be sufficient, since XPointers do not differentiate betweenText
nodes andCDATASection
nodes.
public void output(SerializationContext context) throws Exception
print the contents of this node
- Parameters:
context
-
public void recycleNode()
Notifies the implementation that thisNode
object is no longer being used by the application and that the implementation is free to reuse this object for nodes that may be created later. Calling the methodrecycleNode
implies that the methoddetachNode
has been called previously.
- Specified by:
- recycleNode in interface Node
public Node removeChild(Node oldChild) throws DOMException
Removes the child node indicated byoldChild
from the list of children, and returns it.
- Parameters:
oldChild
- The node being removed.
- Returns:
- The node removed.
public Node replaceChild(Node newChild, Node oldChild) throws DOMException
Replaces the child nodeoldChild
withnewChild
in the list of children, and returns theoldChild
node.
IfnewChild
is aDocumentFragment
object,oldChild
is replaced by all of theDocumentFragment
children, which are inserted in the same order. If thenewChild
is already in the tree, it is first removed.
- Parameters:
newChild
- The new node to put in the child list.oldChild
- The node being replaced in the list.
- Returns:
- The node replaced.
public void reset()
public void setDirty()
public void setDirty(boolean dirty)
set the dirty bit. will also set our parent as dirty, if there is one. Note that clearing the dirty bit does not propagate upwards.
- Parameters:
dirty
- new value of the dirty bit
public void setNodeValue(String nodeValue) throws DOMException
The value of this node, depending on its type; see the table above. When it is defined to benull
, setting it has no effect.
public void setOwnerDocument(Document doc)
Set the owner document
- Parameters:
doc
-
protected void setParent(NodeImpl parent) throws SOAPException
Set the parent node and invoke appendChild(this) to add this node to the parent's list of children.
- Parameters:
parent
-
- Throws:
SOAPException
-
public void setParentElement(SOAPElement parent) throws SOAPException
Sets the parent of thisNode
object to the givenSOAPElement
object.
- Specified by:
- setParentElement in interface Node
- Parameters:
parent
- theSOAPElement
object to be set as the parent of thisNode
object
- Throws:
SOAPException
- if there is a problem in setting the parent to the given element
- See Also:
getParentElement()
public void setPrefix(String prefix)
The namespace prefix of this node, ornull
if it is unspecified.
Note that setting this attribute, when permitted, changes thenodeName
attribute, which holds the qualified name, as well as thetagName
andname
attributes of theElement
andAttr
interfaces, when applicable.
Note also that changing the prefix of an attribute that is known to have a default value, does not make a new attribute with the default value and the original prefix appear, since thenamespaceURI
andlocalName
do not change.
For nodes of any type other thanELEMENT_NODE
andATTRIBUTE_NODE
and nodes created with a DOM Level 1 method, such ascreateElement
from theDocument
interface, this is alwaysnull
.
- Since:
- DOM Level 2
public void setTextContent(String foo)
public Object setUserData(String foo, Object foo2, UserDataHandler foo3)
public void setValue(String value)
If this is a Text node then this method will set its value, otherwise it sets the value of the immediate (Text) child of this node. The value of the immediate child of this node can be set only if, there is one child node and that node is a Text node, or if there are no children in which case a child Text node will be created.
- Parameters:
value
- the text to set