Skip navigation links

Oracle® Database XML Java API Reference
11g Release 2 (11.2)

E10769-01


oracle.xdb.dom
Class XDBDocument

java.lang.Object
  extended by oracle.xdb.dom.XDBNode
      extended by oracle.xdb.dom.XDBDocument

All Implemented Interfaces:
Document, Node
Direct Known Subclasses:
XDBBinaryDocument

Deprecated. as of Oracle Database 11g release 1, use oracle.xml.parser.v2.XMLDocument

public class XDBDocument
extends XDBNode
implements Document

Field Summary

 

Fields inherited from class oracle.xdb.dom.XDBNode
m_conn, m_owner, m_xobcstate

 

Fields inherited from interface org.w3c.dom.Node
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

 

Constructor Summary
XDBDocument()
          Deprecated.  
XDBDocument(byte[] source)
          Deprecated.  
XDBDocument(java.sql.Connection conn)
          Deprecated.  
XDBDocument(java.sql.Connection conn, byte[] source)
          Deprecated.  
XDBDocument(java.sql.Connection conn, long xobd)
          Deprecated.  
XDBDocument(java.sql.Connection conn, java.lang.String source)
          Deprecated.  
XDBDocument(java.lang.String source)
          Deprecated.  
XDBDocument(XMLType parxmlt, java.sql.Connection conn, long xobd)
          Deprecated.  

 

Method Summary
 Node adoptNode(Node source)
          Deprecated.  
 Node appendChild(Node arg)
          Deprecated. append the given node to the list of children of this node.
 void close()
          Deprecated.  
 Attr createAttribute(java.lang.String qname)
          Deprecated. create an empty attribute node.
 Attr createAttributeNS(java.lang.String nsURI, java.lang.String qname)
          Deprecated. create an empty attribute node given the namespace information.
 CDATASection createCDATASection(java.lang.String data)
          Deprecated. create a CDATA section node.
 Comment createComment(java.lang.String data)
          Deprecated. create a comment node.
 DocumentFragment createDocumentFragment()
          Deprecated. create an empty document fragment.
 Element createElement(java.lang.String tagName)
          Deprecated. create and Return a new empty element associated with the document.
 Element createElementNS(java.lang.String nsURI, java.lang.String qname)
          Deprecated. create and Return a new empty element associated with the document.
 EntityReference createEntityReference(java.lang.String name)
          Deprecated. create an entity reference node.
 ProcessingInstruction createProcessingInstruction(java.lang.String target, java.lang.String data)
          Deprecated. create a processing instruction node.
 Text createTextNode(java.lang.String data)
          Deprecated. create an empty text node.
 void finalize()
          Deprecated.  
 DocumentType getDoctype()
          Deprecated. Returns the document type defn. of the doc.
 Element getDocumentElement()
          Deprecated. Returns the root element of the document.
 java.lang.String getDocumentURI()
          Deprecated.  
 DOMConfiguration getDomConfig()
          Deprecated.  
 Element getElementById(java.lang.String id)
          Deprecated. get elements of the given ID with a pre-order traversal of the document tree.
 NodeList getElementsByTagName(java.lang.String tagname)
          Deprecated. get elements of the given tagname with a pre-order traversal of the document tree.
 NodeList getElementsByTagNameNS(java.lang.String nsURI, java.lang.String tagname)
          Deprecated. get elements of the given tagname and ns URI with a pre-order traversal of the document tree.
static long getEnvNative(long envhandle)
          Deprecated.  
 Node getFirstChild()
          Deprecated. Returns the first child of the node. must be overriden derived classes which support this
protected static long getGP(java.sql.Connection conn)
          Deprecated.  
 DOMImplementation getImplementation()
          Deprecated. Returns the dom implementation object.
 java.lang.String getInputEncoding()
          Deprecated.  
 Node getLastChild()
          Deprecated. Returns the last child of the node. must be overriden derived classes which support this
 Node getNextSibling()
          Deprecated. Returns the next sibling of the node. must be overriden derived classes which support this
 java.lang.String getNodeName()
          Deprecated. get the name of the node
 Document getOwnerDocument()
          Deprecated. the owner document for this node
 Node getPreviousSibling()
          Deprecated. Returns the previous sibling of the node. must be overriden derived classes which support this
 boolean getStrictErrorChecking()
          Deprecated.  
 java.lang.String getXmlEncoding()
          Deprecated.  
 boolean getXmlStandalone()
          Deprecated.  
 java.lang.String getXmlVersion()
          Deprecated.  
 Node importNode(Node importNode, boolean deep)
          Deprecated. import the given node from the original document based on the rules specified by the DOM specification
 Node insertBefore(Node newChild, Node refChild)
          Deprecated. insert the given node before the ref node.
 boolean isClosed()
          Deprecated.  
 void normalizeDocument()
          Deprecated.  
 Node removeChild(Node arg)
          Deprecated. remove the given node from the node.
 Node renameNode(Node n, java.lang.String namespaceURI, java.lang.String qualifiedName)
          Deprecated.  
 Node replaceChild(Node newChild, Node oldChild)
          Deprecated. replace the oldchild node with the newchild node.
 void setDocumentURI(java.lang.String documentURI)
          Deprecated.  
 void setStrictErrorChecking(boolean strictErrorChecking)
          Deprecated.  
 void setXmlStandalone(boolean xmlStandalone)
          Deprecated.  
 void setXmlVersion(java.lang.String xmlVersion)
          Deprecated.  

 

