Hibernate Core 3.6.10.Final · org.hibernate.tuple.entity.EntityTuplizer

Method Summary

Modifier and Type	Method and Description
public void	afterInitialize(Object The entity being initialized. entity, boolean Are defined lazy properties currently unfecthed lazyPropertiesAreUnfetched, SessionImplementor The session initializing this entity. session) Called just after the entities properties have been initialized.
public Object	Returns: The generate proxies. createProxy(Serializable The id of the instance for which to generate a proxy. id, SessionImplementor The session to which the proxy should be bound. session) Generates an appropriate proxy representation of this entity for this entity-mode.
public String	Returns: The most appropriate entity name to use. determineConcreteSubclassEntityName(Object The entity instance. entityInstance, SessionFactoryImplementor Reference to the SessionFactory. factory) Given an entity instance, determine the most appropriate (most targeted) entity-name which represents it.
public Class<T>	Returns: The java class to which generated proxies will be typed getConcreteProxyClass() Returns the java class to which generated proxies will be typed.
public EntityMode	Returns: The entity-mode getEntityMode() Return the entity-mode handled by this tuplizer instance.
public EntityNameResolver[]	Returns: The associated resolvers. May be null or empty. getEntityNameResolvers() Get any `EntityNameResolvers` associated with this `Tuplizer`.
public Serializable	Returns: The identifier value. getIdentifier(Object The entity from which to extract the identifier value. entity) Deprecated Use `getIdentifier(Object, SessionImplementor)` instead. Extract the identifier value from the given entity.
public Serializable	Returns: The identifier value. getIdentifier(Object The entity from which to extract the identifier value. entity, SessionImplementor The session from which is requests originates session) Extract the identifier value from the given entity.
public Getter	Returns: The getter for the identifier property. getIdentifierGetter() Retrieve the getter for the identifier property.
public Object	Returns: The current value of the given property on the given entity. getPropertyValue(Object The entity from which to extract the property value. entity, String The name of the property for which to extract the value. propertyName) Extract the value of a particular property from the given entity.
public Object[]	Returns: The insertable property values. getPropertyValuesToInsert(Object The entity from which to extract. entity, Map<K, V> a map of instances being merged to merged instances mergeMap, SessionImplementor The session in which the resuest is being made. session) Extract the values of the insertable properties of the entity (including backrefs)
public Object	Returns: The value of the version property, or null if not versioned. getVersion(Object The entity from which to extract the version value. entity) Extract the value of the version property from the given entity.
public Getter	Returns: The getter for the version property. getVersionGetter() Retrieve the getter for the version property.
public boolean	Returns: True if this tuplizer can generate proxies for this entity. hasProxy() Does this entity, for this mode, present a possibility for proxying?
public boolean	Returns: True if uninitialized lazy properties were found; false otherwise. hasUninitializedLazyProperties(Object The entity to be check for uninitialized lazy properties. entity) Does the given entity instance have any currently uninitialized lazy properties?
public Object	Returns: The instantiated entity. instantiate(Serializable The identifier value for the entity to be instantiated. id) Deprecated Use `instantiate(Serializable, SessionImplementor)` instead. Create an entity instance initialized with the given identifier.
public Object	Returns: The instantiated entity. instantiate(Serializable The identifier value for the entity to be instantiated. id, SessionImplementor The session from which is requests originates session) Create an entity instance initialized with the given identifier.
public boolean	isInstrumented() Is it an instrumented POJO?
public boolean	Returns: True if the Lifecycle interface is implemented; false otherwise. isLifecycleImplementor() Does the `class` managed by this tuplizer implement the `org.hibernate.classic.Lifecycle` interface.
public boolean	Returns: True if the Validatable interface is implemented; false otherwise. isValidatableImplementor() Does the `class` managed by this tuplizer implement the `org.hibernate.classic.Validatable` interface.
public void	resetIdentifier(Object The entity for which to reset the id/version values entity, Serializable The identifier value to inject into the entity. currentId, Object The version value to inject into the entity. currentVersion) Deprecated Use `resetIdentifier(Object, Serializable, Object, SessionImplementor)` instead Inject the given identifier and version into the entity, in order to "roll back" to their original values.
public void	resetIdentifier(Object The entity for which to reset the id/version values entity, Serializable The identifier value to inject into the entity. currentId, Object The version value to inject into the entity. currentVersion, SessionImplementor The session from which the request originated session) Inject the given identifier and version into the entity, in order to "roll back" to their original values.
public void	setIdentifier(Object The entity to inject with the identifier value. entity, Serializable The value to be injected as the identifier. id) Deprecated Use `setIdentifier(Object, Serializable, SessionImplementor)` instead. Inject the identifier value into the given entity.
public void	setIdentifier(Object The entity to inject with the identifier value. entity, Serializable The value to be injected as the identifier. id, SessionImplementor The session from which is requests originates session) Inject the identifier value into the given entity.
public void	setPropertyValue(Object The entity into which to inject the value. entity, int The property's index. i, Object The property value to inject. value) Inject the value of a particular property.
public void	setPropertyValue(Object The entity into which to inject the value. entity, String The name of the property. propertyName, Object The property value to inject. value) Inject the value of a particular property.

Inherited from org.hibernate.tuple.Tuplizer:: getGetter getMappedClass getPropertyValue getPropertyValues instantiate isInstance setPropertyValues

Method Detail

afterInitialize	back to summary
public void afterInitialize(Object entity, boolean lazyPropertiesAreUnfetched, SessionImplementor session) Called just after the entities properties have been initialized. Parameters entity:Object The entity being initialized. lazyPropertiesAreUnfetched:boolean Are defined lazy properties currently unfecthed session:SessionImplementor The session initializing this entity.

afterInitialize

back to summary

public void afterInitialize(Object entity, boolean lazyPropertiesAreUnfetched, SessionImplementor session)

Called just after the entities properties have been initialized.

Parameters

entity:Object: The entity being initialized.
lazyPropertiesAreUnfetched:boolean: Are defined lazy properties currently unfecthed
session:SessionImplementor: The session initializing this entity.

createProxy	back to summary
public Object createProxy(Serializable id, SessionImplementor session) throws HibernateException Generates an appropriate proxy representation of this entity for this entity-mode. Parameters id:Serializable The id of the instance for which to generate a proxy. session:SessionImplementor The session to which the proxy should be bound. Returns:Object The generate proxies. Exceptions HibernateException: Indicates an error generating the proxy.

createProxy

back to summary

public Object createProxy(Serializable id, SessionImplementor session) throws HibernateException

Generates an appropriate proxy representation of this entity for this entity-mode.

Parameters

id:Serializable: The id of the instance for which to generate a proxy.
session:SessionImplementor: The session to which the proxy should be bound.

Returns:Object

The generate proxies.

Exceptions

HibernateException:: Indicates an error generating the proxy.

determineConcreteSubclassEntityName back to summary

determineConcreteSubclassEntityName	back to summary
public String determineConcreteSubclassEntityName(Object entityInstance, SessionFactoryImplementor factory) Given an entity instance, determine the most appropriate (most targeted) entity-name which represents it. This is called in situations where we already know an entity name for the given entityInstance; we are being asked to determine if there is a more appropriate entity-name to use, specifically within an inheritence hierarchy. For example, consider a case where a user calls `session.update( "Animal", cat );`. Here, the user has explicitly provided `Animal` as the entity-name. However, they have passed in an instance of `Cat` which is a subclass of `Animal`. In this case, we would return `Cat` as the entity-name. `null` may be returned from calls to this method. The meaining of `null` in that case is assumed to be that we should use whatever explicit entity-name the user provided (`Animal` rather than `Cat` in the example above). Parameters entityInstance:Object The entity instance. factory:SessionFactoryImplementor Reference to the SessionFactory. Returns:String The most appropriate entity name to use. Exceptions HibernateException: If we are unable to determine an entity-name within the inheritence hierarchy.

public String determineConcreteSubclassEntityName(Object entityInstance, SessionFactoryImplementor factory)

Given an entity instance, determine the most appropriate (most targeted) entity-name which represents it. This is called in situations where we already know an entity name for the given entityInstance; we are being asked to determine if there is a more appropriate entity-name to use, specifically within an inheritence hierarchy.

For example, consider a case where a user calls session.update( "Animal", cat );. Here, the user has explicitly provided Animal as the entity-name. However, they have passed in an instance of Cat which is a subclass of Animal. In this case, we would return Cat as the entity-name.

null may be returned from calls to this method. The meaining of null in that case is assumed to be that we should use whatever explicit entity-name the user provided (Animal rather than Cat in the example above).

Parameters

entityInstance:Object: The entity instance.
factory:SessionFactoryImplementor: Reference to the SessionFactory.

Returns:String

The most appropriate entity name to use.

Exceptions

HibernateException:: If we are unable to determine an entity-name within the inheritence hierarchy.

getConcreteProxyClass back to summary

getConcreteProxyClass	back to summary
public Class<T> getConcreteProxyClass() Returns the java class to which generated proxies will be typed. todo : look at fully encapsulating `org.hibernate.engine.PersistenceContext#narrowProxy` here, since that is the only external use of this method Returns:Class<T> The java class to which generated proxies will be typed

public Class<T> getConcreteProxyClass()

Returns the java class to which generated proxies will be typed.

todo : look at fully encapsulating org.hibernate.engine.PersistenceContext#narrowProxy here, since that is the only external use of this method

Returns:Class<T>: The java class to which generated proxies will be typed

getEntityMode	back to summary
public EntityMode getEntityMode() Return the entity-mode handled by this tuplizer instance. Returns:EntityMode The entity-mode

getEntityMode

back to summary

public EntityMode getEntityMode()

Return the entity-mode handled by this tuplizer instance.

Returns:EntityMode: The entity-mode

getEntityNameResolvers back to summary

getEntityNameResolvers	back to summary
public EntityNameResolver[] getEntityNameResolvers() Get any `EntityNameResolvers` associated with this `Tuplizer`. Returns:EntityNameResolver[] The associated resolvers. May be null or empty.

public EntityNameResolver[] getEntityNameResolvers()

Get any EntityNameResolvers associated with this Tuplizer.

Returns:EntityNameResolver[]: The associated resolvers. May be null or empty.

getIdentifier back to summary

getIdentifier	back to summary
public Serializable getIdentifier(Object entity) throws HibernateException Deprecated Use `getIdentifier(Object, SessionImplementor)` instead. Extract the identifier value from the given entity. Parameters entity:Object The entity from which to extract the identifier value. Returns:Serializable The identifier value. Exceptions HibernateException: If the entity does not define an identifier property, or an error occurs accessing its value.

public Serializable getIdentifier(Object entity) throws HibernateException

Deprecated

Use getIdentifier(Object, SessionImplementor) instead.

Extract the identifier value from the given entity.

Parameters

entity:Object: The entity from which to extract the identifier value.

Returns:Serializable

The identifier value.

Exceptions

HibernateException:: If the entity does not define an identifier property, or an error occurs accessing its value.

getIdentifier	back to summary
public Serializable getIdentifier(Object entity, SessionImplementor session) Extract the identifier value from the given entity. Parameters entity:Object The entity from which to extract the identifier value. session:SessionImplementor The session from which is requests originates Returns:Serializable The identifier value.

getIdentifier

back to summary

public Serializable getIdentifier(Object entity, SessionImplementor session)

Extract the identifier value from the given entity.

Parameters

entity:Object: The entity from which to extract the identifier value.
session:SessionImplementor: The session from which is requests originates

Returns:Serializable

The identifier value.

getIdentifierGetter	back to summary
public Getter getIdentifierGetter() Retrieve the getter for the identifier property. May return null. Returns:Getter The getter for the identifier property.

getIdentifierGetter

back to summary

public Getter getIdentifierGetter()

Retrieve the getter for the identifier property. May return null.

Returns:Getter: The getter for the identifier property.

getPropertyValue	back to summary
public Object getPropertyValue(Object entity, String propertyName) throws HibernateException Extract the value of a particular property from the given entity. Parameters entity:Object The entity from which to extract the property value. propertyName:String The name of the property for which to extract the value. Returns:Object The current value of the given property on the given entity.

getPropertyValue

back to summary

public Object getPropertyValue(Object entity, String propertyName) throws HibernateException

Extract the value of a particular property from the given entity.

Parameters

entity:Object: The entity from which to extract the property value.
propertyName:String: The name of the property for which to extract the value.

Returns:Object

The current value of the given property on the given entity.

getPropertyValuesToInsert	back to summary
public Object[] getPropertyValuesToInsert(Object entity, Map<K, V> mergeMap, SessionImplementor session) throws HibernateException Extract the values of the insertable properties of the entity (including backrefs) Parameters entity:Object The entity from which to extract. mergeMap:Map<K, V> a map of instances being merged to merged instances session:SessionImplementor The session in which the resuest is being made. Returns:Object[] The insertable property values.

getPropertyValuesToInsert

back to summary

public Object[] getPropertyValuesToInsert(Object entity, Map<K, V> mergeMap, SessionImplementor session) throws HibernateException

Extract the values of the insertable properties of the entity (including backrefs)

Parameters

entity:Object: The entity from which to extract.
mergeMap:Map<K, V>: a map of instances being merged to merged instances
session:SessionImplementor: The session in which the resuest is being made.

Returns:Object[]

The insertable property values.

getVersion	back to summary
public Object getVersion(Object entity) throws HibernateException Extract the value of the version property from the given entity. Parameters entity:Object The entity from which to extract the version value. Returns:Object The value of the version property, or null if not versioned.

getVersion

back to summary

public Object getVersion(Object entity) throws HibernateException

Extract the value of the version property from the given entity.

Parameters

entity:Object: The entity from which to extract the version value.

Returns:Object

The value of the version property, or null if not versioned.

getVersionGetter	back to summary
public Getter getVersionGetter() Retrieve the getter for the version property. May return null. Returns:Getter The getter for the version property.

getVersionGetter

back to summary

public Getter getVersionGetter()

Retrieve the getter for the version property. May return null.

Returns:Getter: The getter for the version property.

hasProxy	back to summary
public boolean hasProxy() Does this entity, for this mode, present a possibility for proxying? Returns:boolean True if this tuplizer can generate proxies for this entity.

hasProxy

back to summary

public boolean hasProxy()

Does this entity, for this mode, present a possibility for proxying?

Returns:boolean: True if this tuplizer can generate proxies for this entity.

hasUninitializedLazyProperties	back to summary
public boolean hasUninitializedLazyProperties(Object entity) Does the given entity instance have any currently uninitialized lazy properties? Parameters entity:Object The entity to be check for uninitialized lazy properties. Returns:boolean True if uninitialized lazy properties were found; false otherwise.

hasUninitializedLazyProperties

back to summary

public boolean hasUninitializedLazyProperties(Object entity)

Does the given entity instance have any currently uninitialized lazy properties?

Parameters

entity:Object: The entity to be check for uninitialized lazy properties.

Returns:boolean

True if uninitialized lazy properties were found; false otherwise.

instantiate back to summary

instantiate	back to summary
public Object instantiate(Serializable id) throws HibernateException Deprecated Use `instantiate(Serializable, SessionImplementor)` instead. Create an entity instance initialized with the given identifier. Parameters id:Serializable The identifier value for the entity to be instantiated. Returns:Object The instantiated entity.

public Object instantiate(Serializable id) throws HibernateException

Deprecated

Use instantiate(Serializable, SessionImplementor) instead.

Create an entity instance initialized with the given identifier.

Parameters

id:Serializable: The identifier value for the entity to be instantiated.

Returns:Object

The instantiated entity.

instantiate	back to summary
public Object instantiate(Serializable id, SessionImplementor session) Create an entity instance initialized with the given identifier. Parameters id:Serializable The identifier value for the entity to be instantiated. session:SessionImplementor The session from which is requests originates Returns:Object The instantiated entity.

instantiate

back to summary

public Object instantiate(Serializable id, SessionImplementor session)

Create an entity instance initialized with the given identifier.

Parameters

id:Serializable: The identifier value for the entity to be instantiated.
session:SessionImplementor: The session from which is requests originates

Returns:Object

The instantiated entity.

isInstrumented	back to summary
public boolean isInstrumented() Is it an instrumented POJO?

isLifecycleImplementor back to summary

isLifecycleImplementor	back to summary
public boolean isLifecycleImplementor() Does the `class` managed by this tuplizer implement the `org.hibernate.classic.Lifecycle` interface. Returns:boolean True if the Lifecycle interface is implemented; false otherwise.

public boolean isLifecycleImplementor()

Does the class managed by this tuplizer implement the org.hibernate.classic.Lifecycle interface.

Returns:boolean: True if the Lifecycle interface is implemented; false otherwise.

isValidatableImplementor back to summary

isValidatableImplementor	back to summary
public boolean isValidatableImplementor() Does the `class` managed by this tuplizer implement the `org.hibernate.classic.Validatable` interface. Returns:boolean True if the Validatable interface is implemented; false otherwise.

public boolean isValidatableImplementor()

Does the class managed by this tuplizer implement the org.hibernate.classic.Validatable interface.

Returns:boolean: True if the Validatable interface is implemented; false otherwise.

resetIdentifier back to summary

resetIdentifier	back to summary
public void resetIdentifier(Object entity, Serializable currentId, Object currentVersion) Deprecated Use `resetIdentifier(Object, Serializable, Object, SessionImplementor)` instead Inject the given identifier and version into the entity, in order to "roll back" to their original values. Parameters entity:Object The entity for which to reset the id/version values currentId:Serializable The identifier value to inject into the entity. currentVersion:Object The version value to inject into the entity.

public void resetIdentifier(Object entity, Serializable currentId, Object currentVersion)

Deprecated

Use resetIdentifier(Object, Serializable, Object, SessionImplementor) instead

Inject the given identifier and version into the entity, in order to "roll back" to their original values.

Parameters

entity:Object: The entity for which to reset the id/version values
currentId:Serializable: The identifier value to inject into the entity.
currentVersion:Object: The version value to inject into the entity.

resetIdentifier	back to summary
public void resetIdentifier(Object entity, Serializable currentId, Object currentVersion, SessionImplementor session) Inject the given identifier and version into the entity, in order to "roll back" to their original values. Parameters entity:Object The entity for which to reset the id/version values currentId:Serializable The identifier value to inject into the entity. currentVersion:Object The version value to inject into the entity. session:SessionImplementor The session from which the request originated

resetIdentifier

back to summary

public void resetIdentifier(Object entity, Serializable currentId, Object currentVersion, SessionImplementor session)

Inject the given identifier and version into the entity, in order to "roll back" to their original values.

Parameters

entity:Object: The entity for which to reset the id/version values
currentId:Serializable: The identifier value to inject into the entity.
currentVersion:Object: The version value to inject into the entity.
session:SessionImplementor: The session from which the request originated

setIdentifier back to summary

setIdentifier	back to summary
public void setIdentifier(Object entity, Serializable id) throws HibernateException Deprecated Use `setIdentifier(Object, Serializable, SessionImplementor)` instead. Inject the identifier value into the given entity. Has no effect if the entity does not define an identifier property Parameters entity:Object The entity to inject with the identifier value. id:Serializable The value to be injected as the identifier.

public void setIdentifier(Object entity, Serializable id) throws HibernateException

Deprecated

Use setIdentifier(Object, Serializable, SessionImplementor) instead.

Inject the identifier value into the given entity.

Has no effect if the entity does not define an identifier property

Parameters

entity:Object: The entity to inject with the identifier value.
id:Serializable: The value to be injected as the identifier.

setIdentifier	back to summary
public void setIdentifier(Object entity, Serializable id, SessionImplementor session) Inject the identifier value into the given entity. Has no effect if the entity does not define an identifier property Parameters entity:Object The entity to inject with the identifier value. id:Serializable The value to be injected as the identifier. session:SessionImplementor The session from which is requests originates

setIdentifier

back to summary

public void setIdentifier(Object entity, Serializable id, SessionImplementor session)

Inject the identifier value into the given entity.

Has no effect if the entity does not define an identifier property

Parameters

entity:Object: The entity to inject with the identifier value.
id:Serializable: The value to be injected as the identifier.
session:SessionImplementor: The session from which is requests originates

setPropertyValue	back to summary
public void setPropertyValue(Object entity, int i, Object value) throws HibernateException Inject the value of a particular property. Parameters entity:Object The entity into which to inject the value. i:int The property's index. value:Object The property value to inject.

setPropertyValue

back to summary

public void setPropertyValue(Object entity, int i, Object value) throws HibernateException

Inject the value of a particular property.

Parameters

entity:Object: The entity into which to inject the value.
i:int: The property's index.
value:Object: The property value to inject.

setPropertyValue	back to summary
public void setPropertyValue(Object entity, String propertyName, Object value) throws HibernateException Inject the value of a particular property. Parameters entity:Object The entity into which to inject the value. propertyName:String The name of the property. value:Object The property value to inject.

setPropertyValue

back to summary

public void setPropertyValue(Object entity, String propertyName, Object value) throws HibernateException

Inject the value of a particular property.

Parameters

entity:Object: The entity into which to inject the value.
propertyName:String: The name of the property.
value:Object: The property value to inject.

public Interface EntityTuplizer

Method Summary

Method Detail