Package org.hibernate.query.sqm.internal

Class SqmUtil

java.lang.Object

org.hibernate.query.sqm.internal.SqmUtil

public class SqmUtil
extends Object

Helper utilities for dealing with SQM

Author:

Steve Ebersole

Method Summary

Modifier and Type	Method	Description
static void	checkQueryReturnType(SqmQueryPart<?> queryPart, Class<?> expectedResultType)	Similar to validateQueryReturnType(SqmQueryPart, Class) but does not check if isResultTypeAlwaysAllowed(Class).
static JdbcParameterBindings	createJdbcParameterBindings(QueryParameterBindings domainParamBindings, DomainParameterXref domainParameterXref, Map<QueryParameterImplementor<?>,Map<SqmParameter<?>,List<JdbcParametersList>>> jdbcParamXref, MappingMetamodel domainModel, Function<NavigablePath,TableGroup> tableGroupLocator, SqmParameterMappingModelResolutionAccess mappingModelResolutionAccess, SharedSessionContractImplementor session)
static Bindable	determineParameterType(QueryParameterBinding<?> binding, QueryParameterImplementor<?> parameter, List<SqmParameter<?>> sqmParameters, SqmParameterMappingModelResolutionAccess mappingModelResolutionAccess, SessionFactoryImplementor sessionFactory)
static IllegalQueryOperationException	expectingNonSelect(SqmStatement<?> sqm, String hqlString)
static <T, A> SqmAttributeJoin<T,A>	findCompatibleFetchJoin(SqmFrom<?,T> sqmFrom, SqmPathSource<A> pathSource, SqmJoinType requestedJoinType)
static Map<QueryParameterImplementor<?>,Map<SqmParameter<?>,List<JdbcParametersList>>>	generateJdbcParamsXref(DomainParameterXref domainParameterXref, JdbcParameterBySqmParameterAccess jdbcParameterBySqmParameterAccess)
static List<NavigablePath>	getGroupByNavigablePaths(SqmQuerySpec<?> querySpec)
static List<NavigablePath>	getOrderByNavigablePaths(SqmQuerySpec<?> querySpec)
static ModelPartContainer	getTargetMappingIfNeeded(SqmPath<?> sqmPath, ModelPartContainer modelPartContainer, SqmToSqlAstConverter sqlAstCreationState)	Utility that returns the entity association target's mapping type if the specified sqmPath should be dereferenced using the target table, i.e. when the path's lhs is an explicit join that is used in the group by clause, or defaults to the provided modelPartContainer otherwise.
static List<NavigablePath>	getWhereClauseNavigablePaths(SqmQuerySpec<?> querySpec)
static boolean	isFkOptimizationAllowed(SqmPath<?> sqmPath)	Deprecated, for removal: This API element is subject to removal in a future version. Use isFkOptimizationAllowed(SqmPath, EntityAssociationMapping) instead
static boolean	isFkOptimizationAllowed(SqmPath<?> sqmPath, EntityAssociationMapping associationMapping)	Utility that returns false when the provided sqmPath is a join that cannot be dereferenced through the foreign key on the associated table, i.e. a join that's neither SqmJoinType.INNER nor SqmJoinType.LEFT or one that has an explicit on clause predicate.
static boolean	isHqlTuple(SqmSelection<?> selection)
static boolean	isMutation(SqmStatement<?> sqm)
static boolean	isResultTypeAlwaysAllowed(Class<?> expectedResultClass)
static boolean	isSelect(SqmStatement<?> sqm)
static boolean	isSelectionAssignableToResultType(SqmSelection<?> selection, Class<?> expectedResultType)
static Class<?>	resolveExpressibleJavaTypeClass(SqmExpression<?> expression)
static SqmStatement.ParameterResolutions	resolveParameters(SqmStatement<?> statement)
static void	validateQueryReturnType(SqmQueryPart<?> queryPart, @Nullable Class<?> expectedResultType)	Used to validate that the specified query return type is valid (i.e. the user did not pass Integer.class when the selection is an entity)
static void	verifyIsNonSelectStatement(SqmStatement<?> sqm, String hqlString)
static void	verifyIsSelectStatement(SqmStatement<?> sqm, String hqlString)
protected static void	verifyResultType(Class<?> resultClass, @Nullable SqmExpressible<?> selectionExpressible)

Methods inherited from class java.lang.Object

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

Method Details

isSelect

public static boolean isSelect(SqmStatement<?> sqm)

isMutation

public static boolean isMutation(SqmStatement<?> sqm)

verifyIsSelectStatement

public static void verifyIsSelectStatement(SqmStatement<?> sqm,
 String hqlString)

verifyIsNonSelectStatement

