org.eclipse.persistence.internal.jpa.querydef

Class SubQueryImpl<T>

java.lang.Object

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

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

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

All Implemented Interfaces:

jakarta.persistence.criteria.AbstractQuery<T>, jakarta.persistence.criteria.CommonAbstractCriteria, jakarta.persistence.criteria.Expression<T>, jakarta.persistence.criteria.Selection<T>, jakarta.persistence.criteria.Subquery<T>, jakarta.persistence.TupleElement<T>, Serializable, InternalExpression, InternalSelection

public class SubQueryImpl<T>
extends AbstractQueryImpl<T>
implements jakarta.persistence.criteria.Subquery<T>, InternalExpression, InternalSelection

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

Description: This is the container class for the components that define a query to be used in a sub select expression.

Since:

EclipseLink 2.0

Author:

gyorke

See Also:

CriteriaQuery, SubQuery, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.persistence.internal.jpa.querydef.AbstractQueryImpl

AbstractQueryImpl.ResultType

Field Summary

Fields

Modifier and Type	Field and Description
protected String	alias
protected Set<jakarta.persistence.criteria.Join<?,?>>	correlatedJoins
protected Set<Expression>	correlations
protected SubSelectExpression	currentNode
protected jakarta.persistence.criteria.CommonAbstractCriteria	parent
protected Set<FromImpl>	processedJoins
protected SelectionImpl<?>	selection
protected ReportQuery	subQuery

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

baseExpression, distinct, groupBy, havingClause, queryResult, roots

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

metamodel, parameters, queryBuilder, queryType, where

Constructor Summary

Constructors

Constructor and Description
SubQueryImpl(jakarta.persistence.metamodel.Metamodel metamodel, Class result, CriteriaBuilderImpl queryBuilder, jakarta.persistence.criteria.CommonAbstractCriteria parent)

Method Summary

Modifier and Type	Method and Description
void	addJoin(FromImpl join)
void	addParameter(jakarta.persistence.criteria.ParameterExpression<?> parameter)
jakarta.persistence.criteria.Selection<T>	alias(String name) Assign an alias to the selection.
<X> jakarta.persistence.criteria.Expression<X>	as(Class<X> type)
<X,Y> jakarta.persistence.criteria.CollectionJoin<X,Y>	correlate(jakarta.persistence.criteria.CollectionJoin<X,Y> parentCollection) Correlates a join to a Collection-valued association or element collection in the enclosing query to a join object of the subquery and returns the subquery join object.
<X,Y> jakarta.persistence.criteria.Join<X,Y>	correlate(jakarta.persistence.criteria.Join<X,Y> parentJoin) Correlates a join object of the enclosing query to a join object of the subquery and returns the subquery join object.
<X,Y> jakarta.persistence.criteria.ListJoin<X,Y>	correlate(jakarta.persistence.criteria.ListJoin<X,Y> parentList) Correlates a join to a List-valued association or element collection in the enclosing query to a join object of the subquery and returns the subquery join object.
<X,K,V> jakarta.persistence.criteria.MapJoin<X,K,V>	correlate(jakarta.persistence.criteria.MapJoin<X,K,V> parentMap) Correlates a join to a Map-valued association or element collection in the enclosing query to a join object of the subquery and returns the subquery join object.
<Y> jakarta.persistence.criteria.Root<Y>	correlate(jakarta.persistence.criteria.Root<Y> parentRoot) Correlates a root of the enclosing query to a root of the subquery and returns the subquery root.
<X,Y> jakarta.persistence.criteria.SetJoin<X,Y>	correlate(jakarta.persistence.criteria.SetJoin<X,Y> parentSet) Correlates a join to a Set-valued association or element collection in the enclosing query to a join object of the subquery and returns the subquery join object.
jakarta.persistence.criteria.Subquery<T>	distinct(boolean distinct) Specify whether duplicate query results will be eliminated.
void	findRootAndParameters(CommonAbstractCriteriaImpl query)
String	getAlias()
protected Expression	getBaseExpression()
List<jakarta.persistence.criteria.Selection<?>>	getCompoundSelectionItems() Return selection items composing a compound selection
jakarta.persistence.criteria.CommonAbstractCriteria	getContainingQuery()
Set<jakarta.persistence.criteria.Join<?,?>>	getCorrelatedJoins() Return the joins that have been made from the subquery.
Expression	getCurrentNode() Returns the current EclipseLink expression at this node in the criteria expression tree
DatabaseQuery	getDatabaseQuery()
Class<T>	getJavaType()
Set<jakarta.persistence.criteria.ParameterExpression<?>>	getParameters() Return the parameters of the query
jakarta.persistence.criteria.AbstractQuery<?>	getParent() Return the query of which this is a subquery.
jakarta.persistence.criteria.Expression<T>	getSelection() Return the selection item of the query.
jakarta.persistence.criteria.Subquery<T>	groupBy(jakarta.persistence.criteria.Expression<?>... grouping) Specify the expressions that are used to form groups over the query results.
jakarta.persistence.criteria.Subquery<T>	groupBy(List<jakarta.persistence.criteria.Expression<?>> grouping) Specify the expressions that are used to form groups over the query results.
jakarta.persistence.criteria.Subquery<T>	having(jakarta.persistence.criteria.Expression<Boolean> restriction) Specify a restriction over the groups of the query.
jakarta.persistence.criteria.Subquery<T>	having(jakarta.persistence.criteria.Predicate... restrictions) Specify restrictions over the groups of the query according the conjunction of the specified restriction predicates.
jakarta.persistence.criteria.Predicate	in(Collection<?> values) Apply a predicate to test whether the expression is a member of the collection.
jakarta.persistence.criteria.Predicate	in(jakarta.persistence.criteria.Expression<?>... values) Apply a predicate to test whether the expression is a member of the argument list.
jakarta.persistence.criteria.Predicate	in(jakarta.persistence.criteria.Expression<Collection<?>> values) Apply a predicate to test whether the expression is a member of the collection.
jakarta.persistence.criteria.Predicate	in(Object... values)
protected void	integrateRoot(RootImpl root) Used to use a root from a different query.
protected Expression	internalCorrelate(FromImpl from)
boolean	isCompoundExpression()
boolean	isCompoundSelection() Whether the selection item is a compound selection
boolean	isConstructor()
boolean	isExpression()
boolean	isFrom()
boolean	isJunction()
boolean	isLiteral()
jakarta.persistence.criteria.Predicate	isNotNull()
jakarta.persistence.criteria.Predicate	isNull()
boolean	isParameter()
boolean	isPredicate()
boolean	isRoot()
boolean	isSubquery()
jakarta.persistence.criteria.Subquery<T>	select(jakarta.persistence.criteria.Expression<T> selection) Specify the item that is to be returned in the query result.
jakarta.persistence.criteria.Subquery<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.Subquery<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.AbstractQueryImpl

