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:

jakarta.persistence.criteria.AbstractQuery<T>, jakarta.persistence.criteria.CommonAbstractCriteria, Serializable

Direct Known Subclasses:

CriteriaQueryImpl, SubQueryImpl

public abstract class AbstractQueryImpl<T>
extends CommonAbstractCriteriaImpl<T>
implements jakarta.persistence.criteria.AbstractQuery<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 Expression	baseExpression
protected boolean	distinct
protected List<jakarta.persistence.criteria.Expression<?>>	groupBy
protected jakarta.persistence.criteria.Predicate	havingClause
protected AbstractQueryImpl.ResultType	queryResult
protected Set<jakarta.persistence.criteria.Root<?>>	roots

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

metamodel, parameters, queryBuilder, queryType, where

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
abstract void	addJoin(FromImpl join)
jakarta.persistence.criteria.AbstractQuery<T>	distinct(boolean distinct) Specify whether duplicate query results will be eliminated.
protected void	findJoins(FromImpl root)
protected void	findRootAndParameters(jakarta.persistence.criteria.Selection<?> selection)
<X> jakarta.persistence.criteria.Root<X>	from(Class<X> entityClass) Add a query root corresponding to the given entity, forming a Cartesian product with any existing roots.
<X> jakarta.persistence.criteria.Root<X>	from(jakarta.persistence.metamodel.EntityType<X> entity) Add a query root corresponding to the given entity, forming a Cartesian product with any existing roots.
protected Expression	getBaseExpression()
protected Expression	getBaseExpression(jakarta.persistence.criteria.Root root)
List<jakarta.persistence.criteria.Expression<?>>	getGroupList() Return a list of the grouping expressions
jakarta.persistence.criteria.Predicate	getGroupRestriction() Return the predicate that corresponds to the restriction(s) over the grouping items.
Set<jakarta.persistence.criteria.Root<?>>	getRoots() Return the query roots.
jakarta.persistence.criteria.AbstractQuery<T>	groupBy(jakarta.persistence.criteria.Expression<?>... grouping) Specify the expressions that are used to form groups over the query results.
jakarta.persistence.criteria.AbstractQuery<T>	groupBy(List<jakarta.persistence.criteria.Expression<?>> grouping) Specify the expressions that are used to form groups over the query results.
jakarta.persistence.criteria.AbstractQuery<T>	having(jakarta.persistence.criteria.Expression<Boolean> restriction) Specify a restriction over the groups of the query.
jakarta.persistence.criteria.AbstractQuery<T>	having(jakarta.persistence.criteria.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.
jakarta.persistence.criteria.AbstractQuery<T>	where(jakarta.persistence.criteria.Expression<Boolean> restriction) Modify the query to restrict the query result according to the specified boolean expression.
jakarta.persistence.criteria.AbstractQuery<T>	where(jakarta.persistence.criteria.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, findRootAndParameters, 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

Methods inherited from interface jakarta.persistence.criteria.AbstractQuery

getResultType, getSelection

Methods inherited from interface jakarta.persistence.criteria.CommonAbstractCriteria

getRestriction, subquery

Field Detail

queryResult

protected AbstractQueryImpl.ResultType queryResult

distinct

protected boolean distinct

havingClause

protected jakarta.persistence.criteria.Predicate havingClause

groupBy

protected List<jakarta.persistence.criteria.Expression<?>> groupBy

roots

protected Set<jakarta.persistence.criteria.Root<?>> roots

baseExpression

protected Expression baseExpression

Constructor Detail

AbstractQueryImpl

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

Method Detail

groupBy

public jakarta.persistence.criteria.AbstractQuery<T> groupBy(List<jakarta.persistence.criteria.Expression<?>> 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.

Specified by:

groupBy in interface jakarta.persistence.criteria.AbstractQuery<T>

Parameters:

grouping - list of zero or more grouping expressions

Returns:

the modified query

groupBy

public jakarta.persistence.criteria.AbstractQuery<T> groupBy(jakarta.persistence.criteria.Expression<?>... 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.

Specified by:

groupBy in interface jakarta.persistence.criteria.AbstractQuery<T>

Parameters:

grouping - zero or more grouping expressions

Returns:

the modified query

having

public jakarta.persistence.criteria.AbstractQuery<T> having(jakarta.persistence.criteria.Expression<Boolean> restriction)

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

Specified by:

having in interface jakarta.persistence.criteria.AbstractQuery<T>

Parameters:

restriction - a simple or compound boolean expression

Returns:

the modified query

having

public jakarta.persistence.criteria.AbstractQuery<T> having(jakarta.persistence.criteria.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.

Specified by:

having in interface jakarta.persistence.criteria.AbstractQuery<T>

Parameters:

restrictions - zero or more restriction predicates

Returns:

the modified query

addJoin

public abstract void addJoin(FromImpl join)

distinct

public jakarta.persistence.criteria.AbstractQuery<T> 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.

Specified by:

distinct in interface jakarta.persistence.criteria.AbstractQuery<T>

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 Expression getBaseExpression()

Specified by:

getBaseExpression in class CommonAbstractCriteriaImpl<T>

getBaseExpression

protected Expression getBaseExpression(jakarta.persistence.criteria.Root root)

getGroupList

public List<jakarta.persistence.criteria.Expression<?>> getGroupList()

Return a list of the grouping expressions

Specified by:

getGroupList in interface jakarta.persistence.criteria.AbstractQuery<T>

Returns:

the list of grouping expressions

getGroupRestriction

public jakarta.persistence.criteria.Predicate getGroupRestriction()

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

Specified by:

getGroupRestriction in interface jakarta.persistence.criteria.AbstractQuery<T>

Returns:

having clause predicate

getRoots

public Set<jakarta.persistence.criteria.Root<?>> getRoots()

Return the query roots.

Specified by:

getRoots in interface jakarta.persistence.criteria.AbstractQuery<T>

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.

Specified by:

isDistinct in interface jakarta.persistence.criteria.AbstractQuery<T>

Returns:

boolean indicating whether duplicate query results must be eliminated

findJoins

protected void findJoins(FromImpl root)

findRootAndParameters

protected void findRootAndParameters(jakarta.persistence.criteria.Selection<?> selection)

from

public <X> jakarta.persistence.criteria.Root<X> from(jakarta.persistence.metamodel.EntityType<X> entity)

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

Specified by:

from in interface jakarta.persistence.criteria.AbstractQuery<T>

Parameters:

entity - metamodel entity representing the entity of type X

Returns:

query root corresponding to the given entity

from

public <X> jakarta.persistence.criteria.Root<X> from(Class<X> entityClass)

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

Specified by:

from in interface jakarta.persistence.criteria.AbstractQuery<T>

Parameters:

entityClass - the entity class

Returns:

query root corresponding to the given entity

where

public jakarta.persistence.criteria.AbstractQuery<T> where(jakarta.persistence.criteria.Expression<Boolean> 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.

Specified by:

where in interface jakarta.persistence.criteria.AbstractQuery<T>

Overrides:

where in class CommonAbstractCriteriaImpl<T>

Parameters:

restriction - a simple or compound boolean expression

Returns:

the modified query

where

public jakarta.persistence.criteria.AbstractQuery<T> where(jakarta.persistence.criteria.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.

Specified by:

where in interface jakarta.persistence.criteria.AbstractQuery<T>

Overrides:

where in class CommonAbstractCriteriaImpl<T>

Parameters:

restrictions - zero or more restriction predicates

Returns:

the modified query