org.cip4.lib.xjdf.xml.internal

Class XmlNavigator

java.lang.Object

org.cip4.lib.xjdf.xml.internal.XmlNavigator

Direct Known Subclasses:

XJdfNavigator

public class XmlNavigator
extends Object

Navigator class which simplify XPath handling using XML Documents.

Author:

s.meissner

Field Summary

Fields

Modifier and Type	Field and Description
protected NamespaceManager	nsManager
protected Document	xmlDocument
protected XPath	xPath

Constructor Summary

Constructors

Constructor and Description
XmlNavigator(byte[] xmlBytes) Custom constructor.
XmlNavigator(byte[] xmlBytes, boolean namespaceAware) Custom constructor.
XmlNavigator(InputStream xmlStream) Custom constructor.
XmlNavigator(InputStream xmlStream, boolean namespaceAware) Custom constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	addNamespace(String prefix, String uri) Add XML Namespace if navigator works namespace aware.
AbstractXJdfType	evaluate(String xPath, Class xJdfType) Evaluates an XPath expression on XML Document and returns the result as XJDF DataType.
boolean	evaluateBoolean(String xPath) Evaluate an XPath expression on XML Document and returns an Boolean value as result.
double	evaluateDouble(String xPath) Evaluates an XPath expression on XML Document and returns a Double object as result.
Integer	evaluateInt(String xPath) Evaluates an XPath expression on XML Document and returns an Integer value as result.
Node	evaluateNode(String xPath) Evaluates an XPath expression on XML Document and returns a Node object as result.
NodeList	evaluateNodeList(String xPath) Evaluates an XPath expression on XML Document and returns a NodeList object as result.
String	evaluateString(String xPath) Evaluates an XPath expression on XML Document and returns a String object as result.
protected Object	extractNode(String xPath, AbstractXmlParser parser) Extract an XML Node from XML Document and return parsed result.
byte[]	getXmlBytes() Return the XML Document as Byte Array.
Document	getXmlDocument() Getter for xmlDocument attribute.
InputStream	getXmlStream() Return the XML Document as input stream.
String	readAttribute(String xPath) Read attribute from XML Document using XPath.
Object	readAttribute(String xPath, Class xJdfType) Read attribute from XML Document using XPath and convert to JDF Datatype.
void	removeNode(String xPath) Remove a node from XML Document locaed by the XPath expression.
protected void	replaceNode(String xPath, Object replacement, AbstractXmlParser parser) Replace a node in XML Document located by the XPath expression.
void	updateAttribute(String xPath, AbstractXJdfType value) Update attribute in XML Document.
void	updateAttribute(String xPath, String value) Update attribute in XML Document.

Methods inherited from class java.lang.Object

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

Field Detail

xPath

protected final XPath xPath

xmlDocument

protected final Document xmlDocument

nsManager

protected final NamespaceManager nsManager

Constructor Detail

XmlNavigator

public XmlNavigator(byte[] xmlBytes)
             throws Exception

Custom constructor. Accepting a XML Document as Byte Array for initializing.

Parameters:

xmlBytes - XML Document as Byte Array.

Throws:

Exception

XmlNavigator

public XmlNavigator(byte[] xmlBytes,
            boolean namespaceAware)
             throws Exception

Custom constructor. Accepting a XML Document as Byte Array for initializing.

Parameters:

xmlBytes - XML Document as Byte Array.

namespaceAware - True if navigator should be XML Namespace aware.

Throws:

Exception

XmlNavigator

public XmlNavigator(InputStream xmlStream)
             throws Exception

Custom constructor. Accepting a XML Document as Stream for initializing.

Parameters:

xmlStream - XML Document as Input Stream.

Throws:

Exception

XmlNavigator

public XmlNavigator(InputStream xmlStream,
            boolean namespaceAware)
             throws Exception

Custom constructor. Accepting a XML Document as Stream for initializing.

Parameters:

xmlStream - XML Document as Input Stream.

namespaceAware - True if navigator should be XML Namespace aware.

Throws:

Exception

Method Detail

getXmlDocument

public Document getXmlDocument()

Getter for xmlDocument attribute.

Returns:

the xmlDocument

addNamespace

public void addNamespace(String prefix,
                String uri)

Add XML Namespace if navigator works namespace aware.

Parameters:

prefix - Prefix of Namespace.

uri - Namespace URI.

readAttribute

public String readAttribute(String xPath)
                     throws XPathExpressionException

Read attribute from XML Document using XPath.

Parameters:

xPath - XPath expression of attribute to read.

Returns:

Value of attribute as String.

Throws:

XPathExpressionException - Is being thrown in case an exception occurs.

readAttribute

public Object readAttribute(String xPath,
                   Class xJdfType)
                     throws XPathExpressionException,
                            NoSuchMethodException,
                            SecurityException,
                            InstantiationException,
                            IllegalAccessException,
                            IllegalArgumentException,
                            InvocationTargetException

Read attribute from XML Document using XPath and convert to JDF Datatype.

Parameters:

xPath - XPath expression to evaluate.