findJoins, findRootAndParameters, from, from, getBaseExpression, getGroupList, getGroupRestriction, getRoots, isDistinct

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

findRootAndParameters, 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

from, from, getGroupList, getGroupRestriction, getResultType, getRoots, isDistinct

Methods inherited from interface jakarta.persistence.criteria.CommonAbstractCriteria

getRestriction, subquery

Field Detail

selection

protected SelectionImpl<?> selection

currentNode

protected SubSelectExpression currentNode

alias

protected String alias

subQuery

protected ReportQuery subQuery

correlatedJoins

protected Set<jakarta.persistence.criteria.Join<?,?>> correlatedJoins

parent

protected jakarta.persistence.criteria.CommonAbstractCriteria parent

processedJoins

protected Set<FromImpl> processedJoins

correlations

protected Set<Expression> correlations

Constructor Detail

SubQueryImpl

public SubQueryImpl(jakarta.persistence.metamodel.Metamodel metamodel,
                    Class result,
                    CriteriaBuilderImpl queryBuilder,
                    jakarta.persistence.criteria.CommonAbstractCriteria parent)

Method Detail

select

public jakarta.persistence.criteria.Subquery<T> select(jakarta.persistence.criteria.Expression<T> selection)

Specify the item that is to be returned in the query result. Replaces the previously specified selection, if any.

Specified by:

select in interface jakarta.persistence.criteria.Subquery<T>

Parameters:

selection - selection specifying the item that is to be returned in the query result

Returns:

the modified query

where

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

Specified by:

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

Overrides:

where in class AbstractQueryImpl<T>

Parameters:

restriction - a simple or compound boolean expression

Returns:

the modified query

where

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

Specified by:

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

Overrides:

where in class AbstractQueryImpl<T>

Parameters:

restrictions - zero or more restriction predicates

Returns:

the modified query

groupBy

public jakarta.persistence.criteria.Subquery<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. This method only overrides the return type of the corresponding AbstractQuery method.

Specified by:

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

Specified by:

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

Overrides:

groupBy in class AbstractQueryImpl<T>

Parameters:

grouping - zero or more grouping expressions

Returns:

the modified query

groupBy

public jakarta.persistence.criteria.Subquery<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. This method only overrides the return type of the corresponding AbstractQuery method.

Specified by:

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

Specified by:

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

Overrides:

groupBy in class AbstractQueryImpl<T>

Parameters:

