org.jaxen.dom
Class DocumentNavigator

java.lang.Object
  extended byorg.jaxen.DefaultNavigator
      extended byorg.jaxen.dom.DocumentNavigator
All Implemented Interfaces:
Navigator, java.io.Serializable

public class DocumentNavigator
extends DefaultNavigator

Interface for navigating around the W3C DOM Level 2 object model.

This class is not intended for direct usage, but is used by the Jaxen engine during evaluation.

This class implements the org.jaxen.DefaultNavigator interface for the Jaxen XPath library, version 1.0beta3 (it is not guaranteed to work with subsequent releases). This adapter allows the Jaxen library to be used to execute XPath queries against any object tree that implements the DOM level 2 interfaces.

Note: DOM level 2 does not include a node representing an XML Namespace declaration. This navigator will return Namespace decls as instantiations of the custom NamespaceNode class, and users will have to check result sets to locate and isolate these.

Author:
David Megginson, James Strachan
See Also:
XPath, NamespaceNode, Serialized Form

Constructor Summary
DocumentNavigator()
          Default Constructor.
 
Method Summary
 java.util.Iterator getAttributeAxisIterator(java.lang.Object contextNode)
          Get an iterator over all attributes.
 java.lang.String getAttributeName(java.lang.Object object)
          Get the local name of an attribute.
 java.lang.String getAttributeNamespaceUri(java.lang.Object object)
          Get the Namespace URI of an attribute.
 java.lang.String getAttributeQName(java.lang.Object object)
          Get the qualified name of an attribute.
 java.lang.String getAttributeStringValue(java.lang.Object object)
          Get the string value of an attribute node.
 java.util.Iterator getChildAxisIterator(java.lang.Object contextNode)
          Get an iterator over all of this node's children.
 java.lang.String getCommentStringValue(java.lang.Object object)
          Get the string value of a comment node.
 java.lang.Object getDocument(java.lang.String uri)
          Use JAXP to load a namespace aware document from a given URI
 java.lang.Object getDocumentNode(java.lang.Object contextNode)
          Get the top-level document node.
 java.lang.Object getElementById(java.lang.Object object, java.lang.String elementId)
          Returns the element whose ID is given by elementId.
 java.lang.String getElementName(java.lang.Object object)
          Get the local name of an element.
 java.lang.String getElementNamespaceUri(java.lang.Object object)
          Get the Namespace URI of an element.
 java.lang.String getElementQName(java.lang.Object object)
          Get the qualified name of an element.
 java.lang.String getElementStringValue(java.lang.Object object)
          Get the string value of an element node.
 java.util.Iterator getFollowingAxisIterator(java.lang.Object contextNode)
          Get an iterator over all following nodes, depth-first.
 java.util.Iterator getFollowingSiblingAxisIterator(java.lang.Object contextNode)
          Get an iterator over all following siblings.
static DocumentNavigator getInstance()
          Get a singleton DocumentNavigator for efficiency.
 java.util.Iterator getNamespaceAxisIterator(java.lang.Object contextNode)
          Get an iterator over all declared Namespaces.
 java.lang.String getNamespacePrefix(java.lang.Object object)
          Get the prefix value of a Namespace node.
 java.lang.String getNamespaceStringValue(java.lang.Object object)
          Get the string value of a Namespace node.
 java.util.Iterator getParentAxisIterator(java.lang.Object contextNode)
          Get a (single-member) iterator over this node's parent.
 java.util.Iterator getPrecedingAxisIterator(java.lang.Object contextNode)
          Get an iterator over all preceding nodes, depth-first.
 java.util.Iterator getPrecedingSiblingAxisIterator(java.lang.Object contextNode)
          Get an iterator over all preceding siblings.
 java.lang.String getProcessingInstructionData(java.lang.Object obj)
          Retrieve the data of a processing-instruction.
 java.lang.String getProcessingInstructionTarget(java.lang.Object obj)
          Retrieve the target of a processing-instruction.
 java.lang.String getTextStringValue(java.lang.Object object)
          Get the string value of text.
 boolean isAttribute(java.lang.Object object)
          Test if a node is an attribute.
 boolean isComment(java.lang.Object object)
          Test if a node is a comment.
 boolean isDocument(java.lang.Object object)
          Test if a node is a top-level document.
 boolean isElement(java.lang.Object object)
          Test if a node is an element.
 boolean isNamespace(java.lang.Object object)
          Test if a node is a Namespace.
 boolean isProcessingInstruction(java.lang.Object object)
          Test if a node is a processing instruction.
 boolean isText(java.lang.Object object)
          Test if a node is plain text.
 XPath parseXPath(java.lang.String xpath)
          Returns a parsed form of the given xpath string, which will be suitable for queries on DOM documents.
 java.lang.String translateNamespacePrefixToUri(java.lang.String prefix, java.lang.Object element)
          Translate a Namespace prefix to a URI.
 