xJdfType - Target JDF Data Type of attribute.

Returns:

Value as JDF Data Type.

Throws:

XPathExpressionException

SecurityException

NoSuchMethodException

InvocationTargetException

IllegalArgumentException

IllegalAccessException

InstantiationException

evaluateDouble

public double evaluateDouble(String xPath)
                      throws XPathExpressionException

Evaluates an XPath expression on XML Document and returns a Double object as result.

Parameters:

xPath - XPath expression to execute to.

Returns:

Expression result as double.

Throws:

XPathExpressionException - Is thrown in case an XPath Exception occurs.

evaluateInt

public Integer evaluateInt(String xPath)
                    throws XPathExpressionException

Evaluates an XPath expression on XML Document and returns an Integer value as result.

Parameters:

xPath - XPath expression to execute to.

Returns:

Expression result as integer.

Throws:

XPathExpressionException - Is thrown in case an XPath Exception occurs.

evaluateString

public String evaluateString(String xPath)
                      throws XPathExpressionException

Evaluates an XPath expression on XML Document and returns a String object as result.

Parameters:

xPath - XPath expression to execute to.

Returns:

Expression result as string.

Throws:

XPathExpressionException - Is thrown in case an XPath Exception occurs.

evaluateNode

public Node evaluateNode(String xPath)
                  throws XPathExpressionException

Evaluates an XPath expression on XML Document and returns a Node object as result.

Parameters:

xPath - XPath expression to execute to.

Returns:

Expression result as node.

Throws:

XPathExpressionException - Is thrown in case an XPath Exception occurs.

evaluateNodeList

public NodeList evaluateNodeList(String xPath)
                          throws XPathExpressionException

Evaluates an XPath expression on XML Document and returns a NodeList object as result.

Parameters:

xPath - XPath expression to execute to.

Returns:

Expression result as node list.

Throws:

XPathExpressionException - Is thrown in case an XPath Exception occurs.

evaluate

public AbstractXJdfType evaluate(String xPath,
                        Class xJdfType)
                          throws XPathExpressionException,
                                 NoSuchMethodException,
                                 SecurityException,
                                 InstantiationException,
                                 IllegalAccessException,
                                 IllegalArgumentException,
                                 InvocationTargetException

Evaluates an XPath expression on XML Document and returns the result as XJDF DataType.

Parameters:

xPath - XPath expression to execute to.

xJdfType - The desired result data type.

Returns:

Result as desired data type.

Throws:

XPathExpressionException

NoSuchMethodException

SecurityException

InstantiationException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

extractNode

protected Object extractNode(String xPath,
                 AbstractXmlParser parser)
                      throws XPathExpressionException,
                             JAXBException

Extract an XML Node from XML Document and return parsed result.
!! WORKS ONLY IF NAVIGATOR IS NAMESPACE AWARE !!

Parameters:

xPath - XPath expression in order to locate the node.

Returns:

Expression result as parsed XML Node object.

Throws:

XPathExpressionException - Is thrown in case an XPath Exception occurs.

JAXBException

removeNode

public void removeNode(String xPath)
                throws ParserConfigurationException,
                       XPathExpressionException

Remove a node from XML Document locaed by the XPath expression.

Parameters:

xPath - Location of the node to be removed.

Throws:

ParserConfigurationException

XPathExpressionException

replaceNode

protected void replaceNode(String xPath,
               Object replacement,
               AbstractXmlParser parser)
                    throws XPathExpressionException,
                           JAXBException,
                           ParserConfigurationException

Replace a node in XML Document located by the XPath expression.
!! WORKS ONLY IF NAVIGATOR IS NAMESPACE AWARE !!

Parameters:

xPath - Location of the node to be replaced.

replacement - The new node.

parser - XML Parser.

Throws:

XPathExpressionException

JAXBException

ParserConfigurationException

evaluateBoolean

public boolean evaluateBoolean(String xPath)
                        throws XPathExpressionException

Evaluate an XPath expression on XML Document and returns an Boolean value as result.

Parameters:

xPath - XPath expression to execute to.

Returns:

Expression result as boolean value.

Throws:

XPathExpressionException - Is thrown in case an XPath Exception occurs.

updateAttribute

public void updateAttribute(String xPath,
                   AbstractXJdfType value)
                     throws Exception

Update attribute in XML Document.

Parameters:

xPath - XPath expression of attribute to read.

Throws:

Exception - Is being thrown in case an exception occurs.

updateAttribute

public void updateAttribute(String xPath,
                   String value)
                     throws Exception

Update attribute in XML Document.

Parameters:

xPath - XPath expression of attribute to read.

Throws:

Exception - Is being thrown in case an exception occurs.

getXmlStream

public InputStream getXmlStream()
                         throws Exception

Return the XML Document as input stream.

Returns:

XML document as input stream.

Throws:

Exception

getXmlBytes

public byte[] getXmlBytes()
                   throws Exception

Return the XML Document as Byte Array.

Returns:

XML Document as Byte Array.

Throws:

Exception - Is thrown in case an Exception occurs.