public class SaxonXQPreparedExpression extends SaxonXQDynamicContext implements XQPreparedExpression
Note that an expression is scrollable or not depending on the scrollability property of the XQConnection that was used to compile this expression (at the time it was compiled). If the expression is scrollable then its results are delivered in an XQSequence that supports scrolling backwards as well as forwards.
For full Javadoc details, see the XQJ interface specification.
connection| Modifier | Constructor and Description |
|---|---|
protected |
SaxonXQPreparedExpression(SaxonXQConnection connection,
XQueryExpression expression,
SaxonXQStaticContext sqc,
DynamicQueryContext context) |
| 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
XQPreparedExpression. |
XQResultSequence |
executeQuery()
Executes the prepared query expression.
|
protected boolean |
externalVariableExists(QName name) |
QName[] |
getAllExternalVariables()
Retrieves all the external variables defined in the prolog of the
prepared expression.
|
QName[] |
getAllUnboundExternalVariables()
Retrieves the names of all unbound external variables.
|
protected SaxonXQConnection |
getConnection() |
protected SaxonXQDataFactory |
getDataFactory() |
protected DynamicQueryContext |
getDynamicContext() |
protected SaxonXQStaticContext |
getSaxonXQStaticContext() |
XQStaticContext |
getStaticContext()
Gets an
XQStaticContext representing the values for all
expression properties. |
XQSequenceType |
getStaticResultType()
Gets the static type information of the result sequence.
|
XQSequenceType |
getStaticVariableType(QName name)
Retrieves the static type of a given external variable.
|
protected XQueryExpression |
getXQueryExpression() |
bindAtomicValue, bindBoolean, bindByte, bindDocument, bindDocument, bindDocument, bindDocument, bindDocument, bindDouble, bindFloat, bindInt, bindItem, bindLong, bindNode, bindObject, bindSequence, bindShort, bindString, getConfiguration, getImplicitTimeZone, setImplicitTimeZoneclose, isClosed, setClosableContainerclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitclose, isClosedbindAtomicValue, bindBoolean, bindByte, bindDocument, bindDocument, bindDocument, bindDocument, bindDocument, bindDouble, bindFloat, bindInt, bindItem, bindLong, bindNode, bindObject, bindSequence, bindShort, bindString, getImplicitTimeZone, setImplicitTimeZoneprotected SaxonXQPreparedExpression(SaxonXQConnection connection, XQueryExpression expression, SaxonXQStaticContext sqc, DynamicQueryContext context) throws XQException
XQExceptionprotected DynamicQueryContext getDynamicContext()
getDynamicContext in class SaxonXQDynamicContextprotected SaxonXQConnection getConnection()
protected SaxonXQDataFactory getDataFactory() throws XQException
getDataFactory in class SaxonXQDynamicContextXQExceptionprotected XQueryExpression getXQueryExpression()
protected SaxonXQStaticContext getSaxonXQStaticContext()
public void cancel()
throws XQException
XQPreparedExpressionXQPreparedExpression.
This method can be used by one thread to cancel an XQPreparedExpression,
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.cancel in interface XQPreparedExpressionXQException - if the prepared expression is in a closed statepublic XQResultSequence executeQuery() throws XQException
XQPreparedExpressionexecuteQuery in interface XQPreparedExpressionXQException - if (1) there are errors when executing the prepared
expression, (2) the prepared expression is in a closed state,
or (3) the query execution is cancelledpublic QName[] getAllExternalVariables() throws XQException
XQPreparedExpressiongetAllExternalVariables in interface XQPreparedExpressionQName objects for all the external
variables defined in the prolog of a prepared expression.
Empty array if there are no external variables present.XQException - if the prepared expression is in a closed statepublic QName[] getAllUnboundExternalVariables() throws XQException
XQPreparedExpressiongetAllUnboundExternalVariables in interface XQPreparedExpressionQName for all the external variables defined
in the prolog of a prepared expression that are yet to be bound
with a value. If there are no such variables an empty array
is returnedXQException - if the prepared expression is in a closed statepublic XQStaticContext getStaticContext() throws XQException
XQPreparedExpressionXQStaticContext representing the values for all
expression properties. Note that these properties cannot be changed; in
order to change, a new XQPreparedExpression needs to be created.getStaticContext in interface XQPreparedExpressionXQStaticContext representing
the values for all expression propertiesXQException - if the expression is in a closed statepublic XQSequenceType getStaticResultType() throws XQException
XQPreparedExpressionXQSequenceType object
corresponding to the XQuery sequence type item()*.getStaticResultType in interface XQPreparedExpressionXQSequenceType containing the static
result information.XQException - if the prepared expression is in a closed statepublic XQSequenceType getStaticVariableType(QName name) throws XQException
XQPreparedExpressiongetStaticVariableType in interface XQPreparedExpressionname - the name of the external variableXQException - if (1) the variable does not exist in the static
context of the expression, or (2) the sequence is
in a closed state, or (3) the name
parameter is nullprotected boolean externalVariableExists(QName name)
externalVariableExists in class SaxonXQDynamicContextCopyright (c) 2004-2013 Saxonica Limited. All rights reserved.