org.jahia.services.content

Interface QueryManagerWrapper

All Superinterfaces:

javax.jcr.query.QueryManager

All Known Implementing Classes:

QueryManagerImpl

public interface QueryManagerWrapper
extends javax.jcr.query.QueryManager

Extension of the QueryManager interface, with wrapped return types

Method Summary

Modifier and Type	Method and Description
QueryWrapper	createDualQuery(String statement, String language, String sqlFallbackStatement) Creates a new query by specifying the query statement in xpath and in SQL2.
QueryWrapper	createQuery(String statement, String language) Creates a new query by specifying the query statement itself and the language in which the query is stated.
javax.jcr.query.qom.QueryObjectModelFactory	getQOMFactory() Returns a QueryObjectModelFactory with which a JCR-JQOM query can be built programmatically.
QueryWrapper	getQuery(javax.jcr.Node node) Retrieves an existing persistent query.

Methods inherited from interface javax.jcr.query.QueryManager

getSupportedQueryLanguages

Method Detail

createQuery

QueryWrapper createQuery(String statement,
                         String language)
                  throws javax.jcr.query.InvalidQueryException,
                         javax.jcr.RepositoryException

Creates a new query by specifying the query statement itself and the language in which the query is stated. The language must be a string from among those returned by QueryManager.getSupportedQueryLanguages().

Specified by:

createQuery in interface javax.jcr.query.QueryManager

Parameters:

statement - a String

language - a String

Returns:

a Query object

Throws:

javax.jcr.query.InvalidQueryException - if the query statement is syntactically invalid or the specified language is not supported.

javax.jcr.RepositoryException - if another error occurs.

createDualQuery

QueryWrapper createDualQuery(String statement,
                             String language,
                             String sqlFallbackStatement)
                      throws javax.jcr.query.InvalidQueryException,
                             javax.jcr.RepositoryException

Creates a new query by specifying the query statement in xpath and in SQL2. XPath will be used against jackrabbit where SQL2 can be used as a fallback statement in other providers, which may not support xpath. QueryManager.getSupportedQueryLanguages().

Parameters:

statement - a String

language - a String

sqlFallbackStatement - a String

Returns:

a Query object

Throws:

javax.jcr.query.InvalidQueryException - if the query statement is syntactically invalid or the specified language is not supported.

javax.jcr.RepositoryException - if another error occurs.

getQOMFactory

javax.jcr.query.qom.QueryObjectModelFactory getQOMFactory()

Returns a QueryObjectModelFactory with which a JCR-JQOM query can be built programmatically.

Specified by:

getQOMFactory in interface javax.jcr.query.QueryManager

Returns:

a QueryObjectModelFactory object

Since:

JCR 2.0

getQuery

QueryWrapper getQuery(javax.jcr.Node node)
               throws javax.jcr.query.InvalidQueryException,
                      javax.jcr.RepositoryException

Retrieves an existing persistent query.

Persistent queries are created by first using QueryManager.createQuery(java.lang.String, java.lang.String) to create a Query object and then calling Query.save to persist the query to a location in the workspace.

Specified by:

getQuery in interface javax.jcr.query.QueryManager

Parameters:

node - a persisted query (that is, a node of type nt:query).

Returns:

a Query object.

Throws:

javax.jcr.query.InvalidQueryException - If node is not a valid persisted query (that is, a node of type nt:query).

javax.jcr.RepositoryException - if another error occurs