grouping - zero or more grouping expressions

Returns:

the modified query

having

public jakarta.persistence.criteria.Subquery<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. This method only overrides the return type of the corresponding AbstractQuery method.

Specified by:

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

Specified by:

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

Overrides:

having in class AbstractQueryImpl<T>

Parameters:

restriction - a simple or compound boolean expression

Returns:

the modified query

having

public jakarta.persistence.criteria.Subquery<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. This method only overrides the return type of the corresponding AbstractQuery method.

Specified by:

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

Specified by:

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

Overrides:

having in class AbstractQueryImpl<T>

Parameters:

restrictions - zero or more restriction predicates

Returns:

the modified query

correlate

public <Y> jakarta.persistence.criteria.Root<Y> correlate(jakarta.persistence.criteria.Root<Y> parentRoot)

Correlates a root of the enclosing query to a root of the subquery and returns the subquery root.

Specified by:

correlate in interface jakarta.persistence.criteria.Subquery<T>

Parameters:

parentRoot - a root of the containing query

Returns:

subquery root

correlate

public <X,Y> jakarta.persistence.criteria.Join<X,Y> correlate(jakarta.persistence.criteria.Join<X,Y> parentJoin)

Correlates a join object of the enclosing query to a join object of the subquery and returns the subquery join object.

Specified by:

correlate in interface jakarta.persistence.criteria.Subquery<T>

Parameters:

parentJoin - join target of the containing query

Returns:

subquery join

correlate

public <X,Y> jakarta.persistence.criteria.CollectionJoin<X,Y> correlate(jakarta.persistence.criteria.CollectionJoin<X,Y> parentCollection)

Correlates a join to a Collection-valued association or element collection in the enclosing query to a join object of the subquery and returns the subquery join object.

Specified by:

correlate in interface jakarta.persistence.criteria.Subquery<T>

Parameters:

parentCollection - join target of the containing query

Returns:

subquery join

correlate

public <X,Y> jakarta.persistence.criteria.SetJoin<X,Y> correlate(jakarta.persistence.criteria.SetJoin<X,Y> parentSet)

Correlates a join to a Set-valued association or element collection in the enclosing query to a join object of the subquery and returns the subquery join object.

Specified by:

correlate in interface jakarta.persistence.criteria.Subquery<T>

Parameters:

parentSet - join target of the containing query

Returns:

subquery join

correlate

public <X,Y> jakarta.persistence.criteria.ListJoin<X,Y> correlate(jakarta.persistence.criteria.ListJoin<X,Y> parentList)

Correlates a join to a List-valued association or element collection in the enclosing query to a join object of the subquery and returns the subquery join object.

Specified by:

correlate in interface jakarta.persistence.criteria.Subquery<T>

Parameters:

parentList - join target of the containing query

Returns:

subquery join

correlate

public <X,K,V> jakarta.persistence.criteria.MapJoin<X,K,V> correlate(jakarta.persistence.criteria.MapJoin<X,K,V> parentMap)

Correlates a join to a Map-valued association or element collection in the enclosing query to a join object of the subquery and returns the subquery join object.

Specified by:

correlate in interface jakarta.persistence.criteria.Subquery<T>

Parameters:

parentMap - join target of the containing query

Returns:

subquery join

internalCorrelate

protected Expression internalCorrelate(FromImpl from)

getParameters

public Set<jakarta.persistence.criteria.ParameterExpression<?>> getParameters()

Description copied from class: CommonAbstractCriteriaImpl

Return the parameters of the query

Overrides:

getParameters in class CommonAbstractCriteriaImpl<T>

Returns:

the query parameters

getParent

public jakarta.persistence.criteria.AbstractQuery<?> getParent()

Return the query of which this is a subquery.

Specified by:

getParent in interface jakarta.persistence.criteria.Subquery<T>

Returns:

the enclosing query or subquery

distinct

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

Specified by:

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

Overrides:

distinct in class AbstractQueryImpl<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.

getCurrentNode

public Expression getCurrentNode()

Returns the current EclipseLink expression at this node in the criteria expression tree

Specified by:

getCurrentNode in interface InternalSelection

Returns:

the currentNode

getSelection

public jakarta.persistence.criteria.Expression<T> getSelection()

Return the selection item of the query. This will correspond to the query type.

Specified by:

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

Specified by:

getSelection in interface jakarta.persistence.criteria.Subquery<T>

Returns:

the selection item of the query

getCorrelatedJoins

public Set<jakarta.persistence.criteria.Join<?,?>> getCorrelatedJoins()

Return the joins that have been made from the subquery.

Specified by:

getCorrelatedJoins in interface jakarta.persistence.criteria.Subquery<T>

Returns:

