oracle.xml.parser.v2
Class XMLNSNode

java.lang.Object
  |
  +--oracle.xml.parser.v2.XMLNode
        |
        +--oracle.xml.parser.v2.XMLNSNode

All Implemented Interfaces:

java.lang.Cloneable, EventTarget, java.io.Externalizable, Node, NodeEditVAL, java.io.Serializable

Direct Known Subclasses:

XMLAttr, XMLElement, XMLEntity, XMLEntityReference

public class XMLNSNode

extends XMLNode

Extends XMLNode to add support for Namespace names and children

See Also:

Serialized Form

getChildNodes

public NodeList getChildNodes()

Gets a NodeList that contains all children of this node. If there are no children, this is a NodeList containing no nodes. The content of the returned NodeList is "live" in the sense that, for instance, changes to the children of the node object that it was created from are immediately reflected in the nodes returned by the NodeList accessors; it is not a static snapshot of the content of the node. This is true for every NodeList, including the ones returned by the getElementsByTagName method.

Specified by:

getChildNodes in interface Node

Overrides:

getChildNodes in class XMLNode

Returns:

The children of this node

getFirstChild

public Node getFirstChild()

Gets the first child of this node. If there is no such node, this returns null.

Specified by:

getFirstChild in interface Node

Overrides:

getFirstChild in class XMLNode

Returns:

The first child of this node

getLastChild

public Node getLastChild()

Gets the last child of this node. If there is no such node, this returns null.

Specified by:

getLastChild in interface Node

Overrides:

getLastChild in class XMLNode

Returns:

The last child of this node

appendChild

public Node appendChild(Node newChildArg)
                 throws DOMException

Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.

Specified by:

appendChild in interface Node

Overrides:

appendChild in class XMLNode

Parameters:

newChildArg - The node to add. If it is a DocumentFragment object, the entire contents of the document fragment are moved into the child list of this node

Returns:

The node added.

Throws:

DOMException - HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of the newChild node, or if the node to append is one of this node's ancestors.
WRONG_DOCUMENT_ERR: Raised if newChild was created from a different document than the one that created this node.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

removeChild

public Node removeChild(Node oldChildArg)
                 throws DOMException

Removes the child node indicated by oldChildArg from the list of children, and returns it.

Specified by:

removeChild in interface Node

Overrides:

removeChild in class XMLNode

Parameters:

oldChildArg - The node being removed.

Returns:

The node removed.

Throws:

DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
NOT_FOUND_ERR: Raised if oldChildArg is not a child of this node.

insertBefore

public Node insertBefore(Node newChildArg,
Node refChildArg)
                  throws DOMException

Inserts the node newChild before the existing child node refChild. If refChild is null, insert newChild at the end of the list of children.
If newChild is a DocumentFragment object, all of its children are inserted, in the same order, before refChild. If the newChild is already in the tree, it is first removed.

Specified by:

insertBefore in interface Node

Overrides:

insertBefore in class XMLNode

Parameters:

newChildArg - The node to insert.

refChildArg - The reference node, i.e., the node before which the new node must be inserted.

Returns:

The node being inserted.

Throws:

DOMException - HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of the newChild node, or if the node to insert is one of this node's ancestors.
WRONG_DOCUMENT_ERR: Raised if newChild was created from a different document than the one that created this node.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
NOT_FOUND_ERR: Raised if refChild is not a child of this node.

replaceChild

public Node replaceChild(Node newChildArg,
Node oldChildArg)
                  throws DOMException

Replaces the child node oldChildArg with newChildArg in the list of children, and returns the oldChildArg node. If the newChildArg is already in the tree, it is first removed.

Specified by:

replaceChild in interface Node

Overrides:

replaceChild in class XMLNode

Parameters:

newChildArg - The new node to put in the child list.

oldChildArg - The node being replaced in the list.

Returns:

The node replaced.

Throws:

DOMException - HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type of the newChildArg node, or it the node to put in is one of this node's ancestors.
WRONG_DOCUMENT_ERR: Raised if newChildArg was created from a different document than the one that created this node.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
NOT_FOUND_ERR: Raised if oldChildArg is not a child of this node.

normalize

public void normalize()

Puts all Text nodes in the full depth of the sub-tree underneath this Node, including attribute nodes, into "normal" form where only structure (e.g., elements, comments, processing instructions, CDATA sections, and entity references) separates Text nodes,i.e., there are neither adjacent Text nodes nor empty Text 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 particulardocument tree structure are to be used.

Specified by:

normalize in interface Node

Overrides:

normalize in class XMLNode

Since:

DOM 2

addText

public XMLNode addText(java.lang.String str)
                throws XMLDOMException

Adds text to this node, or appends str to the last child if the last child is a text node.

Parameters:

str - text to add

Throws:

XMLDOMException - if text can't be added to this node

addText

public void addText(char[] ch,
                    int start,
                    int length)
             throws XMLDOMException

Adds text to this node, or appends str to the last child if the last child is a text node.

Overrides:

addText in class XMLNode

Parameters:

ch - char array to add

start - start index in the char array

length - no of chars to be added

Throws:

XMLDOMException - if text can't be added to this node

getText

public java.lang.String getText()

Returns the non-marked-up text contained by this element. For text elements, this is the raw For elements with child nodes, this method traverses the entire subtree and appends the text for each terminal text element, effectively stripping out the XML markup for the subtree. For example, if the XML document contains the following: <xmp> <AUTHOR> <FIRST>William</FIRST> <LAST>Shakespeare</LAST> </AUTHOR> </xmp>

XMLDocument.getText returns "William Shakespeare".

Overrides:

getText in class XMLNode

Returns:

non-marked-up text contained bu this element