org.cip4.lib.xjdf.xml

Class XPathNavigator

java.lang.Object

org.cip4.lib.xjdf.xml.XPathNavigator

public class XPathNavigator
extends java.lang.Object

Navigator class which simplify XPath handling using XJdf Documents.

Author:

s.meissner

Method Summary

Methods

Modifier and Type	Method and Description
java.io.InputStream	getXJdfStream() Return the xJdf document as input stream.
static XPathNavigator	newInstance(java.io.InputStream xJdfStream) Factory method for creating a new XPathNavigator object.
java.lang.String	readAttribute(java.lang.String xPath) Read attribute from XJdf Document using XPath.
void	updateAttribute(java.lang.String xPath, java.lang.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

Method Detail

newInstance

public static XPathNavigator newInstance(java.io.InputStream xJdfStream)
                                  throws java.lang.Exception

Factory method for creating a new XPathNavigator object.

Parameters:

xJdfStream - XJdf document as input stream.

Returns:

Initialized XPathNavigator instance.

Throws:

java.io.IOException - Is being thrown in case an exception occurs.

java.lang.Exception

readAttribute

public java.lang.String readAttribute(java.lang.String xPath)
                               throws javax.xml.xpath.XPathExpressionException

Read attribute from XJdf Document using XPath.

Parameters:

xPath - XPath expression of attribute to read.

Returns:

Value of attribute as String.

Throws:

javax.xml.xpath.XPathExpressionException - Is being thrown in case an exception occurs.

updateAttribute

public void updateAttribute(java.lang.String xPath,
                   java.lang.String value)
                     throws java.lang.Exception

Update attribute in XML Document.
!! ATTENTION: WHEN CALLING THIS METHOD READ OPERATIONS BECOME SLOWER !!

Parameters:

xPath - XPath expression of attribute to read.

Throws:

java.lang.Exception - Is being thrown in case an exception occurs.

getXJdfStream

public java.io.InputStream getXJdfStream()
                                  throws java.lang.Exception

Return the xJdf document as input stream.

Returns:

XJdf document as input stream.

Throws:

java.lang.Exception