com.saxonica.xqj

Class SaxonXQExpression

java.lang.Object

com.saxonica.xqj.Closable

com.saxonica.xqj.SaxonXQDynamicContext

com.saxonica.xqj.SaxonXQExpression

All Implemented Interfaces:

XQDynamicContext, XQExpression

public class SaxonXQExpression
extends SaxonXQDynamicContext
implements XQExpression

Saxon implementation of the XQJ XQExpression interface

Field Summary

Fields inherited from class com.saxonica.xqj.SaxonXQDynamicContext

connection

Method Summary

Methods

Modifier and Type	Method and Description
void	cancel() Attempts to cancel the execution if both the XQuery engine and XQJ driver support aborting the execution of an XQExpression.
void	executeCommand(Reader command) Executes an implementation-defined command.
void	executeCommand(String command) Executes an implementation-defined command.
XQResultSequence	executeQuery(InputStream query) Executes a query expression.
XQResultSequence	executeQuery(Reader query) Executes a query expression.
XQResultSequence	executeQuery(String query) Executes a query expression.
protected boolean	externalVariableExists(QName name)
protected SaxonXQDataFactory	getDataFactory()
protected DynamicQueryContext	getDynamicContext()
XQStaticContext	getStaticContext() Gets an XQStaticContext representing the values for all expression properties.

Methods inherited from class com.saxonica.xqj.SaxonXQDynamicContext

bindAtomicValue, bindBoolean, bindByte, bindDocument, bindDocument, bindDocument, bindDocument, bindDocument, bindDouble, bindFloat, bindInt, bindItem, bindLong, bindNode, bindObject, bindSequence, bindShort, bindString, getConfiguration, getImplicitTimeZone, setImplicitTimeZone

Methods inherited from class com.saxonica.xqj.Closable

close, isClosed, setClosableContainer

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.xml.xquery.XQExpression

close, isClosed

Methods inherited from interface javax.xml.xquery.XQDynamicContext

bindAtomicValue, bindBoolean, bindByte, bindDocument, bindDocument, bindDocument, bindDocument, bindDocument, bindDouble, bindFloat, bindInt, bindItem, bindLong, bindNode, bindObject, bindSequence, bindShort, bindString, getImplicitTimeZone, setImplicitTimeZone

Method Detail

getDynamicContext

protected DynamicQueryContext getDynamicContext()

Specified by:

getDynamicContext in class SaxonXQDynamicContext

getDataFactory

protected SaxonXQDataFactory getDataFactory()
                                     throws XQException

Specified by:

getDataFactory in class SaxonXQDynamicContext

Throws:

XQException

cancel

public void cancel()
            throws XQException

Description copied from interface: XQExpression

Attempts to cancel the execution if both the XQuery engine and XQJ driver support aborting the execution of an XQExpression. This method can be used by one thread to cancel an XQExpression, that is being executed in another thread. If cancellation is not supported or the attempt to cancel the execution was not successful, the method returns without any error. If the cancellation is successful, an XQException is thrown, to indicate that it has been aborted, by executeQuery, executeCommand or any method accessing the XQResultSequence returned by executeQuery. If applicable, any open XQResultSequence and XQResultItem objects will also be implicitly closed in this case.

Specified by:

cancel in interface XQExpression

Throws:

XQException - if the expression is in a closed state

executeCommand

public void executeCommand(Reader command)
                    throws XQException

Description copied from interface: XQExpression

Executes an implementation-defined command. Calling this method implicitly closes any previous result sequence obtained from this expression.

Specified by:

executeCommand in interface XQExpression

Parameters:

command - the input command as a string reader

Throws:

XQException - if (1) there are errors when executing the command, (2) the expression is in a closed state, or (3) the execution is cancelled

executeCommand

public void executeCommand(String command)
                    throws XQException

Description copied from interface: XQExpression

Executes an implementation-defined command. Calling this method implicitly closes any previous result sequence obtained from this expression.

Specified by:

executeCommand in interface XQExpression

Parameters:

command - the input command as a string

Throws:

XQException - if (1) there are errors when executing the command, or (2) the expression is in a closed state

executeQuery

public XQResultSequence executeQuery(InputStream query)
                              throws XQException

Description copied from interface: XQExpression

Executes a query expression. This implicitly closes any previous result sequences obtained from this expression.

If the query specifies a version declaration including an encoding, the XQJ implementation may try use this information to parse the query. In absence of the version declaration, the assumed encoding is implementation dependent.

Specified by:

executeQuery in interface XQExpression

Parameters:

query - the input query expression as a input stream object. Cannot be null

Returns:

an XQResultSequence containing the result of the query execution

Throws:

XQException - if (1) there are errors when executing the query, (2) the expression is in a closed state, (3) the execution is cancelled, or (4) the xquery parameter is null

executeQuery

public XQResultSequence executeQuery(Reader query)
                              throws XQException

Description copied from interface: XQExpression

Executes a query expression. This implicitly closes any previous result sequences obtained from this expression.

Specified by:

executeQuery in interface XQExpression

Parameters:

query - the input query expression as a reader object. Cannot be null

Returns:

an XQResultSequence object containing the result of the query execution

Throws:

XQException - if (1) there are errors when executing the query, (2) the expression is in a closed state, (3) the execution is cancelled, or (4) the query parameter is null

executeQuery

public XQResultSequence executeQuery(String query)
                              throws XQException

Description copied from interface: XQExpression

Executes a query expression. This implicitly closes any previous result sequences obtained from this expression.

Specified by:

executeQuery in interface XQExpression

Parameters:

query - the input query expression string. Cannot be null

Returns:

an XQResultSequence object containing the result of the query execution

Throws:

XQException - if (1) there are errors when executing the query, (2) the expression is in a closed state, (3) the execution is cancelled, (4) the query parameter is null

getStaticContext

public XQStaticContext getStaticContext()
                                 throws XQException

Description copied from interface: XQExpression

Gets an XQStaticContext representing the values for all expression properties. Note that these properties cannot be changed; in order to change, a new XQExpression needs to be created.

Specified by:

getStaticContext in interface XQExpression

Returns:

an XQStaticContext representing the values for all expression properties

Throws:

XQException - if the expression is in a closed state

externalVariableExists

protected boolean externalVariableExists(QName name)

Specified by:

externalVariableExists in class SaxonXQDynamicContext