Methods inherited from class org.jaxen.DefaultNavigator
getAncestorAxisIterator, getAncestorOrSelfAxisIterator, getDescendantAxisIterator, getDescendantOrSelfAxisIterator, getNodeType, getParentNode, getSelfAxisIterator
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DocumentNavigator

public DocumentNavigator()
Default Constructor.

Method Detail

getInstance

public static DocumentNavigator getInstance()
Get a singleton DocumentNavigator for efficiency.

Returns:
A singleton instance of a DocumentNavigator.

getChildAxisIterator

public java.util.Iterator getChildAxisIterator(java.lang.Object contextNode)
Get an iterator over all of this node's children.

Specified by:
getChildAxisIterator in interface Navigator
Overrides:
getChildAxisIterator in class DefaultNavigator
Parameters:
contextNode - The context node for the child axis.
Returns:
A possibly-empty iterator (not null).

getParentAxisIterator

public java.util.Iterator getParentAxisIterator(java.lang.Object contextNode)
Get a (single-member) iterator over this node's parent.

Specified by:
getParentAxisIterator in interface Navigator
Overrides:
getParentAxisIterator in class DefaultNavigator
Parameters:
contextNode - the context node for the parent axis.
Returns:
A possibly-empty iterator (not null).

getFollowingSiblingAxisIterator

public java.util.Iterator getFollowingSiblingAxisIterator(java.lang.Object contextNode)
Get an iterator over all following siblings.

Specified by:
getFollowingSiblingAxisIterator in interface Navigator
Overrides:
getFollowingSiblingAxisIterator in class DefaultNavigator
Parameters:
contextNode - the context node for the sibling iterator.
Returns:
A possibly-empty iterator (not null).

getPrecedingSiblingAxisIterator

public java.util.Iterator getPrecedingSiblingAxisIterator(java.lang.Object contextNode)
Get an iterator over all preceding siblings.

Specified by:
getPrecedingSiblingAxisIterator in interface Navigator
Overrides:
getPrecedingSiblingAxisIterator in class DefaultNavigator
Parameters:
contextNode - The context node for the preceding sibling axis.
Returns:
A possibly-empty iterator (not null).

getFollowingAxisIterator

public java.util.Iterator getFollowingAxisIterator(java.lang.Object contextNode)
Get an iterator over all following nodes, depth-first.

Specified by:
getFollowingAxisIterator in interface Navigator
Overrides:
getFollowingAxisIterator in class DefaultNavigator
Parameters:
contextNode - The context node for the following axis.
Returns:
A possibly-empty iterator (not null).

getPrecedingAxisIterator

public java.util.Iterator getPrecedingAxisIterator(java.lang.Object contextNode)
Get an iterator over all preceding nodes, depth-first.

Specified by:
getPrecedingAxisIterator in interface Navigator
Overrides:
getPrecedingAxisIterator in class DefaultNavigator
Parameters:
contextNode - The context node for the preceding axis.
Returns:
A possibly-empty iterator (not null).

