Interface SimpleNaturalIdLoadAccess<T>

@Deprecated(since="7.3")
public interface SimpleNaturalIdLoadAccess<T>

Deprecated.

Use Session.find(Class, Object) or Session.getReference(Class, Object) with KeyType.NATURAL instead.

Loads an entity by its natural identifier. This simplified API is used when the entity has exactly one field or property annotated @NaturalId. If an entity has multiple attributes annotated @NaturalId, then NaturalIdLoadAccess should be used instead.

Book book = session.bySimpleNaturalId(Book.class).load(isbn);

See Also:

• Session.bySimpleNaturalId(Class)
• NaturalId
• NaturalIdLoadAccess

Method Summary

Modifier and Type	Method	Description
SimpleNaturalIdLoadAccess<T>	disableFetchProfile(String profileName)	Deprecated. Customize the associations fetched by specifying a fetch profile that should be disabled during this operation.
SimpleNaturalIdLoadAccess<T>	enableFetchProfile(String profileName)	Deprecated. Customize the associations fetched by specifying a fetch profile that should be enabled during this operation.
T	getReference(Object naturalIdValue)	Deprecated. Use Session.getReference(Class, Object, KeyType) instead, with KeyType.NATURAL as an option.
T	load(Object naturalIdValue)	Deprecated. Use one of Session.find(Class, Object, FindOption...), SharedSessionContract.find(String, Object, FindOption...), or EntityHandler.find(EntityGraph, Object, FindOption...) instead with KeyType.NATURAL as an option.
Optional<T>	loadOptional(Object naturalIdValue)	Deprecated. Just like load(Object), except that here an Optional is returned.
SimpleNaturalIdLoadAccess<T>	setSynchronizationEnabled(boolean enabled)	Deprecated. For entities with mutable natural ids, should Hibernate perform "synchronization" prior to performing lookups? The default is to perform "synchronization" (for correctness).
SimpleNaturalIdLoadAccess<T>	with(EntityGraph<T> graph, GraphSemantic semantic)	Deprecated. Customize the associations fetched by specifying an entity graph, and how it should be interpreted.
SimpleNaturalIdLoadAccess<T>	with(Timeout timeout)	Deprecated. Specify the timeout to use when querying the database.
default SimpleNaturalIdLoadAccess<T>	with(LockMode lockMode)	Deprecated. Specify the lock mode to use when querying the database.
SimpleNaturalIdLoadAccess<T>	with(LockMode lockMode, PessimisticLockScope lockScope)	Deprecated. Specify the lock mode to use when querying the database.
SimpleNaturalIdLoadAccess<T>	with(LockOptions lockOptions)	Deprecated, for removal: This API element is subject to removal in a future version. Use one of with(LockMode), with(LockMode, PessimisticLockScope) and/or with(Timeout) instead.
default SimpleNaturalIdLoadAccess<T>	withFetchGraph(EntityGraph<T> graph)	Deprecated. Override the associations fetched by default by specifying the complete list of associations to be fetched as an entity graph.
default SimpleNaturalIdLoadAccess<T>	withLoadGraph(EntityGraph<T> graph)	Deprecated. Augment the associations fetched by default by specifying a list of additional associations to be fetched as an entity graph.

Method Details

with

default SimpleNaturalIdLoadAccess<T> with(LockMode lockMode)

Deprecated.

Specify the lock mode to use when querying the database.

Parameters:

lockMode - The lock mode to apply

Returns:

this, for method chaining

with

SimpleNaturalIdLoadAccess<T> with(LockMode lockMode,
 PessimisticLockScope lockScope)

Deprecated.

Specify the lock mode to use when querying the database.

Parameters:

lockMode - The lock mode to apply

Returns:

this, for method chaining

with

SimpleNaturalIdLoadAccess<T> with(Timeout timeout)

Deprecated.

Specify the timeout to use when querying the database.

Parameters:

timeout - The timeout to apply to the database operation

Returns:

this, for method chaining

with

@Deprecated(since="7.0",
            forRemoval=true)
SimpleNaturalIdLoadAccess<T> with(LockOptions lockOptions)

Deprecated, for removal: This API element is subject to removal in a future version.

Use one of with(LockMode), with(LockMode, PessimisticLockScope) and/or with(Timeout) instead.

Specify the lock options to use when querying the database.

Parameters:

lockOptions - The lock options to use

Returns:

this, for method chaining

withFetchGraph

default SimpleNaturalIdLoadAccess<T> withFetchGraph(EntityGraph<T> graph)

Deprecated.

Override the associations fetched by default by specifying the complete list of associations to be fetched as an entity graph.

Since:

6.3

withLoadGraph

default SimpleNaturalIdLoadAccess<T> withLoadGraph(EntityGraph<T> graph)

Deprecated.

Augment the associations fetched by default by specifying a list of additional associations to be fetched as an entity graph.

Since:

6.3

with

SimpleNaturalIdLoadAccess<T> with(EntityGraph<T> graph,
 GraphSemantic semantic)

Deprecated.

Customize the associations fetched by specifying an entity graph, and how it should be interpreted.

Since:

6.3

enableFetchProfile

SimpleNaturalIdLoadAccess<T> enableFetchProfile(String profileName)

Deprecated.

Customize the associations fetched by specifying a fetch profile that should be enabled during this operation.

This allows the session-level fetch profiles to be temporarily overridden.

Since:

6.3

disableFetchProfile

SimpleNaturalIdLoadAccess<T> disableFetchProfile(String profileName)

Deprecated.

Customize the associations fetched by specifying a fetch profile that should be disabled during this operation.

This allows the session-level fetch profiles to be temporarily overridden.

Since:

6.3

setSynchronizationEnabled

SimpleNaturalIdLoadAccess<T> setSynchronizationEnabled(boolean enabled)

Deprecated.

For entities with mutable natural ids, should Hibernate perform "synchronization" prior to performing lookups? The default is to perform "synchronization" (for correctness).

See NaturalIdLoadAccess.setSynchronizationEnabled(boolean) for detailed discussion.

Parameters:

enabled - Should synchronization be performed? true indicates synchronization will be performed; false indicates it will be circumvented.

Returns:

this, for method chaining

getReference

@Deprecated
T getReference(Object naturalIdValue)

Deprecated.

Use Session.getReference(Class, Object, KeyType) instead, with KeyType.NATURAL as an option.

Return the persistent instance with the given natural id value, assuming that the instance exists. This method might return a proxied instance that is initialized on-demand, when a non-identifier method is accessed.

You should not use this method to determine if an instance exists; to check for existence, use load(Object) instead. Use this only to retrieve an instance that you assume exists, where non-existence would be an actual error.

Parameters:

naturalIdValue - The value of the natural id

Returns:

The persistent instance or proxy, if an instance exists. Otherwise, null.

load

@Deprecated
T load(Object naturalIdValue)

Deprecated.

Use one of Session.find(Class, Object, FindOption...), SharedSessionContract.find(String, Object, FindOption...), or EntityHandler.find(EntityGraph, Object, FindOption...) instead with KeyType.NATURAL as an option.

Return the persistent instance with the given natural id value, or null if there is no such persistent instance. If the instance is already associated with the session, return that instance, initializing it if needed. This method never returns an uninitialized instance.

Parameters:

naturalIdValue - The value of the natural-id

Returns:

The persistent instance or null

loadOptional

Optional<T> loadOptional(Object naturalIdValue)

Deprecated.

Just like load(Object), except that here an Optional is returned.

Parameters:

naturalIdValue - The identifier

Returns:

The persistent instance, if any, as an Optional