joins made from this type

addParameter

public void addParameter(jakarta.persistence.criteria.ParameterExpression<?> parameter)

Overrides:

addParameter in class CommonAbstractCriteriaImpl<T>

addJoin

public void addJoin(FromImpl join)

Specified by:

addJoin in class AbstractQueryImpl<T>

as

public <X> jakarta.persistence.criteria.Expression<X> as(Class<X> type)

Specified by:

as in interface jakarta.persistence.criteria.Expression<T>

in

public jakarta.persistence.criteria.Predicate in(Object... values)

Specified by:

in in interface jakarta.persistence.criteria.Expression<T>

in

public jakarta.persistence.criteria.Predicate in(jakarta.persistence.criteria.Expression<?>... values)

Apply a predicate to test whether the expression is a member of the argument list.

Specified by:

in in interface jakarta.persistence.criteria.Expression<T>

Parameters:

values -

Returns:

predicate testing for membership

in

public jakarta.persistence.criteria.Predicate in(Collection<?> values)

Apply a predicate to test whether the expression is a member of the collection.

Specified by:

in in interface jakarta.persistence.criteria.Expression<T>

Parameters:

values - collection

Returns:

predicate testing for membership

in

public jakarta.persistence.criteria.Predicate in(jakarta.persistence.criteria.Expression<Collection<?>> values)

Apply a predicate to test whether the expression is a member of the collection.

Specified by:

in in interface jakarta.persistence.criteria.Expression<T>

Parameters:

values - expression corresponding to collection

Returns:

predicate testing for membership

isNotNull

public jakarta.persistence.criteria.Predicate isNotNull()

Specified by:

isNotNull in interface jakarta.persistence.criteria.Expression<T>

isNull

public jakarta.persistence.criteria.Predicate isNull()

Specified by:

isNull in interface jakarta.persistence.criteria.Expression<T>

alias

public jakarta.persistence.criteria.Selection<T> alias(String name)

Assign an alias to the selection.

Specified by:

alias in interface jakarta.persistence.criteria.Selection<T>

Parameters:

name - alias

getAlias

public String getAlias()

Specified by:

getAlias in interface jakarta.persistence.TupleElement<T>

getJavaType

public Class<T> getJavaType()

Specified by:

getJavaType in interface jakarta.persistence.TupleElement<T>

getCompoundSelectionItems

public List<jakarta.persistence.criteria.Selection<?>> getCompoundSelectionItems()

Return selection items composing a compound selection

Specified by:

getCompoundSelectionItems in interface jakarta.persistence.criteria.Selection<T>

Returns:

list of selection items

Throws:

IllegalStateException - if selection is not a compound selection

isCompoundSelection

public boolean isCompoundSelection()

Whether the selection item is a compound selection

Specified by:

isCompoundSelection in interface jakarta.persistence.criteria.Selection<T>

Returns:

boolean

isConstructor

public boolean isConstructor()

Specified by:

isConstructor in interface InternalSelection

isJunction

public boolean isJunction()

Specified by:

isJunction in interface InternalExpression

isPredicate

public boolean isPredicate()

Specified by:

isPredicate in interface InternalExpression

isParameter

public boolean isParameter()

Specified by:

isParameter in interface InternalExpression

isRoot

public boolean isRoot()

Specified by:

isRoot in interface InternalSelection

isSubquery

public boolean isSubquery()

Specified by:

isSubquery in interface InternalExpression

integrateRoot

protected void integrateRoot(RootImpl root)

Description copied from class: CommonAbstractCriteriaImpl

Used to use a root from a different query.

Overrides:

integrateRoot in class AbstractQueryImpl<T>

isCompoundExpression

public boolean isCompoundExpression()

Specified by:

isCompoundExpression in interface InternalExpression

isExpression

public boolean isExpression()

Specified by:

isExpression in interface InternalExpression

isFrom

public boolean isFrom()

Specified by:

isFrom in interface InternalSelection

isLiteral

public boolean isLiteral()

Specified by:

isLiteral in interface InternalExpression

findRootAndParameters

public void findRootAndParameters(CommonAbstractCriteriaImpl query)

Specified by:

findRootAndParameters in interface InternalSelection

getBaseExpression

protected Expression getBaseExpression()

Overrides:

getBaseExpression in class AbstractQueryImpl<T>

getContainingQuery

public jakarta.persistence.criteria.CommonAbstractCriteria getContainingQuery()

Specified by:

getContainingQuery in interface jakarta.persistence.criteria.Subquery<T>

getDatabaseQuery

public DatabaseQuery getDatabaseQuery()

Specified by:

getDatabaseQuery in class CommonAbstractCriteriaImpl<T>