org.eclipse.persistence.internal.jpa.querydef

Class AbstractQueryImpl<T>

java.lang.Object

org.eclipse.persistence.internal.jpa.querydef.CommonAbstractCriteriaImpl<T>

org.eclipse.persistence.internal.jpa.querydef.AbstractQueryImpl<T>

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

CriteriaQueryImpl, SubQueryImpl

public abstract class AbstractQueryImpl<T>
extends CommonAbstractCriteriaImpl<T>

Purpose: Contains the implementation of the AbstractQuery interface of the JPA criteria API.

Description: This is the container class for the components that define a query. This is the superclass of both the CriteriaQuery and the SubQuery.

Since:

EclipseLink 1.2

Author:

gyorke

See Also:

CriteriaQuery, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractQueryImpl.ResultType

Field Summary

Fields

Modifier and Type	Field and Description
protected org.eclipse.persistence.expressions.Expression	baseExpression
protected boolean	distinct
protected java.util.List<<any>>	groupBy
protected Predicate	havingClause
protected AbstractQueryImpl.ResultType	queryResult
protected java.util.Set<<any>>	roots

Fields inherited from class org.eclipse.persistence.internal.jpa.querydef.CommonAbstractCriteriaImpl

metamodel, parameters, queryBuilder, queryType, where

Constructor Summary

Constructors

Constructor and Description
AbstractQueryImpl(Metamodel metamodel, AbstractQueryImpl.ResultType queryResult, CriteriaBuilderImpl queryBuilder, java.lang.Class<T> resultType)

Method Summary

Modifier and Type	Method and Description
abstract void	addJoin(FromImpl join)
<any>	distinct(boolean distinct) Specify whether duplicate query results will be eliminated.
protected void	findJoins(FromImpl root)
protected void	findRootAndParameters(<any> selection)
<X> <any>	from(<any> entity) Add a query root corresponding to the given entity, forming a Cartesian product with any existing roots.
<X> <any>	from(java.lang.Class<X> entityClass) Add a query root corresponding to the given entity, forming a Cartesian product with any existing roots.
protected org.eclipse.persistence.expressions.Expression	getBaseExpression()
protected org.eclipse.persistence.expressions.Expression	getBaseExpression(Root root)
java.util.List<<any>>	getGroupList() Return a list of the grouping expressions
Predicate	getGroupRestriction() Return the predicate that corresponds to the restriction(s) over the grouping items.
java.util.Set<<any>>	getRoots() Return the query roots.
<any>	groupBy(<any>... grouping) Specify the expressions that are used to form groups over the query results.
<any>	groupBy(java.util.List<<any>> grouping) Specify the expressions that are used to form groups over the query results.
<any>	having(<any> restriction) Specify a restriction over the groups of the query.
<any>	having(Predicate... restrictions) Specify restrictions over the groups of the query according the conjunction of the specified restriction predicates.
protected void	integrateRoot(RootImpl root) Used to use a root from a different query.
boolean	isDistinct() Return whether duplicate query results must be eliminated or retained.
<any>	where(<any> restriction) Modify the query to restrict the query result according to the specified boolean expression.
<any>	where(Predicate... restrictions) Modify the query to restrict the query result according to the conjunction of the specified restriction predicates.

Methods inherited from class org.eclipse.persistence.internal.jpa.querydef.CommonAbstractCriteriaImpl

addParameter, getDatabaseQuery, getParameters, getRestriction, getResultType, internalFrom, internalFrom, subquery, translate

Methods inherited from class java.lang.Object

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

Field Detail

queryResult

protected AbstractQueryImpl.ResultType queryResult

distinct

protected boolean distinct

havingClause

protected Predicate havingClause

groupBy

protected java.util.List<<any>> groupBy

roots

protected java.util.Set<<any>> roots

baseExpression

protected org.eclipse.persistence.expressions.Expression baseExpression

Constructor Detail

AbstractQueryImpl

public AbstractQueryImpl(Metamodel metamodel,
                         AbstractQueryImpl.ResultType queryResult,
                         CriteriaBuilderImpl queryBuilder,
                         java.lang.Class<T> resultType)

Method Detail

groupBy

