org.hibernate.loader.plan.exec.internal

Class AliasResolutionContextImpl

java.lang.Object

org.hibernate.loader.plan.exec.internal.AliasResolutionContextImpl

All Implemented Interfaces:

AliasResolutionContext

public class AliasResolutionContextImpl
extends Object
implements AliasResolutionContext

Provides aliases that are used by load queries and ResultSet processors.

Author:

Gail Badner, Steve Ebersole

Constructor Summary

Constructors

Constructor and Description
AliasResolutionContextImpl(SessionFactoryImplementor sessionFactory) Constructs a AliasResolutionContextImpl without any source aliases.
AliasResolutionContextImpl(SessionFactoryImplementor sessionFactory, int suffixSeed) Constructs a AliasResolutionContextImpl with the specified seed for unique alias suffixes.

Method Summary

Modifier and Type	Method and Description
void	dumpResolutions(LoadPlan loadPlan) USes its defined logger to generate a resolution report.
CollectionReferenceAliases	generateCollectionReferenceAliases(String collectionQuerySpaceUid, CollectionPersister persister, String elementQuerySpaceUid) Generate the collection reference aliases for a particular CollectionReference and register the generated value using the query space UID.
EntityReferenceAliases	generateEntityReferenceAliases(String uid, EntityPersister entityPersister) Generate the entity reference aliases for a particular EntityReference and register the generated value using the query space UID.
void	registerCompositeQuerySpaceUidResolution(String rightHandSideUid, String leftHandSideTableAlias)
CollectionReferenceAliases	resolveCollectionReferenceAliases(String querySpaceUid) Resolve the given QuerySpace UID to the CollectionReferenceAliases representing the SQL aliases used in building the SQL query.
EntityReferenceAliases	resolveEntityReferenceAliases(String querySpaceUid) Resolve the given QuerySpace UID to the EntityReferenceAliases representing the SQL aliases used in building the SQL query.
String	resolveSqlTableAliasFromQuerySpaceUid(String querySpaceUid)
protected SessionFactoryImplementor	sessionFactory()

Methods inherited from class java.lang.Object

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

Constructor Detail

AliasResolutionContextImpl

public AliasResolutionContextImpl(SessionFactoryImplementor sessionFactory)

Constructs a AliasResolutionContextImpl without any source aliases. This form is used in non-query contexts. Example of query contexts are: HQL, criteria, etc.

Parameters:

sessionFactory - The session factory

AliasResolutionContextImpl

public AliasResolutionContextImpl(SessionFactoryImplementor sessionFactory,
                                  int suffixSeed)

Constructs a AliasResolutionContextImpl with the specified seed for unique alias suffixes.

Parameters:

sessionFactory - The session factory

suffixSeed - The seed value to use for generating the suffix used when generating SQL aliases.

Method Detail

sessionFactory

protected SessionFactoryImplementor sessionFactory()

generateEntityReferenceAliases

public EntityReferenceAliases generateEntityReferenceAliases(String uid,
                                                             EntityPersister entityPersister)

Generate the entity reference aliases for a particular EntityReference and register the generated value using the query space UID.

Once generated, there are two methods that can be used to do look ups by the specified query space UID:

• resolveEntityReferenceAliases(String) can be used to look up the returned entity reference aliases;
• resolveSqlTableAliasFromQuerySpaceUid(String) can be used to look up SQL table alias.

Parameters:

uid - The query space UID for the entity reference.

entityPersister - The entity persister for entity reference.

Returns:

the generated entity reference aliases.

See Also:

EntityReference.getQuerySpaceUid(), EntityReference.getEntityPersister()

generateCollectionReferenceAliases

public CollectionReferenceAliases generateCollectionReferenceAliases(String collectionQuerySpaceUid,
                                                                     CollectionPersister persister,
                                                                     String elementQuerySpaceUid)

Generate the collection reference aliases for a particular CollectionReference and register the generated value using the query space UID.

Once generated, there are two methods that can be used to do look ups by the specified query space UID:

• ##resolveCollectionReferenceAliases(String) can be used to look up the returned collection reference aliases;
• resolveSqlTableAliasFromQuerySpaceUid(String) can be used to look up the SQL collection table alias.

Parameters:

collectionQuerySpaceUid - The query space UID for the collection reference.

persister - The collection persister for collection reference.

elementQuerySpaceUid - The query space UID for the collection element if the element is an entity type; null, otherwise.

Returns:

the generated collection reference aliases.

Throws:

IllegalArgumentException - if the collection element is an entity type and elementQuerySpaceUid is null.

See Also:

CollectionReference.getQuerySpaceUid(), CollectionReference.getCollectionPersister()

resolveSqlTableAliasFromQuerySpaceUid

public String resolveSqlTableAliasFromQuerySpaceUid(String querySpaceUid)

Specified by:

resolveSqlTableAliasFromQuerySpaceUid in interface AliasResolutionContext

resolveEntityReferenceAliases

public EntityReferenceAliases resolveEntityReferenceAliases(String querySpaceUid)

Description copied from interface: AliasResolutionContext

Resolve the given QuerySpace UID to the EntityReferenceAliases representing the SQL aliases used in building the SQL query.

Assumes that a QuerySpace has already been registered. As such this method simply returns null if no QuerySpace with that UID has yet been resolved in the context.

Specified by:

resolveEntityReferenceAliases in interface AliasResolutionContext

Parameters:

querySpaceUid - The QuerySpace UID whose EntityReferenceAliases we want to look up.

Returns:

The corresponding QuerySpace UID, or null.

resolveCollectionReferenceAliases

public CollectionReferenceAliases resolveCollectionReferenceAliases(String querySpaceUid)

Description copied from interface: AliasResolutionContext

Resolve the given QuerySpace UID to the CollectionReferenceAliases representing the SQL aliases used in building the SQL query.

Assumes that a QuerySpace has already been registered. As such this method simply returns null if no QuerySpace with that UID has yet been resolved in the context.

Specified by:

resolveCollectionReferenceAliases in interface AliasResolutionContext

Parameters:

querySpaceUid - The QuerySpace UID whose CollectionReferenceAliases we want to look up.

Returns:

The corresponding QuerySpace UID, or null.

registerCompositeQuerySpaceUidResolution

public void registerCompositeQuerySpaceUidResolution(String rightHandSideUid,
                                                     String leftHandSideTableAlias)

dumpResolutions

public void dumpResolutions(LoadPlan loadPlan)

USes its defined logger to generate a resolution report.

Parameters:

loadPlan - The loadplan that was processed.