Package org.hibernate
Interface IdentifierLoadAccess<T>
-
public interface IdentifierLoadAccess<T>
Loads an entity by its primary identifier.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description T
getReference(Serializable id)
Return the persistent instance with the given identifier, assuming that the instance exists.T
load(Serializable id)
Return the persistent instance with the given identifier, or null if there is no such persistent instance.Optional<T>
loadOptional(Serializable id)
Same semantic asload(java.io.Serializable)
except that hereOptional
is returned to handle nullability.IdentifierLoadAccess<T>
with(CacheMode cacheMode)
Specify theCacheMode
to use when retrieving the entity.IdentifierLoadAccess<T>
with(LockOptions lockOptions)
Specify theLockOptions
to use when retrieving the entity.
-
-
-
Method Detail
-
with
IdentifierLoadAccess<T> with(LockOptions lockOptions)
Specify theLockOptions
to use when retrieving the entity.- Parameters:
lockOptions
- The lock options to use.- Returns:
this
, for method chaining
-
with
IdentifierLoadAccess<T> with(CacheMode cacheMode)
Specify theCacheMode
to use when retrieving the entity.- Parameters:
cacheMode
- The CacheMode to use.- Returns:
this
, for method chaining
-
getReference
T getReference(Serializable id)
Return the persistent instance with the given identifier, 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, useload(java.io.Serializable)
instead. Use this only to retrieve an instance that you assume exists, where non-existence would be an actual error.- Parameters:
id
- The identifier for which to obtain a reference- Returns:
- the persistent instance or proxy
-
load
T load(Serializable id)
Return the persistent instance with the given identifier, 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:
id
- The identifier- Returns:
- The persistent instance or
null
-
loadOptional
Optional<T> loadOptional(Serializable id)
Same semantic asload(java.io.Serializable)
except that hereOptional
is returned to handle nullability.- Parameters:
id
- The identifier- Returns:
- The persistent instance, if one, wrapped in Optional
-
-