http://hibernate.org: Hibernate's core ORM functionality (Hibernate.org) 
/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
 * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
 */
package org.hibernate.loader.plan.build.internal;

import org.hibernate.HibernateException;
import org.hibernate.LockMode;
import org.hibernate.engine.FetchStrategy;
import org.hibernate.engine.FetchStyle;
import org.hibernate.engine.FetchTiming;
import org.hibernate.engine.spi.LoadQueryInfluencers;
import org.hibernate.engine.spi.SessionFactoryImplementor;
import org.hibernate.internal.CoreLogging;
import org.hibernate.loader.plan.spi.CollectionReturn;
import org.hibernate.loader.plan.spi.EntityReturn;
import org.hibernate.loader.plan.spi.LoadPlan;
import org.hibernate.loader.plan.spi.Return;
import org.hibernate.persister.walking.spi.AssociationAttributeDefinition;
import org.hibernate.persister.walking.spi.EncapsulatedEntityIdentifierDefinition;
import org.hibernate.persister.walking.spi.EntityIdentifierDefinition;
import org.hibernate.persister.walking.spi.NonEncapsulatedEntityIdentifierDefinition;
import org.hibernate.persister.walking.spi.WalkingException;

import org.jboss.logging.Logger;


LoadPlanBuildingAssociationVisitationStrategy implementation used for building LoadPlans based on metamodel-defined fetching. Built LoadPlans contain a single root return object, either an EntityReturn or a CollectionReturn. 
Author:Steve Ebersole
/**
 * LoadPlanBuildingAssociationVisitationStrategy implementation used for building LoadPlans based on metamodel-defined fetching.  Built
 * LoadPlans contain a single root return object, either an {@link EntityReturn} or a {@link CollectionReturn}.
 *
 * @author Steve Ebersole
 */
public class FetchStyleLoadPlanBuildingAssociationVisitationStrategy
		extends AbstractLoadPlanBuildingAssociationVisitationStrategy {
	private static final Logger log = CoreLogging.logger( FetchStyleLoadPlanBuildingAssociationVisitationStrategy.class );

	private final LoadQueryInfluencers loadQueryInfluencers;
	private final LockMode lockMode;

	private Return rootReturn;

	// flag that indicates whether executing handleAssociationAttribute() should be vetoed;
	private boolean vetoHandleAssociationAttribute;

	
Constructs a FetchStyleLoadPlanBuildingAssociationVisitationStrategy.

Params:
  • sessionFactory – The session factory
  • loadQueryInfluencers – The options which can influence the SQL query needed to perform the load.
  • lockMode – The lock mode.
/**
	 * Constructs a FetchStyleLoadPlanBuildingAssociationVisitationStrategy.
	 *
	 * @param sessionFactory The session factory
	 * @param loadQueryInfluencers The options which can influence the SQL query needed to perform the load.
	 * @param lockMode The lock mode.
	 */
	public FetchStyleLoadPlanBuildingAssociationVisitationStrategy(
			SessionFactoryImplementor sessionFactory,
			LoadQueryInfluencers loadQueryInfluencers,
			LockMode lockMode) {
		super( sessionFactory );
		this.loadQueryInfluencers = loadQueryInfluencers;
		this.lockMode = lockMode;
	}

	@Override
	protected boolean supportsRootEntityReturns() {
		return true;
	}

	@Override
	protected boolean supportsRootCollectionReturns() {
		return true;
	}

	@Override
	protected void addRootReturn(Return rootReturn) {
		if ( this.rootReturn != null ) {
			throw new HibernateException( "Root return already identified" );
		}
		this.rootReturn = rootReturn;
	}

	@Override
	public void startingEntityIdentifier(EntityIdentifierDefinition identifierDefinition ) {
		if ( vetoHandleAssociationAttribute ) {
			throw new WalkingException( "vetoHandleAssociationAttribute is true when starting startingEntityIdentifier()" );
		}
		vetoHandleAssociationAttribute = shouldVetoHandleAssociationAttributeInId(
				rootReturn,
				identifierDefinition
		);
		super.startingEntityIdentifier( identifierDefinition );
	}

	@Override
	public void finishingEntityIdentifier(EntityIdentifierDefinition identifierDefinition) {
		super.finishingEntityIdentifier( identifierDefinition );
		if ( vetoHandleAssociationAttribute !=
				shouldVetoHandleAssociationAttributeInId( rootReturn, identifierDefinition ) ) {
			throw new WalkingException(
					"vetoHandleAssociationAttribute has unexpected value: " + vetoHandleAssociationAttribute
			);
		}
		vetoHandleAssociationAttribute = false;
	}

	private static boolean shouldVetoHandleAssociationAttributeInId(
			Return rootReturn,
			EntityIdentifierDefinition identifierDefinition) {
		// only check the identifierDefinition for a root EntityReturn.
		if ( EntityReturn.class.isInstance( rootReturn ) ) {
			final EntityIdentifierDefinition rootEntityIdentifierDefinition =
					( (EntityReturn) rootReturn ).getEntityPersister().getEntityKeyDefinition();
			if ( rootEntityIdentifierDefinition == identifierDefinition ) {
				// There are 2 cases where an association in an ID should not be "handled":
				// 1) a composite, encapsulated ID (e.g., @EmbeddedId). In this case, the ID is provided
				//    by the application by Session#get or EntityManager#find. Hibernate uses the
				//    provided ID "as is".
				// 2) a non-encapsulated ID without an @IdClass. In this case, the application provides
				//    an instance of the entity with the ID properties initialized. Hibernate uses
				//    the provided ID properties "as is".
				// In these two cases, it is important that associations in the ID not be "handled"
				// (i.e, joined); doing so can result in unexpected results.
				if ( rootEntityIdentifierDefinition.isEncapsulated() ) {
					final EncapsulatedEntityIdentifierDefinition encapsulated =
							(EncapsulatedEntityIdentifierDefinition ) rootEntityIdentifierDefinition;
					if ( encapsulated.getAttributeDefinition().getType().isComponentType() ) {
						// This is 1) (@EmbeddedId).
						return true;
					}
				}
				else {
					final NonEncapsulatedEntityIdentifierDefinition nonEncapsulated =
							(NonEncapsulatedEntityIdentifierDefinition) rootEntityIdentifierDefinition;
					if ( nonEncapsulated.getSeparateIdentifierMappingClass() == null ) {
						// This is 2) (a non-encapsulated ID without an @IdClass)
						return true;
					}
				}
			}
		}
		return false;
	}

	@Override
	protected boolean handleAssociationAttribute(AssociationAttributeDefinition attributeDefinition) {
		return !vetoHandleAssociationAttribute && super.handleAssociationAttribute( attributeDefinition );
	}

	@Override
	public LoadPlan buildLoadPlan() {
		log.debug( "Building LoadPlan..." );

		if ( EntityReturn.class.isInstance( rootReturn ) ) {
			return new LoadPlanImpl( (EntityReturn) rootReturn, getQuerySpaces() );
		}
		else if ( CollectionReturn.class.isInstance( rootReturn ) ) {
			return new LoadPlanImpl( (CollectionReturn) rootReturn, getQuerySpaces() );
		}
		else {
			throw new IllegalStateException( "Unexpected root Return type : " + rootReturn );
		}
	}

	@Override
	protected FetchStrategy determineFetchStrategy(AssociationAttributeDefinition attributeDefinition) {
		FetchStrategy fetchStrategy = attributeDefinition.determineFetchPlan( loadQueryInfluencers, currentPropertyPath );
		if ( fetchStrategy.getTiming() == FetchTiming.IMMEDIATE && fetchStrategy.getStyle() == FetchStyle.JOIN ) {
			// see if we need to alter the join fetch to another form for any reason
			fetchStrategy = adjustJoinFetchIfNeeded( attributeDefinition, fetchStrategy );
		}
		return fetchStrategy;
	}

	
If required by this strategy, returns a different FetchStrategy from what is specified for the given association attribute. 
Params:
  • attributeDefinition – The association attribute definition.
  • fetchStrategy – The fetch strategy for attributeDefinition.
Returns:the FetchStrategy, possibly adjusted by this strategy.
/**
	 * If required by this strategy, returns a different {@link FetchStrategy} from what is specified
	 * for the given association attribute.
	 *
	 * @param attributeDefinition The association attribute definition.
	 * @param fetchStrategy The fetch strategy for <code>attributeDefinition</code>.
	 * @return the {@link FetchStrategy}, possibly adjusted by this strategy.
	 */
	protected FetchStrategy adjustJoinFetchIfNeeded(
			AssociationAttributeDefinition attributeDefinition,
			FetchStrategy fetchStrategy) {
		if ( lockMode.greaterThan( LockMode.READ ) ) {
			return new FetchStrategy( fetchStrategy.getTiming(), FetchStyle.SELECT );
		}

		final Integer maxFetchDepth = sessionFactory().getSessionFactoryOptions().getMaximumFetchDepth();
		if ( maxFetchDepth != null && currentDepth() > maxFetchDepth ) {
			return new FetchStrategy( fetchStrategy.getTiming(), FetchStyle.SELECT );
		}

		if ( attributeDefinition.getType().isCollectionType() && isTooManyCollections() ) {
			// todo : have this revert to batch or subselect fetching once "sql gen redesign" is in place
			return new FetchStrategy( fetchStrategy.getTiming(), FetchStyle.SELECT );
		}

		return fetchStrategy;
	}

	@Override
	protected boolean isTooManyCollections() {
		return CollectionReturn.class.isInstance( rootReturn );
	}
}