getAttributeAxisIterator

public java.util.Iterator getAttributeAxisIterator(java.lang.Object contextNode)
Get an iterator over all attributes.

Specified by:
getAttributeAxisIterator in interface Navigator
Overrides:
getAttributeAxisIterator in class DefaultNavigator
Parameters:
contextNode - The context node for the attribute axis.
Returns:
A possibly-empty iterator (not null).

getNamespaceAxisIterator

public java.util.Iterator getNamespaceAxisIterator(java.lang.Object contextNode)
Get an iterator over all declared Namespaces.

Note: this iterator is not live: it takes a snapshot and that snapshot remains static during the life of the iterator (i.e. it won't reflect subsequent changes to the DOM).

Specified by:
getNamespaceAxisIterator in interface Navigator
Overrides:
getNamespaceAxisIterator in class DefaultNavigator
Parameters:
contextNode - The context node for the Namespace axis.
Returns:
A possibly-empty iterator (not null).

parseXPath

public XPath parseXPath(java.lang.String xpath)
                 throws org.saxpath.SAXPathException
Returns a parsed form of the given xpath string, which will be suitable for queries on DOM documents.

Parameters:
xpath - The xpath expression.
Returns:
A new XPath expression object.
Throws:
org.saxpath.SAXPathException
See Also:
XPath

getDocumentNode

public java.lang.Object getDocumentNode(java.lang.Object contextNode)
Get the top-level document node.

Specified by:
getDocumentNode in interface Navigator
Overrides:
getDocumentNode in class DefaultNavigator
Parameters:
contextNode - Any node in the document.
Returns:
The root node.

getElementNamespaceUri

public java.lang.String getElementNamespaceUri(java.lang.Object object)
Get the Namespace URI of an element.

Parameters:
object - The target node.
Returns:
A string (possibly empty) if the node is an element, and null otherwise.

getElementName

public java.lang.String getElementName(java.lang.Object object)
Get the local name of an element.

Parameters:
object - The target node.
Returns:
A string representing the unqualified local name if the node is an element, or null otherwise.

getElementQName

public java.lang.String getElementQName(java.lang.Object object)
Get the qualified name of an element.

Parameters:
object - The target node.
Returns:
A string representing the qualified (i.e. possibly prefixed) name if the node is an element, or null otherwise.

getAttributeNamespaceUri

public java.lang.String getAttributeNamespaceUri(java.lang.Object object)
Get the Namespace URI of an attribute.

Parameters:
object - The target node.
Returns:
The namespace URI of the attribute node.

getAttributeName

public java.lang.String getAttributeName(java.lang.Object object)
Get the local name of an attribute.

Parameters:
object - The target node.
Returns:
A string representing the unqualified local name if the node is an attribute, or null otherwise.

getAttributeQName

public java.lang.String getAttributeQName(java.lang.Object object)
Get the qualified name of an attribute.

Parameters:
object - The target node.
Returns:
A string representing the qualified (i.e. possibly prefixed) name if the node is an attribute, or null otherwise.

isDocument

public boolean isDocument(java.lang.Object object)
Test if a node is a top-level document.

Parameters:
object - The target node.
Returns:
true if the node is the document root, false otherwise.

isNamespace

public boolean isNamespace(java.lang.Object object)
Test if a node is a Namespace.

Parameters:
object - The target node.
Returns:
true if the node is a Namespace, false otherwise.

isElement

public boolean isElement(java.lang.Object object)
Test if a node is an element.

Parameters:
object - The target node.
Returns:
true if the node is an element, false otherwise.

isAttribute

public boolean isAttribute(java.lang.Object object)
Test if a node is an attribute.

Parameters:
object - The target node.
Returns:
true if the node is an attribute, false otherwise.

isComment

public boolean isComment(java.lang.Object object)
Test if a node is a comment.

Parameters:
object - The target node.
Returns:
true if the node is a comment, false otherwise.

isText

public boolean isText(java.lang.Object object)
Test if a node is plain text.

Parameters:
object - The target node.
Returns:
true if the node is a text node, false otherwise.

isProcessingInstruction

public boolean isProcessingInstruction(java.lang.Object object)
Test if a node is a processing instruction.

Parameters:
object - The target node.
Returns:
true if the node is a processing instruction, false otherwise.

getElementStringValue

public java.lang.String getElementStringValue(java.lang.Object object)
Get the string value of an element node.

Parameters:
object - The target node.
Returns:
The text inside the node and its descendants if the node is an element, null otherwise.

getAttributeStringValue

public java.lang.String getAttributeStringValue(java.lang.Object object)
Get the string value of an attribute node.

Parameters:
object - The target node.
Returns:
The text of the attribute value if the node is an attribute, null otherwise.

getTextStringValue

public java.lang.String getTextStringValue(java.lang.Object object)
Get the string value of text.

Parameters:
object - The target node.
Returns:
The string of text if the node is text, null otherwise.

getCommentStringValue

public java.lang.String getCommentStringValue(java.lang.Object object)
Get the string value of a comment node.

Parameters:
object - The target node.
Returns:
The text of the comment if the node is a comment, null otherwise.

getNamespaceStringValue

public java.lang.String getNamespaceStringValue(java.lang.Object object)
Get the string value of a Namespace node.

Parameters:
object - The target node.
Returns:
The Namespace URI as a (possibly empty) string if the node is a namespace node, null otherwise.

getNamespacePrefix

public java.lang.String getNamespacePrefix(java.lang.Object object)
Get the prefix value of a Namespace node.

Parameters:
object - The target node.
Returns:
The Namespace prefix a (possibly empty) string if the node is a namespace node, null otherwise.

translateNamespacePrefixToUri

public java.lang.String translateNamespacePrefixToUri(java.lang.String prefix,
                                                      java.lang.Object element)
Translate a Namespace prefix to a URI.

Specified by:
translateNamespacePrefixToUri in interface Navigator
Overrides:
translateNamespacePrefixToUri in class DefaultNavigator

getDocument

public java.lang.Object getDocument(java.lang.String uri)
                             throws FunctionCallException
Use JAXP to load a namespace aware document from a given URI

Specified by:
getDocument in interface Navigator
Overrides:
getDocument in class DefaultNavigator
Parameters:
uri - is the URI of the document to load
Returns:
the new W3C DOM Level 2 Document instance
Throws:
FunctionCallException - containing a nested exception if a problem occurs trying to parse the given document

getProcessingInstructionTarget

public java.lang.String getProcessingInstructionTarget(java.lang.Object obj)
Description copied from interface: Navigator
Retrieve the target of a processing-instruction.

Specified by:
getProcessingInstructionTarget in interface Navigator
Overrides:
getProcessingInstructionTarget in class DefaultNavigator

getProcessingInstructionData

public java.lang.String getProcessingInstructionData(java.lang.Object obj)
Description copied from interface: Navigator
Retrieve the data of a processing-instruction.

Specified by:
getProcessingInstructionData in interface Navigator
Overrides:
getProcessingInstructionData in class DefaultNavigator

getElementById

public java.lang.Object getElementById(java.lang.Object object,
                                       java.lang.String elementId)
Returns the element whose ID is given by elementId. If no such element exists, returns null. Attributes with the name "ID" are not of type ID unless so defined. Atribute types are only known if when the parser understands DTD's or schemas that declare attributes of type ID. When JAXP is used, you must call setValidating(true) on the DocumentBuilderFactory.

Specified by:
getElementById in interface Navigator
Overrides:
getElementById in class DefaultNavigator
Parameters:
elementId - id to look for
Returns:
element whose ID is given by elementId, or null if no such element exists in the document or if the implementation does not know about attribute types
See Also:
DocumentBuilderFactory


Copyright © 2002 bob mcwhirter & James Strachan. All Rights Reserved. Hosted by

SourceForge Logo