org.jahia.services.query

Class QueryService

java.lang.Object

org.jahia.services.JahiaService

org.jahia.services.query.QueryService

Direct Known Subclasses:

QueryServiceImpl

public abstract class QueryService
extends JahiaService

Jahia's query service is based on the JCR QueryObjectModelFactory and thus supports all kinds of complex queries specified in JSR-283 (Content Repository for Java� Technology API 2.0) Queries can be created with the API by using the QueryObjectModel. Jahia will also provide a query builder user interface. It is also possible to use SQL-2 and the deprecated XPATH language. As Jahia can plug-in multiple repositories via the universal content hub (UCH), the queries can be converted to other languages, like the EntropySoft connector query language. The query service provides methods to modify and optimize the queries to support and make use of Jahia's internal data model implementation.

Author:

Benjamin Papez

Field Summary

Fields inherited from class org.jahia.services.JahiaService

settingsBean

Constructor Summary

Constructors

Constructor and Description
QueryService()

Method Summary

Modifier and Type	Method and Description
abstract javax.jcr.ValueFactory	getValueFactory() Entry point to request a ValueFactory instance
abstract javax.jcr.query.qom.QueryObjectModel	modifyAndOptimizeQuery(javax.jcr.query.qom.QueryObjectModel qom, javax.jcr.query.qom.QueryObjectModelFactory qomFactory, JCRSessionWrapper session) Modifies the query to adapt to Jahia's internal datamodel implementation, which creates jnt:translation subnodes per locale (language).
abstract javax.jcr.query.qom.QueryObjectModel	modifyAndOptimizeQuery(javax.jcr.query.qom.Source source, javax.jcr.query.qom.Constraint constraint, javax.jcr.query.qom.Ordering[] orderings, javax.jcr.query.qom.Column[] columns, javax.jcr.query.qom.QueryObjectModelFactory qomFactory, JCRSessionWrapper session) Modifies the query to adapt to Jahia's internal datamodel implementation, which creates jnt:translation subnodes per locale (language).

Methods inherited from class org.jahia.services.JahiaService

getSettingsBean, setSettingsBean, start, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryService

public QueryService()

Method Detail

getValueFactory

public abstract javax.jcr.ValueFactory getValueFactory()

Entry point to request a ValueFactory instance

Returns:

ValueFactory

modifyAndOptimizeQuery

public abstract javax.jcr.query.qom.QueryObjectModel modifyAndOptimizeQuery(javax.jcr.query.qom.QueryObjectModel qom,
                                                                            javax.jcr.query.qom.QueryObjectModelFactory qomFactory,
                                                                            JCRSessionWrapper session)
                                                                     throws javax.jcr.RepositoryException

Modifies the query to adapt to Jahia's internal datamodel implementation, which creates jnt:translation subnodes per locale (language). Furthermore Jahia may make modifications because of performance optimization reasons.

Parameters:

qom - the source query object model

qomFactory - query object model factory to use

session - the current JCR session used for the query

Returns:

the modified and optimized query object model

Throws:

javax.jcr.RepositoryException - if the operation fails

modifyAndOptimizeQuery

public abstract javax.jcr.query.qom.QueryObjectModel modifyAndOptimizeQuery(javax.jcr.query.qom.Source source,
                                                                            javax.jcr.query.qom.Constraint constraint,
                                                                            javax.jcr.query.qom.Ordering[] orderings,
                                                                            javax.jcr.query.qom.Column[] columns,
                                                                            javax.jcr.query.qom.QueryObjectModelFactory qomFactory,
                                                                            JCRSessionWrapper session)
                                                                     throws javax.jcr.RepositoryException

Modifies the query to adapt to Jahia's internal datamodel implementation, which creates jnt:translation subnodes per locale (language). Furthermore Jahia may make modifications because of performance optimization reasons.

Parameters:

source - the QOM Source object to use

constraint - the QOM root constraint object to use

orderings - the QOM ordering objects to use

columns - the QOM column objects to use

qomFactory - query object model factory to use

session - the current JCR session used for the query

Returns:

the created modified and optimized query object model

Throws:

javax.jcr.RepositoryException - if the operation fails