Modifier and Type	Class and Description
public static class	ForeignKeys.Nullifier Delegate for handling nullifying ("null"ing-out) non-cascaded associations

Access	Constructor and Description
private	ForeignKeys() Disallow instantiation

Method Summary

Modifier and Type	Method and Description
private static void	collectNonNullableTransientEntities(ForeignKeys.Nullifier nullifier, Object value, String propertyName, Type type, boolean isNullable, SharedSessionContractImplementor session, NonNullableTransientDependencies nonNullableTransientEntities)
public static NonNullableTransientDependencies	Returns: the transient unsaved entity dependencies that are non-nullable, or null if there are none. findNonNullableTransientEntities(String - the entity name entityName, Object - the entity instance entity, Object[] - insertable properties of the object (including backrefs), possibly with substitutions values, boolean - true if the entity needs to be executed as soon as possible (e.g., to generate an ID) isEarlyInsert, SharedSessionContractImplementor - the session session) Find all non-nullable references to entities that have not yet been inserted in the database, where the foreign key is a reference to an unsaved transient entity.
public static Object	Returns: The identifier getEntityIdentifierIfNotUnsaved(final String The name of the entity entityName, final Object The entity instance object, final SharedSessionContractImplementor The session session) Return the identifier of the persistent or transient object, or throw an exception if the instance is "unsaved" Used by OneToOneType and ManyToOneType to determine what id value should be used for an object that may or may not be associated with the session.
public static boolean	Returns: `true` if the given entity is not transient (meaning it is either detached/persistent) isNotTransient(String The name of the entity entityName, Object The entity instance entity, Boolean The assumed return value, if avoiding database hit is desired assumed, SharedSessionContractImplementor The session session) Is this instance persistent or detached?
public static boolean	Returns: `true` if the given entity is transient (unsaved) isTransient(String The name of the entity entityName, Object The entity instance entity, Boolean The assumed return value, if avoiding database hit is desired assumed, SharedSessionContractImplementor The session session) Is this instance, which we know is not persistent, actually transient?

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

ForeignKeys	back to summary
private ForeignKeys() Disallow instantiation

Method Detail

collectNonNullableTransientEntities	back to summary
private static void collectNonNullableTransientEntities(ForeignKeys.Nullifier nullifier, Object value, String propertyName, Type type, boolean isNullable, SharedSessionContractImplementor session, NonNullableTransientDependencies nonNullableTransientEntities)

findNonNullableTransientEntities	back to summary
public static NonNullableTransientDependencies findNonNullableTransientEntities(String entityName, Object entity, Object[] values, boolean isEarlyInsert, SharedSessionContractImplementor session) Find all non-nullable references to entities that have not yet been inserted in the database, where the foreign key is a reference to an unsaved transient entity. . Parameters entityName:String - the entity name entity:Object - the entity instance values:Object[] - insertable properties of the object (including backrefs), possibly with substitutions isEarlyInsert:boolean - true if the entity needs to be executed as soon as possible (e.g., to generate an ID) session:SharedSessionContractImplementor - the session Returns:NonNullableTransientDependencies the transient unsaved entity dependencies that are non-nullable, or null if there are none.

findNonNullableTransientEntities

back to summary

public static NonNullableTransientDependencies findNonNullableTransientEntities(String entityName, Object entity, Object[] values, boolean isEarlyInsert, SharedSessionContractImplementor session)

Find all non-nullable references to entities that have not yet been inserted in the database, where the foreign key is a reference to an unsaved transient entity. .

Parameters

entityName:String: - the entity name
entity:Object: - the entity instance
values:Object[]: - insertable properties of the object (including backrefs), possibly with substitutions
isEarlyInsert:boolean: - true if the entity needs to be executed as soon as possible (e.g., to generate an ID)
session:SharedSessionContractImplementor: - the session

Returns:NonNullableTransientDependencies

the transient unsaved entity dependencies that are non-nullable, or null if there are none.

