Package org.jdesktop.dom

Class SimpleDocument

java.lang.Object

org.jdesktop.dom.SimpleDocument

All Implemented Interfaces:

Document, Node

public class SimpleDocument
extends Object
implements Document

A DOM Document that makes it easier to work with DOM documents. This class simply wraps a delegate DOM Document and delegates all calls to the Document. This allows this class to work with any DOM Document.

Field Summary

Fields inherited from interface org.w3c.dom.Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Constructor Summary

Constructors

Constructor	Description
SimpleDocument()	Create a new, empty, SimpleDocument
SimpleDocument(String xml)	Creates a new instance of SimpleDocument with the given XML.
SimpleDocument(Document dom)	Creates a new instance of SimpleDocument.

Method Summary

Modifier and Type	Method	Description
Node	adoptNode(Node source)
Node	appendChild(Node newChild)
Node	cloneNode(boolean deep)
short	compareDocumentPosition(Node other)
Attr	createAttribute(String name)
Attr	createAttributeNS(String namespaceURI, String qualifiedName)
CDATASection	createCDATASection(String data)
Comment	createComment(String data)
DocumentFragment	createDocumentFragment()
Element	createElement(String tagName)
Element	createElementNS(String namespaceURI, String qualifiedName)
EntityReference	createEntityReference(String name)
ProcessingInstruction	createProcessingInstruction(String target, String data)
Text	createTextNode(String data)
NamedNodeMap	getAttributes()
String	getBaseURI()
int	getChildElementCount(Node node)	Returns the number of child elements for the given node.
SimpleNodeList	getChildElements(Node node)	Returns the child elements of the specified node.
SimpleNodeList	getChildNodes()
DocumentType	getDoctype()
Element	getDocumentElement()
String	getDocumentURI()
DOMConfiguration	getDomConfig()
Node	getElement(String expression)	Returns a Node matching the given expression.
Node	getElement(String expression, Node node)	Returns a Node matching the given expression.
Element	getElementById(String elementId)
SimpleNodeList	getElements(String expression)	Returns a SimpleNodeList containing all the nodes that match the given expression.
SimpleNodeList	getElements(String expression, Node node)	Returns a SimpleNodeList containing all the nodes that match the given expression when executed on the given node (as opposed to the dom as a whole).
SimpleNodeList	getElementsByTagName(String tagname)
SimpleNodeList	getElementsByTagNameNS(String namespaceURI, String localName)
Object	getFeature(String feature, String version)
Node	getFirstChild()
DOMImplementation	getImplementation()
String	getInputEncoding()
Node	getLastChild()
String	getLocalName()
String	getNamespaceURI()
Node	getNextSibling()
String	getNodeName()
short	getNodeType()
String	getNodeValue()
Document	getOwnerDocument()
Node	getParentNode()
String	getPrefix()
Node	getPreviousSibling()
boolean	getStrictErrorChecking()
String	getString(String expression)	Returns the text content of the Node matching the given expression.
String	getString(String expression, Node node)	Returns the text content of the Node matching the given expression.
String	getTextContent()
Object	getUserData(String key)
String	getXmlEncoding()
boolean	getXmlStandalone()
String	getXmlVersion()
boolean	hasAttributes()
boolean	hasChildNodes()
Node	importNode(Node importedNode, boolean deep)
Node	insertBefore(Node newChild, Node refChild)
boolean	isDefaultNamespace(String namespaceURI)
boolean	isEqualNode(Node arg)
boolean	isSameNode(Node other)
boolean	isSupported(String feature, String version)
String	lookupNamespaceURI(String prefix)
String	lookupPrefix(String namespaceURI)
void	normalize()
void	normalizeDocument()
Node	removeChild(Node oldChild)
Node	renameNode(Node n, String namespaceURI, String qualifiedName)
Node	replaceChild(Node newChild, Node oldChild)
void	setDocumentURI(String documentURI)
void	setNodeValue(String nodeValue)
void	setPrefix(String prefix)
void	setStrictErrorChecking(boolean strictErrorChecking)
void	setTextContent(String textContent)
Object	setUserData(String key, Object data, UserDataHandler handler)
void	setXmlStandalone(boolean xmlStandalone)
void	setXmlVersion(String xmlVersion)
String	toString()
String	toXML()	Exports this DOM as a String
String	toXML(Node n)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

SimpleDocument

public SimpleDocument()

Create a new, empty, SimpleDocument

SimpleDocument

public SimpleDocument(Document dom)

Creates a new instance of SimpleDocument.

Parameters:

Document - the DOM document to wrap within this SimpleDocument.

SimpleDocument

public SimpleDocument(String xml)

Creates a new instance of SimpleDocument with the given XML. The given XML must be valid.

Parameters:

xml -

Method Details

toString

public String toString()

Overrides:

toString in class Object

toXML

public String toXML()

Exports this DOM as a String

toXML

public String toXML(Node n)

getChildElements

public SimpleNodeList getChildElements(Node node)

Returns the child elements of the specified node. This returns only the immediate child Nodes of type ELEMENT_NODE.

Parameters:

parent - the parent node

Returns:

a SimpleNodeList containing all of the immediate child elements

getChildElementCount

public int getChildElementCount(Node node)

Returns the number of child elements for the given node. Only immediate child nodes of type ELEMENT_NODE are counted.

Parameters:

parent - the parent node

Returns:

the number of immediate child Elements of the given parent node

getElements

public SimpleNodeList getElements(String expression)

Returns a SimpleNodeList containing all the nodes that match the given expression.

Parameters:

expression - an XPath expression

Returns:

SimpleNodeList containing the results from the expression. This will never be null, but may contain no results.

Throws:

IllegalArgumentException - if the expression does not parse

getElements

public SimpleNodeList getElements(String expression,
 Node node)

Returns a SimpleNodeList containing all the nodes that match the given expression when executed on the given node (as opposed to the dom as a whole).

Parameters:

expression - an XPath expression

node - the contextual node

Returns:

SimpleNodeList containing the results from the expression. This will never be null, but may contain no results.

Throws:

IllegalArgumentException - if the expression does not parse

getElement

public Node getElement(String expression)

Returns a Node matching the given expression. If more than one node matches, the return value is undefined.

Parameters:

expression - an XPath expression

Returns:

Node. May be null.

Throws:

IllegalArgumentException - if the expression does not parse

getElement

public Node getElement(String expression,
 Node node)

Returns a Node matching the given expression. If more than one node matches, the return value is undefined.

Parameters:

expression - an XPath expression

node - the contextual node

Returns:

Node. May be null.

Throws:

IllegalArgumentException - if the expression does not parse

getString

public String getString(String expression)

Returns the text content of the Node matching the given expression. If more than one node matches, the return value is undefined.

Parameters:

expression - an XPath expression

Returns:

text content of the selected Node. May be null.

Throws:

IllegalArgumentException - if the expression does not parse

getString

public String getString(String expression,
 Node node)

Returns the text content of the Node matching the given expression. If more than one node matches, the return value is undefined.

Parameters:

expression - an XPath expression

node - the contextual node

Returns:

text content of the selected Node. May be null.

Throws:

IllegalArgumentException - if the expression does not parse

getDoctype

public DocumentType getDoctype()

Specified by:

getDoctype in interface Document

getImplementation

public DOMImplementation getImplementation()

Specified by:

getImplementation in interface Document

getDocumentElement

public Element getDocumentElement()

Specified by:

getDocumentElement in interface Document

createElement

public Element createElement(String tagName)
                      throws DOMException

Specified by:

createElement in interface Document

Throws:

DOMException

createDocumentFragment

public DocumentFragment createDocumentFragment()

Specified by:

createDocumentFragment in interface Document

createTextNode

public Text createTextNode(String data)

Specified by:

createTextNode in interface Document

createComment

public Comment createComment(String data)

Specified by:

createComment in interface Document

createCDATASection

public CDATASection createCDATASection(String data)
                                throws DOMException

Specified by:

createCDATASection in interface Document

Throws:

DOMException

createProcessingInstruction

public ProcessingInstruction createProcessingInstruction(String target,
 String data)
                                                  throws DOMException

Specified by:

createProcessingInstruction in interface Document

Throws:

DOMException

createAttribute

public Attr createAttribute(String name)
                     throws DOMException

Specified by:

createAttribute in interface Document

Throws:

DOMException

createEntityReference

public EntityReference createEntityReference(String name)
                                      throws DOMException

Specified by:

createEntityReference in interface Document

Throws:

DOMException

getElementsByTagName

public SimpleNodeList getElementsByTagName(String tagname)

Specified by:

getElementsByTagName in interface Document

importNode

public Node importNode(Node importedNode,
 boolean deep)
                throws DOMException

Specified by:

importNode in interface Document

Throws:

DOMException

createElementNS

public Element createElementNS(String namespaceURI,
 String qualifiedName)
                        throws DOMException

Specified by:

createElementNS in interface Document

Throws:

DOMException

createAttributeNS

public Attr createAttributeNS(String namespaceURI,
 String qualifiedName)
                       throws DOMException

Specified by:

createAttributeNS in interface Document

Throws:

DOMException

getElementsByTagNameNS

public SimpleNodeList getElementsByTagNameNS(String namespaceURI,
 String localName)

Specified by:

getElementsByTagNameNS in interface Document

getElementById

public Element getElementById(String elementId)

Specified by:

getElementById in interface Document

getInputEncoding

public String getInputEncoding()

Specified by:

getInputEncoding in interface Document

getXmlEncoding

public String getXmlEncoding()

Specified by:

getXmlEncoding in interface Document

getXmlStandalone

public boolean getXmlStandalone()

Specified by:

getXmlStandalone in interface Document

setXmlStandalone

public void setXmlStandalone(boolean xmlStandalone)
                      throws DOMException

Specified by:

setXmlStandalone in interface Document

Throws:

DOMException

getXmlVersion

public String getXmlVersion()

Specified by:

getXmlVersion in interface Document

setXmlVersion

public void setXmlVersion(String xmlVersion)
                   throws DOMException

Specified by:

setXmlVersion in interface Document

Throws:

DOMException

getStrictErrorChecking

public boolean getStrictErrorChecking()

Specified by:

getStrictErrorChecking in interface Document

setStrictErrorChecking

public void setStrictErrorChecking(boolean strictErrorChecking)

Specified by:

setStrictErrorChecking in interface Document

getDocumentURI

public String getDocumentURI()

Specified by:

getDocumentURI in interface Document

setDocumentURI

public void setDocumentURI(String documentURI)

Specified by:

setDocumentURI in interface Document

adoptNode

public Node adoptNode(Node source)
               throws DOMException

Specified by:

adoptNode in interface Document

Throws:

DOMException

getDomConfig

public DOMConfiguration getDomConfig()

Specified by:

getDomConfig in interface Document

normalizeDocument

public void normalizeDocument()

Specified by:

normalizeDocument in interface Document

renameNode

public Node renameNode(Node n,
 String namespaceURI,
 String qualifiedName)
                throws DOMException

Specified by:

renameNode in interface Document

Throws:

DOMException

getNodeName

public String getNodeName()

Specified by:

getNodeName in interface Node

getNodeValue

public String getNodeValue()
                    throws DOMException

Specified by:

getNodeValue in interface Node

Throws:

DOMException

setNodeValue

public void setNodeValue(String nodeValue)
                  throws DOMException

Specified by:

setNodeValue in interface Node

Throws:

DOMException

getNodeType

public short getNodeType()

Specified by:

getNodeType in interface Node

getParentNode

public Node getParentNode()

Specified by:

getParentNode in interface Node

getChildNodes

public SimpleNodeList getChildNodes()

Specified by:

getChildNodes in interface Node

getFirstChild

public Node getFirstChild()

Specified by:

getFirstChild in interface Node

getLastChild

public Node getLastChild()

Specified by:

getLastChild in interface Node

getPreviousSibling

public Node getPreviousSibling()

Specified by:

getPreviousSibling in interface Node

getNextSibling

public Node getNextSibling()

Specified by:

getNextSibling in interface Node

getAttributes

public NamedNodeMap getAttributes()

Specified by:

getAttributes in interface Node

getOwnerDocument

public Document getOwnerDocument()

Specified by:

getOwnerDocument in interface Node

insertBefore

public Node insertBefore(Node newChild,
 Node refChild)
                  throws DOMException

Specified by:

insertBefore in interface Node

Throws:

DOMException

replaceChild

public Node replaceChild(Node newChild,
 Node oldChild)
                  throws DOMException

Specified by:

replaceChild in interface Node

Throws:

DOMException

removeChild

public Node removeChild(Node oldChild)
                 throws DOMException

Specified by:

removeChild in interface Node

Throws:

DOMException

appendChild

public Node appendChild(Node newChild)
                 throws DOMException

Specified by:

appendChild in interface Node

Throws:

DOMException

hasChildNodes

public boolean hasChildNodes()

Specified by:

hasChildNodes in interface Node

cloneNode

public Node cloneNode(boolean deep)

Specified by:

cloneNode in interface Node

normalize

public void normalize()

Specified by:

normalize in interface Node

isSupported

public boolean isSupported(String feature,
 String version)

Specified by:

isSupported in interface Node

getNamespaceURI

public String getNamespaceURI()

Specified by:

getNamespaceURI in interface Node

getPrefix

public String getPrefix()

Specified by:

getPrefix in interface Node

setPrefix

public void setPrefix(String prefix)
               throws DOMException

Specified by:

setPrefix in interface Node

Throws:

DOMException

getLocalName

public String getLocalName()

Specified by:

getLocalName in interface Node

hasAttributes

public boolean hasAttributes()

Specified by:

hasAttributes in interface Node

getBaseURI

public String getBaseURI()

Specified by:

getBaseURI in interface Node

compareDocumentPosition

public short compareDocumentPosition(Node other)
                              throws DOMException

Specified by:

compareDocumentPosition in interface Node

Throws:

DOMException

getTextContent

public String getTextContent()
                      throws DOMException

Specified by:

getTextContent in interface Node

Throws:

DOMException

setTextContent

public void setTextContent(String textContent)
                    throws DOMException

Specified by:

setTextContent in interface Node

Throws:

DOMException

isSameNode

public boolean isSameNode(Node other)

Specified by:

isSameNode in interface Node

lookupPrefix

public String lookupPrefix(String namespaceURI)

Specified by:

lookupPrefix in interface Node

isDefaultNamespace

public boolean isDefaultNamespace(String namespaceURI)

Specified by:

isDefaultNamespace in interface Node

lookupNamespaceURI

public String lookupNamespaceURI(String prefix)

Specified by:

lookupNamespaceURI in interface Node

isEqualNode

public boolean isEqualNode(Node arg)

Specified by:

isEqualNode in interface Node

getFeature

public Object getFeature(String feature,
 String version)

Specified by:

getFeature in interface Node

setUserData

public Object setUserData(String key,
 Object data,
 UserDataHandler handler)

Specified by:

setUserData in interface Node

getUserData

public Object getUserData(String key)

Specified by:

getUserData in interface Node