Package org.hibernate.bytecode.spi

Interface BytecodeEnhancementMetadata

public interface BytecodeEnhancementMetadata

Encapsulates bytecode enhancement information about a particular entity.

Method Summary

Modifier and Type	Method	Description
PersistentAttributeInterceptable	createEnhancedProxy(EntityKey keyToLoad, boolean addEmptyEntry, SharedSessionContractImplementor session)	Create an "enhancement as proxy" instance for the given entity
@Nullable LazyAttributeLoadingInterceptor	extractInterceptor(Object entity)	Extract the field interceptor instance from the enhanced entity.
@Nullable BytecodeLazyAttributeInterceptor	extractLazyInterceptor(Object entity)
String	getEntityName()	The name of the entity to which this metadata applies.
LazyAttributesMetadata	getLazyAttributesMetadata()
boolean	hasUnFetchedAttributes(Object entity)
void	injectEnhancedEntityAsProxyInterceptor(Object entity, EntityKey entityKey, SharedSessionContractImplementor session)
LazyAttributeLoadingInterceptor	injectInterceptor(Object entity, Object identifier, SharedSessionContractImplementor session)	Build and inject an interceptor instance into the enhanced entity.
void	injectInterceptor(Object entity, PersistentAttributeInterceptor interceptor, SharedSessionContractImplementor session)
boolean	isAttributeLoaded(Object entity, String attributeName)
boolean	isEnhancedForLazyLoading()	Has the entity class been bytecode enhanced for lazy loading?

Method Detail

getEntityName

String getEntityName()

The name of the entity to which this metadata applies.

Returns:

The entity name

isEnhancedForLazyLoading

boolean isEnhancedForLazyLoading()

Has the entity class been bytecode enhanced for lazy loading?

Returns:

true indicates the entity class is enhanced for Hibernate use in lazy loading; false indicates it is not

getLazyAttributesMetadata

LazyAttributesMetadata getLazyAttributesMetadata()

createEnhancedProxy

PersistentAttributeInterceptable createEnhancedProxy(EntityKey keyToLoad,
                                                     boolean addEmptyEntry,
                                                     SharedSessionContractImplementor session)

Create an "enhancement as proxy" instance for the given entity

API Note:

The `addEmptyEntry` parameter is used to avoid creation of `EntityEntry` instances when we do not need them. - mainly from StatelessSession

injectInterceptor

LazyAttributeLoadingInterceptor injectInterceptor(Object entity,
                                                  Object identifier,
                                                  SharedSessionContractImplementor session)
                                           throws NotInstrumentedException

Build and inject an interceptor instance into the enhanced entity.

Parameters:

entity - The entity into which built interceptor should be injected

identifier -

session - The session to which the entity instance belongs.

Returns:

The built and injected interceptor

Throws:

NotInstrumentedException - Thrown if isEnhancedForLazyLoading() returns false

injectInterceptor

void injectInterceptor(Object entity,
                       PersistentAttributeInterceptor interceptor,
                       SharedSessionContractImplementor session)

injectEnhancedEntityAsProxyInterceptor

void injectEnhancedEntityAsProxyInterceptor(Object entity,
                                            EntityKey entityKey,
                                            SharedSessionContractImplementor session)

extractInterceptor

@Nullable LazyAttributeLoadingInterceptor extractInterceptor(Object entity)
                                                      throws NotInstrumentedException

Extract the field interceptor instance from the enhanced entity.

Parameters:

entity - The entity from which to extract the interceptor

Returns:

The extracted interceptor

Throws:

NotInstrumentedException - Thrown if isEnhancedForLazyLoading() returns false

extractLazyInterceptor

@Nullable BytecodeLazyAttributeInterceptor extractLazyInterceptor(Object entity)
                                                           throws NotInstrumentedException

Throws:

NotInstrumentedException

hasUnFetchedAttributes

boolean hasUnFetchedAttributes(Object entity)

isAttributeLoaded

boolean isAttributeLoaded(Object entity,
                          String attributeName)