getEntityIdentifierIfNotUnsaved	back to summary
public static Object getEntityIdentifierIfNotUnsaved(final String entityName, final Object object, final SharedSessionContractImplementor session) throws TransientObjectException Return the identifier of the persistent or transient object, or throw an exception if the instance is "unsaved" Used by OneToOneType and ManyToOneType to determine what id value should be used for an object that may or may not be associated with the session. This does a "best guess" using any/all info available to use (not just the EntityEntry). Parameters entityName:String The name of the entity object:Object The entity instance session:SharedSessionContractImplementor The session Returns:Object The identifier Exceptions TransientObjectException: if the entity is transient (does not yet have an identifier)

getEntityIdentifierIfNotUnsaved

back to summary

public static Object getEntityIdentifierIfNotUnsaved(final String entityName, final Object object, final SharedSessionContractImplementor session) throws TransientObjectException

Return the identifier of the persistent or transient object, or throw an exception if the instance is "unsaved"

Used by OneToOneType and ManyToOneType to determine what id value should be used for an object that may or may not be associated with the session. This does a "best guess" using any/all info available to use (not just the EntityEntry).

Parameters

entityName:String: The name of the entity
object:Object: The entity instance
session:SharedSessionContractImplementor: The session

Returns:Object

The identifier

Exceptions

TransientObjectException:: if the entity is transient (does not yet have an identifier)

isNotTransient back to summary

isNotTransient	back to summary
public static boolean isNotTransient(String entityName, Object entity, Boolean assumed, SharedSessionContractImplementor session) Is this instance persistent or detached? If `assumed` is non-null, don't hit the database to make the determination, instead assume that value; the client code must be prepared to "recover" in the case that this assumed result is incorrect. Parameters entityName:String The name of the entity entity:Object The entity instance assumed:Boolean The assumed return value, if avoiding database hit is desired session:SharedSessionContractImplementor The session Returns:boolean `true` if the given entity is not transient (meaning it is either detached/persistent)

public static boolean isNotTransient(String entityName, Object entity, Boolean assumed, SharedSessionContractImplementor session)

Is this instance persistent or detached?

If assumed is non-null, don't hit the database to make the determination, instead assume that value; the client code must be prepared to "recover" in the case that this assumed result is incorrect.

Parameters

entityName:String: The name of the entity
entity:Object: The entity instance
assumed:Boolean: The assumed return value, if avoiding database hit is desired
session:SharedSessionContractImplementor: The session

Returns:boolean

true if the given entity is not transient (meaning it is either detached/persistent)

isTransient back to summary

isTransient	back to summary
public static boolean isTransient(String entityName, Object entity, Boolean assumed, SharedSessionContractImplementor session) Is this instance, which we know is not persistent, actually transient? If `assumed` is non-null, don't hit the database to make the determination, instead assume that value; the client code must be prepared to "recover" in the case that this assumed result is incorrect. Parameters entityName:String The name of the entity entity:Object The entity instance assumed:Boolean The assumed return value, if avoiding database hit is desired session:SharedSessionContractImplementor The session Returns:boolean `true` if the given entity is transient (unsaved)

public static boolean isTransient(String entityName, Object entity, Boolean assumed, SharedSessionContractImplementor session)

Is this instance, which we know is not persistent, actually transient?

If assumed is non-null, don't hit the database to make the determination, instead assume that value; the client code must be prepared to "recover" in the case that this assumed result is incorrect.

Parameters

entityName:String: The name of the entity
entity:Object: The entity instance
assumed:Boolean: The assumed return value, if avoiding database hit is desired
session:SharedSessionContractImplementor: The session

Returns:boolean

true if the given entity is transient (unsaved)

org.hibernate.engine.internal back to summary

public Class ForeignKeys.Nullifier

Class Inheritance

extends Object

java.lang.Object
org.hibernate.engine.internal.ForeignKeys.Nullifier

Delegate for handling nullifying ("null"ing-out) non-cascaded associations

Field Summary

Modifier and Type	Field and Description
private final boolean	isDelete
private final boolean	isEarlyInsert
private final EntityPersister	persister
private final Object	self
private final SharedSessionContractImplementor	session

Constructor Summary

