XmlContainer.parseXPathExpression

APIRef

import com.sleepycat.dbxml.*;

public XPathExpression parseXPathExpression( String xpath, XmlQueryContext context, int flags) throws XmlException;

Description

Return a pre-parsed XPath 1.0 version query for later use with the XmlContainer.queryWithXPath method. The query is provided as a string and is expected to be in the syntax defined in the W3C XPath 1.0 specification.

The query may optionally be done within the execution context context, which describes how the query is to be performed.

The flags parameter is currently unused, and must be set to 0.

The XmlContainer.parseXPathExpression method throws an exception that encapsulates a non-zero error value on failure.

Errors

The XmlContainer.parseXPathExpression method may fail and throw an exception encapsulating a non-zero error for the following conditions:

EINVAL
An invalid flag value or parameter was specified.

The XmlContainer.parseXPathExpression method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. If a catastrophic error has occurred, the XmlContainer.parseXPathExpression method may fail and throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way.

Class

XmlContainer, XmlDocument, XmlQueryContext

See Also

XmlContainer.close, XmlContainer.declareIndex, XmlContainer.deleteDocument, XmlContainer.getDocument, XmlContainer.getName, XmlContainer.open, XmlContainer.putDocument and XmlContainer.queryWithXPath.

XmlDocument.getAttributeValue, XmlDocument.getContent, XmlDocument.getID, XmlDocument.getName, XmlDocument.getType, XmlDocument.setContent, XmlDocument.setName, and XmlDocument.setType.

APIRef

Copyright Sleepycat Software