Methods inherited from class oracle.xdb.dom.XDBNode
cloneNode, compareDocumentPosition, equals, getAttributes, getBaseURI, getChildNodes, getExpandedName, getFeature, getInputStream, getLocalName, getNamespaceURI, getNodeFromCState, getNodeType, getNodeValue, getParentNode, getPrefix, getPrimitiveType, getQualifiedName, getSchemaNode, getTextContent, getUserData, hasAttributes, hasChildNodes, hashCode, isDefaultNamespace, isEqualNode, isNilled, isSameNode, isSchemaBased, isSupported, lookupNamespaceURI, lookupPrefix, normalize, setNodeValue, setNodeXob, setOwner, setPrefix, setTextContent, setUserData, setXobCstate, toCState, toString, validateName, write, writeToOutputStream

 

Methods inherited from class java.lang.Object
clone, getClass, notify, notifyAll, wait, wait, wait

 

Methods inherited from interface org.w3c.dom.Node
cloneNode, getAttributes, getChildNodes, getLocalName, getNamespaceURI, getNodeType, getNodeValue, getParentNode, getPrefix, hasAttributes, hasChildNodes, isSupported, normalize, setNodeValue, setPrefix

 

Constructor Detail

XDBDocument

public XDBDocument()
Deprecated. 

XDBDocument

public XDBDocument(java.sql.Connection conn)
            throws java.lang.Exception
Deprecated. 
Throws:
java.lang.Exception

XDBDocument

public XDBDocument(java.lang.String source)
Deprecated. 

XDBDocument

public XDBDocument(java.sql.Connection conn,
                   java.lang.String source)
            throws java.lang.Exception
Deprecated. 
Throws:
java.lang.Exception

XDBDocument

public XDBDocument(byte[] source)
Deprecated. 

XDBDocument

public XDBDocument(java.sql.Connection conn,
                   byte[] source)
            throws java.lang.Exception
Deprecated. 
Throws:
java.lang.Exception

XDBDocument

public XDBDocument(java.sql.Connection conn,
                   long xobd)
            throws XDBDOMException
Deprecated. 
Throws:
XDBDOMException

XDBDocument

public XDBDocument(XMLType parxmlt,
                   java.sql.Connection conn,
                   long xobd)
            throws XDBDOMException
Deprecated. 
Throws:
XDBDOMException

Method Detail

getEnvNative

public static long getEnvNative(long envhandle)
Deprecated. 

getDoctype

public DocumentType getDoctype()
Deprecated. 
Returns the document type defn. of the doc. We always return null
Specified by:
getDoctype in interface Document
Returns:
the document type defn. of the document.

getImplementation

public DOMImplementation getImplementation()
Deprecated. 
Returns the dom implementation object.
Specified by:
getImplementation in interface Document
Returns:
the XDBDomImplementation object.

getDocumentElement

public Element getDocumentElement()
Deprecated. 
Returns the root element of the document.
Specified by:
getDocumentElement in interface Document
Returns:
the root XDBElement of the XMLType.

createElement

public Element createElement(java.lang.String tagName)
                      throws DOMException
Deprecated. 
create and Return a new empty element associated with the document. i.e. element with no children and not in the XMLType hierarchy.
Specified by:
createElement in interface Document
Returns:
a new XDBElement.
Throws:
DOMException - INVALID_CHARACTER_ERR: Raised if the specified name contains an illegal character.

createDocumentFragment

public DocumentFragment createDocumentFragment()
Deprecated. 
create an empty document fragment.
Specified by:
createDocumentFragment in interface Document
Returns:
a Document Fragment object.

createTextNode

public Text createTextNode(java.lang.String data)
Deprecated. 
create an empty text node.
Specified by:
createTextNode in interface Document
Returns:
a text node object.

createComment

public Comment createComment(java.lang.String data)
Deprecated. 
create a comment node. Not implemented yet.
Specified by:
createComment in interface Document
Returns:
a comment node object.