public <any> groupBy(java.util.List<<any>> grouping)

Specify the expressions that are used to form groups over the query results. Replaces the previous specified grouping expressions, if any. If no grouping expressions are specified, any previously added grouping expressions are simply removed.

Parameters:

grouping - list of zero or more grouping expressions

Returns:

the modified query

groupBy

public <any> groupBy(<any>... grouping)

Specify the expressions that are used to form groups over the query results. Replaces the previous specified grouping expressions, if any. If no grouping expressions are specified, any previously added grouping expressions are simply removed.

Parameters:

grouping - zero or more grouping expressions

Returns:

the modified query

having

public <any> having(<any> restriction)

Specify a restriction over the groups of the query. Replaces the previous having restriction(s), if any.

Parameters:

restriction - a simple or compound boolean expression

Returns:

the modified query

having

public <any> having(Predicate... restrictions)

Specify restrictions over the groups of the query according the conjunction of the specified restriction predicates. Replaces the previously added restriction(s), if any. If no restrictions are specified, any previously added restrictions are simply removed.

Parameters:

restrictions - zero or more restriction predicates

Returns:

the modified query

addJoin

public abstract void addJoin(FromImpl join)

distinct

public <any> distinct(boolean distinct)

Specify whether duplicate query results will be eliminated. A true value will cause duplicates to be eliminated. A false value will cause duplicates to be retained. If distinct has not been specified, duplicate results must be retained. This method only overrides the return type of the corresponding AbstractQuery method.

Parameters:

distinct - boolean value specifying whether duplicate results must be eliminated from the query result or whether they must be retained

Returns:

the modified query.

getBaseExpression

protected org.eclipse.persistence.expressions.Expression getBaseExpression()

Specified by:

getBaseExpression in class CommonAbstractCriteriaImpl<T>

getBaseExpression

protected org.eclipse.persistence.expressions.Expression getBaseExpression(Root root)

getGroupList

public java.util.List<<any>> getGroupList()

Return a list of the grouping expressions

Returns:

the list of grouping expressions

getGroupRestriction

public Predicate getGroupRestriction()

Return the predicate that corresponds to the restriction(s) over the grouping items.

Returns:

having clause predicate

getRoots

public java.util.Set<<any>> getRoots()

Return the query roots.

Returns:

the set of query roots

integrateRoot

protected void integrateRoot(RootImpl root)

Description copied from class: CommonAbstractCriteriaImpl

Used to use a root from a different query.

Specified by:

integrateRoot in class CommonAbstractCriteriaImpl<T>

isDistinct

public boolean isDistinct()

Return whether duplicate query results must be eliminated or retained.

Returns:

boolean indicating whether duplicate query results must be eliminated

findJoins

protected void findJoins(FromImpl root)

findRootAndParameters

protected void findRootAndParameters(<any> selection)

Overrides:

findRootAndParameters in class CommonAbstractCriteriaImpl<T>

from

public <X> <any> from(<any> entity)

Add a query root corresponding to the given entity, forming a Cartesian product with any existing roots.

Parameters:

entity - metamodel entity representing the entity of type X

Returns:

query root corresponding to the given entity

from

public <X> <any> from(java.lang.Class<X> entityClass)

Add a query root corresponding to the given entity, forming a Cartesian product with any existing roots.

Parameters:

entityClass - the entity class

Returns:

query root corresponding to the given entity

where

public <any> where(<any> restriction)

Modify the query to restrict the query result according to the specified boolean expression. Replaces the previously added restriction(s), if any. This method only overrides the return type of the corresponding AbstractQuery method.

Overrides:

where in class CommonAbstractCriteriaImpl<T>

Parameters:

restriction - a simple or compound boolean expression

Returns:

the modified query

where

public <any> where(Predicate... restrictions)

Modify the query to restrict the query result according to the conjunction of the specified restriction predicates. Replaces the previously added restriction(s), if any. If no restrictions are specified, any previously added restrictions are simply removed. This method only overrides the return type of the corresponding AbstractQuery method.

Overrides:

where in class CommonAbstractCriteriaImpl<T>

Parameters:

restrictions - zero or more restriction predicates

Returns:

the modified query