javax.jcr.query

Interface QueryManager

public interface QueryManager

This interface encapsulates methods for the management of search queries. Provides methods for the creation and retrieval of search queries.

Sitevision note: Unsupported operation

Method Summary

Modifier and Type	Method and Description
Query	createQuery(String statement, String language) Creates a new query by specifying the query statement itself and the language in which the query is stated.
QueryObjectModelFactory	getQOMFactory() Returns a QueryObjectModelFactory with which a JCR-JQOM query can be built programmatically.
Query	getQuery(Node node) Retrieves an existing persistent query.
String[]	getSupportedQueryLanguages() Returns an array of strings representing all query languages supported by this repository.

Method Detail

createQuery

Query createQuery(String statement,
                  String language)
           throws InvalidQueryException,
                  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().

Parameters:

statement - a String

language - a String

Returns:

a Query object

Throws:

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

RepositoryException - if another error occurs.

getQOMFactory

QueryObjectModelFactory getQOMFactory()

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

Returns:

a QueryObjectModelFactory object

Since:

JCR 2.0

getQuery

Query getQuery(Node node)
        throws InvalidQueryException,
               RepositoryException

Retrieves an existing persistent query.

Persistent queries are created by first using 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.

Parameters:

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

Returns:

a Query object.

Throws:

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

RepositoryException - if another error occurs

getSupportedQueryLanguages

String[] getSupportedQueryLanguages()
                             throws RepositoryException

Returns an array of strings representing all query languages supported by this repository. This set must include at least the strings represented by the constants Query.JCR_SQL2 and Query.JCR_JQOM}. An implementation may also support other languages, including the deprecated languages of JCR 1.0: Query.XPATH and Query.SQL.

Returns:

A string array.

Throws:

RepositoryException - if an error occurs.