createCDATASection

public CDATASection createCDATASection(java.lang.String data)
                                throws DOMException
Deprecated. 
create a CDATA section node. Not implemented yet.
Specified by:
createCDATASection in interface Document
Returns:
a cdatasection object.
Throws:
DOMException - NOT_SUPPORTED_ERR: Raised if this document is an HTML document.

createProcessingInstruction

public ProcessingInstruction createProcessingInstruction(java.lang.String target,
                                                         java.lang.String data)
                                                  throws DOMException
Deprecated. 
create a processing instruction node.
Specified by:
createProcessingInstruction in interface Document
Returns:
a PI object.
Throws:
DOMException - INVALID_CHARACTER_ERR: Raised if the specified target contains an illegal character.
NOT_SUPPORTED_ERR: Raised if this document is an HTML document.

createAttribute

public Attr createAttribute(java.lang.String qname)
                     throws DOMException
Deprecated. 
create an empty attribute node.
Specified by:
createAttribute in interface Document
Returns:
an attribute object.
Throws:
DOMException - INVALID_CHARACTER_ERR: Raised if the specified name contains an illegal character.

createEntityReference

public EntityReference createEntityReference(java.lang.String name)
                                      throws DOMException
Deprecated. 
create an entity reference node. We do not implement it
Specified by:
createEntityReference in interface Document
Returns:
an entity reference object.
Throws:
DOMException - INVALID_CHARACTER_ERR: Raised if the specified name contains an illegal character.
NOT_SUPPORTED_ERR: Raised if this document is an HTML document.

getElementsByTagName

public NodeList getElementsByTagName(java.lang.String tagname)
Deprecated. 
get elements of the given tagname with a pre-order traversal of the document tree.
Specified by:
getElementsByTagName in interface Document
Returns:
a Nodelist of the matched items.

importNode

public Node importNode(Node importNode,
                       boolean deep)
                throws DOMException
Deprecated. 
import the given node from the original document based on the rules specified by the DOM specification
Specified by:
importNode in interface Document
Returns:
a new Node.
Throws:
DOMException - NOT_SUPPORTED_ERR: Raised if the type of node being imported is not supported.

createElementNS

public Element createElementNS(java.lang.String nsURI,
                               java.lang.String qname)
                        throws DOMException
Deprecated. 
create and Return a new empty element associated with the document. i.e. element with no children and not in the XMLType hierarchy. This function uses the namespace information as well.
Specified by:
createElementNS in interface Document
Returns:
a new XDBElement.
Throws:
DOMException - INVALID_CHARACTER_ERR: Raised if the specified qualified name contains an illegal character.
NAMESPACE_ERR: Raised if the qualifiedName is malformed, if the qualifiedName has a prefix and the namespaceURI is null, or if the qualifiedName has a prefix that is "xml" and the namespaceURI is different from " http://www.w3.org/XML/1998/namespace" .

createAttributeNS

public Attr createAttributeNS(java.lang.String nsURI,
                              java.lang.String qname)
                       throws DOMException
Deprecated. 
create an empty attribute node given the namespace information.
Specified by:
createAttributeNS in interface Document
Returns:
an attribute object.
Throws:
DOMException - INVALID_CHARACTER_ERR: Raised if the specified qualified name contains an illegal character.
NAMESPACE_ERR: Raised if the qualifiedName is malformed, if the qualifiedName has a prefix and the namespaceURI is null, if the qualifiedName has a prefix that is "xml" and the namespaceURI is different from " http://www.w3.org/XML/1998/namespace", or if the qualifiedName is "xmlns" and the namespaceURI is different from " http://www.w3.org/2000/xmlns/".

getElementsByTagNameNS

public NodeList getElementsByTagNameNS(java.lang.String nsURI,
                                       java.lang.String tagname)
Deprecated. 
get elements of the given tagname and ns URI with a pre-order traversal of the document tree.
Specified by:
getElementsByTagNameNS in interface Document
Returns:
a Nodelist of the matched items.

getElementById

public Element getElementById(java.lang.String id)
Deprecated. 
get elements of the given ID with a pre-order traversal of the document tree.
Specified by:
getElementById in interface Document
Returns:
an Element with the matching ID.

getNodeName

public java.lang.String getNodeName()
Deprecated. 
get the name of the node
Specified by:
getNodeName in interface Node
Overrides:
getNodeName in class XDBNode
Returns:
the node name string, always "#document" for this node.

getOwnerDocument

public Document getOwnerDocument()
Deprecated. 
the owner document for this node
Specified by:
getOwnerDocument in interface Node
Overrides:
getOwnerDocument in class XDBNode
Returns:
always null for this node

