javax.jcr.query.qom
Interface QueryObjectModel

All Superinterfaces:

Query

public interface QueryObjectModel
extends Query

A query in the JCR query object model.

The JCR query object model describes the queries that can be evaluated by a JCR repository independent of any particular query language, such as SQL.

A query consists of:

• a source. When the query is evaluated, the source evaluates its selectors and the joins between them to produce a (possibly empty) set of node-tuples. This is a set of 1-tuples if the query has one selector (and therefore no joins), a set of 2-tuples if the query has two selectors (and therefore one join), a set of 3-tuples if the query has three selectors (two joins), and so forth.
• an optional constraint. When the query is evaluated, the constraint filters the set of node-tuples.
• a list of zero or more orderings. The orderings specify the order in which the node-tuples appear in the query results. The relative order of two node-tuples is determined by evaluating the specified orderings, in list order, until encountering an ordering for which one node-tuple precedes the other. If no orderings are specified, or if for none of the specified orderings does one node-tuple precede the other, then the relative order of the node-tuples is implementation determined (and may be arbitrary).
• a list of zero or more columns to include in the tabular view of the query results. If no columns are specified, the columns available in the tabular view are implementation determined, but minimally include, for each selector, a column for each single-valued non-residual property of the selector's node type.

The query object model representation of a query is created by factory methods in the QueryObjectModelFactory.

Since:

JCR 2.0

Field Summary

Fields inherited from interface javax.jcr.query.Query

JCR_JQOM, JCR_SQL2, SQL, XPATH

Method Summary

Column[]	getColumns() Gets the columns for this query.
Constraint	getConstraint() Gets the constraint for this query.
Ordering[]	getOrderings() Gets the orderings for this query.
Source	getSource() Gets the node-tuple source for this query.

Methods inherited from interface javax.jcr.query.Query

bindValue, execute, getBindVariableNames, getLanguage, getStatement, getStoredQueryPath, setLimit, setOffset, storeAsNode

Method Detail

getSource

Source getSource()

Gets the node-tuple source for this query.

Returns:

the node-tuple source; non-null

getConstraint

Constraint getConstraint()

Gets the constraint for this query.

Returns:

the constraint, or null if none

getOrderings

Ordering[] getOrderings()

Gets the orderings for this query.

Returns:

an array of zero or more orderings; non-null

getColumns

Column[] getColumns()

Gets the columns for this query.

Returns:

an array of zero or more columns; non-null