public static void verifyIsNonSelectStatement(SqmStatement<?> sqm,
 String hqlString)

expectingNonSelect

public static IllegalQueryOperationException expectingNonSelect(SqmStatement<?> sqm,
 String hqlString)

getTargetMappingIfNeeded

public static ModelPartContainer getTargetMappingIfNeeded(SqmPath<?> sqmPath,
 ModelPartContainer modelPartContainer,
 SqmToSqlAstConverter sqlAstCreationState)

Utility that returns the entity association target's mapping type if the specified sqmPath should be dereferenced using the target table, i.e. when the path's lhs is an explicit join that is used in the group by clause, or defaults to the provided modelPartContainer otherwise.

isFkOptimizationAllowed

@Deprecated(forRemoval=true,
            since="6.6.1")
public static boolean isFkOptimizationAllowed(SqmPath<?> sqmPath)

Deprecated, for removal: This API element is subject to removal in a future version.

Use isFkOptimizationAllowed(SqmPath, EntityAssociationMapping) instead

Utility that returns false when the provided sqmPath is a join that cannot be dereferenced through the foreign key on the associated table, i.e. a join that's neither SqmJoinType.INNER nor SqmJoinType.LEFT or one that has an explicit on clause predicate.

isFkOptimizationAllowed

public static boolean isFkOptimizationAllowed(SqmPath<?> sqmPath,
 EntityAssociationMapping associationMapping)

Utility that returns false when the provided sqmPath is a join that cannot be dereferenced through the foreign key on the associated table, i.e. a join that's neither SqmJoinType.INNER nor SqmJoinType.LEFT or one that has an explicit on clause predicate.

getWhereClauseNavigablePaths

public static List<NavigablePath> getWhereClauseNavigablePaths(SqmQuerySpec<?> querySpec)

getGroupByNavigablePaths

public static List<NavigablePath> getGroupByNavigablePaths(SqmQuerySpec<?> querySpec)

getOrderByNavigablePaths

public static List<NavigablePath> getOrderByNavigablePaths(SqmQuerySpec<?> querySpec)

findCompatibleFetchJoin

public static <T,
A> SqmAttributeJoin<T,A> findCompatibleFetchJoin(SqmFrom<?,T> sqmFrom,
 SqmPathSource<A> pathSource,
 SqmJoinType requestedJoinType)

generateJdbcParamsXref

public static Map<QueryParameterImplementor<?>,Map<SqmParameter<?>,List<JdbcParametersList>>> generateJdbcParamsXref(DomainParameterXref domainParameterXref,
 JdbcParameterBySqmParameterAccess jdbcParameterBySqmParameterAccess)

createJdbcParameterBindings

public static JdbcParameterBindings createJdbcParameterBindings(QueryParameterBindings domainParamBindings,
 DomainParameterXref domainParameterXref,
 Map<QueryParameterImplementor<?>,Map<SqmParameter<?>,List<JdbcParametersList>>> jdbcParamXref,
 MappingMetamodel domainModel,
 Function<NavigablePath,TableGroup> tableGroupLocator,
 SqmParameterMappingModelResolutionAccess mappingModelResolutionAccess,
 SharedSessionContractImplementor session)

determineParameterType

public static Bindable determineParameterType(QueryParameterBinding<?> binding,
 QueryParameterImplementor<?> parameter,
 List<SqmParameter<?>> sqmParameters,
 SqmParameterMappingModelResolutionAccess mappingModelResolutionAccess,
 SessionFactoryImplementor sessionFactory)

resolveParameters

public static SqmStatement.ParameterResolutions resolveParameters(SqmStatement<?> statement)

isSelectionAssignableToResultType

public static boolean isSelectionAssignableToResultType(SqmSelection<?> selection,
 Class<?> expectedResultType)

isHqlTuple

public static boolean isHqlTuple(SqmSelection<?> selection)

resolveExpressibleJavaTypeClass

public static Class<?> resolveExpressibleJavaTypeClass(SqmExpression<?> expression)

validateQueryReturnType

public static void validateQueryReturnType(SqmQueryPart<?> queryPart,
 @Nullable Class<?> expectedResultType)

Used to validate that the specified query return type is valid (i.e. the user did not pass Integer.class when the selection is an entity)

checkQueryReturnType

public static void checkQueryReturnType(SqmQueryPart<?> queryPart,
 Class<?> expectedResultType)

Similar to validateQueryReturnType(SqmQueryPart, Class) but does not check if isResultTypeAlwaysAllowed(Class).

isResultTypeAlwaysAllowed

public static boolean isResultTypeAlwaysAllowed(Class<?> expectedResultClass)

verifyResultType

protected static void verifyResultType(Class<?> resultClass,
 @Nullable SqmExpressible<?> selectionExpressible)