insertBefore

public Node insertBefore(Node newChild,
                         Node refChild)
                  throws DOMException
Deprecated. 
insert the given node before the ref node. In this case, if the node already has children this function will throw an exception
Specified by:
insertBefore in interface Node
Overrides:
insertBefore in class XDBNode
Returns:
The newChild which is to be 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 or if the parent of the node being inserted is readonly.
NOT_FOUND_ERR: Raised if refChild is not a child of this node.

replaceChild

public Node replaceChild(Node newChild,
                         Node oldChild)
                  throws DOMException
Deprecated. 
replace the oldchild node with the newchild node.
Specified by:
replaceChild in interface Node
Overrides:
replaceChild in class XDBNode
Returns:
The oldChild node which has been replaced
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 put in 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 or the parent of the new node is readonly.
NOT_FOUND_ERR: Raised if oldChild is not a child of this node.

removeChild

public Node removeChild(Node arg)
                 throws DOMException
Deprecated. 
remove the given node from the node.
Specified by:
removeChild in interface Node
Overrides:
removeChild in class XDBNode
Returns:
The node which is being removed
Throws:
DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
NOT_FOUND_ERR: Raised if oldChild is not a child of this node.

appendChild

public Node appendChild(Node arg)
                 throws DOMException
Deprecated. 
append the given node to the list of children of this node. This will work only if the document has no children
Specified by:
appendChild in interface Node
Overrides:
appendChild in class XDBNode
Returns:
The node which is being appended
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.

getFirstChild

public Node getFirstChild()
Deprecated. 
Description copied from class: XDBNode
Returns the first child of the node. must be overriden derived classes which support this
Specified by:
getFirstChild in interface Node
Overrides:
getFirstChild in class XDBNode
Returns:
the first child node

getLastChild

public Node getLastChild()
Deprecated. 
Description copied from class: XDBNode
Returns the last child of the node. must be overriden derived classes which support this
Specified by:
getLastChild in interface Node
Overrides:
getLastChild in class XDBNode
Returns:
the last child node

getPreviousSibling

public Node getPreviousSibling()
Deprecated. 
Description copied from class: XDBNode
Returns the previous sibling of the node. must be overriden derived classes which support this
Specified by:
getPreviousSibling in interface Node
Overrides:
getPreviousSibling in class XDBNode
Returns:
the previous node

getNextSibling

public Node getNextSibling()
Deprecated. 
Description copied from class: XDBNode
Returns the next sibling of the node. must be overriden derived classes which support this
Specified by:
getNextSibling in interface Node
Overrides:
getNextSibling in class XDBNode
Returns:
the next node

isClosed

public boolean isClosed()
Deprecated. 
Overrides:
isClosed in class XDBNode

close

public void close()
Deprecated. 
Overrides:
close in class XDBNode

finalize

public void finalize()
              throws java.lang.Throwable
Deprecated. 
Overrides:
finalize in class XDBNode
Throws:
java.lang.Throwable

getGP

protected static long getGP(java.sql.Connection conn)
Deprecated. 

renameNode

public Node renameNode(Node n,
                       java.lang.String namespaceURI,
                       java.lang.String qualifiedName)
                throws DOMException
Deprecated. 
Throws:
DOMException

getDomConfig

public DOMConfiguration getDomConfig()
Deprecated. 

normalizeDocument

public void normalizeDocument()
Deprecated. 

getStrictErrorChecking

public boolean getStrictErrorChecking()
Deprecated. 

setStrictErrorChecking

public void setStrictErrorChecking(boolean strictErrorChecking)
Deprecated. 

getDocumentURI

public java.lang.String getDocumentURI()
Deprecated. 

setDocumentURI

public void setDocumentURI(java.lang.String documentURI)
Deprecated. 

adoptNode

public Node adoptNode(Node source)
               throws DOMException
Deprecated. 
Throws:
DOMException

getInputEncoding

public java.lang.String getInputEncoding()
Deprecated. 

getXmlEncoding

public java.lang.String getXmlEncoding()
Deprecated. 

getXmlStandalone

public boolean getXmlStandalone()
Deprecated. 

setXmlStandalone

public void setXmlStandalone(boolean xmlStandalone)
                      throws DOMException
Deprecated. 
Throws:
DOMException

getXmlVersion

public java.lang.String getXmlVersion()
Deprecated. 

setXmlVersion

public void setXmlVersion(java.lang.String xmlVersion)
                   throws DOMException
Deprecated. 
Throws:
DOMException

Skip navigation links

Oracle® Database XML Java API Reference
11g Release 2 (11.2)

E10769-01


Copyright © 2003, 2009, Oracle and/or its affiliates. All rights reserved.