ModeShape Distribution 3.5.0.Final

org.modeshape.jcr.api.query
Interface Query

All Superinterfaces:
Query

public interface Query
extends Query

A specialization of the standard JCR Query interface that adds the ModeShape-specific constant for the full-text search query language.


Field Summary
static String FULL_TEXT_SEARCH
          A string constant representing the ModeShape full-text search query language.
 
Fields inherited from interface javax.jcr.query.Query
JCR_JQOM, JCR_SQL2, SQL, XPATH
 
Method Summary
 boolean cancel()
          Signal that the query, if currently executing, should be cancelled and stopped (with an exception).
 QueryResult explain()
          Generates a plan for the this query and returns a QueryResult object that contains no results (nodes or rows) but does have a query plan.
 String getAbstractQueryModelRepresentation()
          Get the underlying and immutable Abstract Query Model representation of this query.
 
Methods inherited from interface javax.jcr.query.Query
bindValue, execute, getBindVariableNames, getLanguage, getStatement, getStoredQueryPath, setLimit, setOffset, storeAsNode
 

Field Detail

FULL_TEXT_SEARCH

static final String FULL_TEXT_SEARCH
A string constant representing the ModeShape full-text search query language.

See Also:
Constant Field Values
Method Detail

cancel

boolean cancel()
Signal that the query, if currently executing, should be cancelled and stopped (with an exception). This method does not block until the query is actually stopped.

Returns:
true if the query was executing and will be cancelled, or false if the query was no longer running (because it had finished successfully or had already been cancelled) and could not be cancelled.

getAbstractQueryModelRepresentation

String getAbstractQueryModelRepresentation()
Get the underlying and immutable Abstract Query Model representation of this query.

Returns:
the string representation of this query's abstract query model; never null

explain

QueryResult explain()
                    throws InvalidQueryException,
                           RepositoryException
Generates a plan for the this query and returns a QueryResult object that contains no results (nodes or rows) but does have a query plan.

If this Query contains a variable (see BindVariableValue) which has not been bound to a value (see Query.bindValue(java.lang.String, javax.jcr.Value)) then this method throws an InvalidQueryException.

Returns:
a QueryResult object
Throws:
InvalidQueryException - if the query contains an unbound variable.
RepositoryException - if another error occurs.
See Also:
Query.execute()

ModeShape Distribution 3.5.0.Final

Copyright © 2008-2013 JBoss, a division of Red Hat. All Rights Reserved.