Access	Constructor and Description
public	Nullifier(final Object The entity self, final boolean Are we in the middle of a delete action? isDelete, final boolean Is this an early insert (INSERT generated id strategy)? isEarlyInsert, final SharedSessionContractImplementor The session session, final EntityPersister The EntityPersister for `self` persister) Constructs a Nullifier

Method Summary

Modifier and Type	Method and Description
private Object	initializeIfNecessary(final Object value, final String propertyName, final Type type)
private boolean	isNullifiable(final String The name of the entity entityName, Object The entity instance object) Determine if the object already exists in the database, using a "best guess"
public void	nullifyTransientReferences(final Object[] The entity attribute values values) Nullify all references to entities that have not yet been inserted in the database, where the foreign key points toward that entity.
private Object	Returns: `null` if the argument is an unsaved entity; otherwise return the argument. nullifyTransientReferences(final Object An entity attribute value value, final String An entity attribute name propertyName, final Type An entity attribute type type) Return null if the argument is an "unsaved" entity (ie.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

isDelete	back to summary
private final boolean isDelete

isEarlyInsert	back to summary
private final boolean isEarlyInsert

persister	back to summary
private final EntityPersister persister

self	back to summary
private final Object self

session	back to summary
private final SharedSessionContractImplementor session

Constructor Detail

Nullifier back to summary

Nullifier	back to summary
public Nullifier(final Object self, final boolean isDelete, final boolean isEarlyInsert, final SharedSessionContractImplementor session, final EntityPersister persister) Constructs a Nullifier Parameters self:Object The entity isDelete:boolean Are we in the middle of a delete action? isEarlyInsert:boolean Is this an early insert (INSERT generated id strategy)? session:SharedSessionContractImplementor The session persister:EntityPersister The EntityPersister for `self`

public Nullifier(final Object self, final boolean isDelete, final boolean isEarlyInsert, final SharedSessionContractImplementor session, final EntityPersister persister)

Constructs a Nullifier

Parameters

self:Object: The entity
isDelete:boolean: Are we in the middle of a delete action?
isEarlyInsert:boolean: Is this an early insert (INSERT generated id strategy)?
session:SharedSessionContractImplementor: The session
persister:EntityPersister: The EntityPersister for self

Method Detail

initializeIfNecessary	back to summary
private Object initializeIfNecessary(final Object value, final String propertyName, final Type type)

isNullifiable	back to summary
private boolean isNullifiable(final String entityName, Object object) throws HibernateException Determine if the object already exists in the database, using a "best guess" Parameters entityName:String The name of the entity object:Object The entity instance

isNullifiable

back to summary

private boolean isNullifiable(final String entityName, Object object) throws HibernateException

Determine if the object already exists in the database, using a "best guess"

Parameters

entityName:String: The name of the entity
object:Object: The entity instance

nullifyTransientReferences	back to summary
public void nullifyTransientReferences(final Object[] values) Nullify all references to entities that have not yet been inserted in the database, where the foreign key points toward that entity. Parameters values:Object[] The entity attribute values

nullifyTransientReferences

back to summary

public void nullifyTransientReferences(final Object[] values)

Nullify all references to entities that have not yet been inserted in the database, where the foreign key points toward that entity.

Parameters

values:Object[]: The entity attribute values

nullifyTransientReferences back to summary

nullifyTransientReferences	back to summary
private Object nullifyTransientReferences(final Object value, final String propertyName, final Type type) Return null if the argument is an "unsaved" entity (ie. one with no existing database row), or the input argument otherwise. This is how Hibernate avoids foreign key constraint violations. Parameters value:Object An entity attribute value propertyName:String An entity attribute name type:Type An entity attribute type Returns:Object `null` if the argument is an unsaved entity; otherwise return the argument.

private Object nullifyTransientReferences(final Object value, final String propertyName, final Type type)

Return null if the argument is an "unsaved" entity (ie. one with no existing database row), or the input argument otherwise. This is how Hibernate avoids foreign key constraint violations.

Parameters

value:Object: An entity attribute value
propertyName:String: An entity attribute name
type:Type: An entity attribute type

Returns:Object

null if the argument is an unsaved entity; otherwise return the argument.

public final Class ForeignKeys

Nested and Inner Type Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail

public Class ForeignKeys.Nullifier

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail