程序包 org.hibernate.engine.internal

类 TwoPhaseLoad

java.lang.Object

org.hibernate.engine.internal.TwoPhaseLoad

public final class TwoPhaseLoad
extends Object

Functionality relating to the Hibernate two-phase loading process, that may be reused by persisters that do not use the Loader framework

作者:

Gavin King

方法概要

修饰符和类型	方法	说明
static void	addUninitializedCachedEntity(EntityKey key, Object object, EntityPersister persister, LockMode lockMode, Object version, SharedSessionContractImplementor session)	Same as addUninitializedEntity(org.hibernate.engine.spi.EntityKey, java.lang.Object, org.hibernate.persister.entity.EntityPersister, org.hibernate.LockMode, org.hibernate.engine.spi.SharedSessionContractImplementor), but here for an entity from the second level cache
static void	addUninitializedEntity(EntityKey key, Object object, EntityPersister persister, LockMode lockMode, SharedSessionContractImplementor session)	Add an uninitialized instance of an entity class, as a placeholder to ensure object identity.
static void	afterInitialize(Object entity, SharedSessionContractImplementor session)	Perform the afterInitialize() step.
static void	initializeEntity(Object entity, boolean readOnly, SharedSessionContractImplementor session, PreLoadEvent preLoadEvent)	已过时。 This method will be removed.
static void	initializeEntity(Object entity, boolean readOnly, SharedSessionContractImplementor session, PreLoadEvent preLoadEvent, Iterable<PreLoadEventListener> preLoadEventListeners)	Perform the second step of 2-phase load.
static void	postHydrate(EntityPersister persister, Serializable id, Object[] values, Object rowId, Object object, LockMode lockMode, SharedSessionContractImplementor session)	Register the "hydrated" state of an entity instance, after the first step of 2-phase loading.
static void	postLoad(Object entity, SharedSessionContractImplementor session, PostLoadEvent postLoadEvent)	已过时。 Use postLoad(Object, SharedSessionContractImplementor, PostLoadEvent, Iterable) instead.
static void	postLoad(Object entity, SharedSessionContractImplementor session, PostLoadEvent postLoadEvent, Iterable<PostLoadEventListener> postLoadEventListeners)	PostLoad cannot occur during initializeEntity, as that call occurs *before* the Set collections are added to the persistence context by Loader.

从类继承的方法 java.lang.Object

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

方法详细资料

postHydrate

public static void postHydrate(EntityPersister persister,
                               Serializable id,
                               Object[] values,
                               Object rowId,
                               Object object,
                               LockMode lockMode,
                               SharedSessionContractImplementor session)

Register the "hydrated" state of an entity instance, after the first step of 2-phase loading. Add the "hydrated state" (an array) of an uninitialized entity to the session. We don't try to resolve any associations yet, because there might be other entities waiting to be read from the JDBC result set we are currently processing

参数:

persister - The persister for the hydrated entity

id - The entity identifier

values - The entity values

rowId - The rowId for the entity

object - An optional instance for the entity being loaded

lockMode - The lock mode

session - The Session

initializeEntity

@Deprecated
public static void initializeEntity(Object entity,
                                    boolean readOnly,
                                    SharedSessionContractImplementor session,
                                    PreLoadEvent preLoadEvent)

已过时。

This method will be removed. Use initializeEntity(Object, boolean, SharedSessionContractImplementor, PreLoadEvent, Iterable) instead.

参数:

entity - The entity being loaded

readOnly - Is the entity being loaded as read-only

session - The Session

preLoadEvent - The (re-used) pre-load event

initializeEntity

public static void initializeEntity(Object entity,
                                    boolean readOnly,
                                    SharedSessionContractImplementor session,
                                    PreLoadEvent preLoadEvent,
                                    Iterable<PreLoadEventListener> preLoadEventListeners)

Perform the second step of 2-phase load. Fully initialize the entity instance.

After processing a JDBC result set, we "resolve" all the associations between the entities which were instantiated and had their state "hydrated" into an array

参数:

entity - The entity being loaded

readOnly - Is the entity being loaded as read-only

session - The Session

preLoadEvent - The (re-used) pre-load event

preLoadEventListeners - the pre-load event listeners

afterInitialize

public static void afterInitialize(Object entity,
                                   SharedSessionContractImplementor session)

Perform the afterInitialize() step. This needs to be done after the collections have been properly initialized thus a separate step.

参数:

entity - The entity being loaded

session - The Session

postLoad

public static void postLoad(Object entity,
                            SharedSessionContractImplementor session,
                            PostLoadEvent postLoadEvent,
                            Iterable<PostLoadEventListener> postLoadEventListeners)

PostLoad cannot occur during initializeEntity, as that call occurs *before* the Set collections are added to the persistence context by Loader. Without the split, LazyInitializationExceptions can occur in the Entity's postLoad if it acts upon the collection. HHH-6043

参数:

entity - The entity

session - The Session

postLoadEvent - The (re-used) post-load event

postLoad

@Deprecated
public static void postLoad(Object entity,
                            SharedSessionContractImplementor session,
                            PostLoadEvent postLoadEvent)

已过时。

Use postLoad(Object, SharedSessionContractImplementor, PostLoadEvent, Iterable) instead.

This method will be removed.

addUninitializedEntity

public static void addUninitializedEntity(EntityKey key,
                                          Object object,
                                          EntityPersister persister,
                                          LockMode lockMode,
                                          SharedSessionContractImplementor session)

Add an uninitialized instance of an entity class, as a placeholder to ensure object identity. Must be called before postHydrate(). Create a "temporary" entry for a newly instantiated entity. The entity is uninitialized, but we need the mapping from id to instance in order to guarantee uniqueness.

参数:

key - The entity key

object - The entity instance

persister - The entity persister

lockMode - The lock mode

session - The Session

addUninitializedCachedEntity

public static void addUninitializedCachedEntity(EntityKey key,
                                                Object object,
                                                EntityPersister persister,
                                                LockMode lockMode,
                                                Object version,
                                                SharedSessionContractImplementor session)

Same as addUninitializedEntity(org.hibernate.engine.spi.EntityKey, java.lang.Object, org.hibernate.persister.entity.EntityPersister, org.hibernate.LockMode, org.hibernate.engine.spi.SharedSessionContractImplementor), but here for an entity from the second level cache

参数:

key - The entity key

object - The entity instance

persister - The entity persister

lockMode - The lock mode

version - The version

session - The Session