Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
java.lang.Object
org.hibernate.impl.AbstractSessionImpl
org.hibernate.impl.SessionImpl
public final class SessionImpl
extends AbstractSessionImpl
implements EventSource, Session, JDBCContext.Context
Field Summary |
Fields inherited from class org.hibernate.impl.AbstractSessionImpl | |
factory |
Method Summary | |
void |
|
void | |
void |
|
void |
|
protected boolean |
|
void | |
Transaction |
|
String |
|
void |
|
void |
|
Connection |
|
Connection |
|
boolean |
|
Criteria |
|
Criteria |
|
Criteria |
|
Criteria |
|
Query |
|
Query |
|
SQLQuery |
|
Query |
|
Query |
|
void |
|
int |
|
void |
|
void |
|
int | |
int | |
void |
|
Connection |
|
void | |
Filter |
|
void |
|
int |
|
int |
|
Collection |
|
Collection |
|
Collection |
|
List |
|
List |
|
List |
|
void |
|
void |
|
Object |
|
Object | |
Object |
|
Object | |
ActionQueue |
|
Batcher | |
CacheMode |
|
ConnectionReleaseMode | |
Serializable |
|
LockMode |
|
int | |
Filter |
|
Map | |
EntityMode |
|
String |
|
EntityPersister |
|
Object | |
String | |
Type |
|
Object |
|
FlushMode |
|
Serializable |
|
Interceptor | |
JDBCContext | |
EventListeners | |
Query |
|
PersistenceContext | |
Session |
|
SessionFactory |
|
SessionStatistics |
|
long | |
Transaction |
|
String |
|
Object |
|
void |
|
Object |
|
Object |
|
Object |
|
boolean | |
boolean |
|
boolean |
|
boolean | |
boolean | |
boolean | |
boolean |
|
boolean | |
Iterator |
|
Iterator |
|
Iterator |
|
Iterator |
|
Iterator |
|
List |
|
List |
|
List |
|
List |
|
Object |
|
Object | |
void |
|
Object |
|
Object | |
void | |
void | |
void | |
void | |
Object |
|
Object |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void | |
void |
|
void |
|
Serializable |
|
void |
|
Serializable |
|
void |
|
void |
|
void |
|
Object |
|
Object |
|
Object |
|
void |
|
Object |
|
ScrollableResults |
|
ScrollableResults |
|
ScrollableResults |
|
void |
|
void |
|
void |
|
void |
|
void |
|
boolean | |
String |
|
void |
|
void |
|
void |
|
void |
|
Methods inherited from class org.hibernate.impl.AbstractSessionImpl | |
createQuery , createSQLQuery , errorIfClosed , getFactory , getHQLQueryPlan , getNamedQuery , getNamedSQLQuery , getNativeSQLQueryPlan , isClosed , list , scroll , setClosed |
public void afterOperation(boolean success)
Check if there is a Hibernate or JTA transaction in progress and, if there is not, flush if necessary, make sure the connection has been committed (if it is not in autocommit mode) and run the after completion processing
public void afterScrollOperation()
- Specified by:
- afterScrollOperation in interface SessionImplementor
public void afterTransactionBegin(Transaction tx)
We cannot rely upon this method being called! It is only called if we are using Hibernate Transaction API.
- Specified by:
- afterTransactionBegin in interface JDBCContext.Context
public void afterTransactionCompletion(boolean success, Transaction tx)
- Specified by:
- afterTransactionCompletion in interface SessionImplementor
- afterTransactionCompletion in interface JDBCContext.Context
protected boolean autoFlushIfRequired(Set querySpaces) throws HibernateException
detect in-memory changes, determine if the changes are to tables named in the query and, if so, complete execution the flush
public void beforeTransactionCompletion(Transaction tx)
- Specified by:
- beforeTransactionCompletion in interface SessionImplementor
- beforeTransactionCompletion in interface JDBCContext.Context
public Transaction beginTransaction() throws HibernateException
Begin a unit of work and return the associated Transaction object. If a new underlying transaction is required, begin the transaction. Otherwise continue the new work in the context of the existing underlying transaction. The class of the returned Transaction object is determined by the property hibernate.transaction_factory.
- Specified by:
- beginTransaction in interface Session
- Returns:
- a Transaction instance
- Throws:
HibernateException
-
- See Also:
Transaction
public String bestGuessEntityName(Object object)
- Specified by:
- bestGuessEntityName in interface SessionImplementor
public void cancelQuery() throws HibernateException
Cancel the execution of the current query. This is the sole method on session which may be safely called from another thread.
- Specified by:
- cancelQuery in interface Session
- Throws:
HibernateException
- There was a problem canceling the query
public void clear()
Completely clear the session. Evict all loaded instances and cancel all pending saves, updates and deletions. Do not close open iterators or instances of ScrollableResults.
public Connection close() throws HibernateException
End the session by releasing the JDBC connection and cleaning up. It is not strictly necessary to close the session but you must at leastSession.disconnect()
it.
- Returns:
- the connection provided by the application or null.
- Throws:
HibernateException
- Indicates problems cleaning up.
public Connection connection() throws HibernateException
Deprecated. (scheduled for removal in 4.x). Replacement depends on need; for doing direct JDBC stuff use
Session.doWork(Work)
; for opening a 'temporary Session' use (TBD).Get the JDBC connection of this Session.
If the session is using aggressive collection release (as in a CMT environment), it is the application's responsibility to close the connection returned by this call. Otherwise, the application should not close the connection.
- Specified by:
- connection in interface SessionImplementor
- connection in interface Session
- Returns:
- the JDBC connection in use by the Session
- Throws:
HibernateException
- if the Session is disconnected
public boolean contains(Object object)
Check if this instance is associated with this Session.
- Parameters:
object
- an instance of a persistent class
- Returns:
- true if the given instance is associated with this Session
public Criteria createCriteria(Class persistentClass)
Create a new Criteria instance, for the given entity class, or a superclass of an entity class.
- Specified by:
- createCriteria in interface Session
- Parameters:
persistentClass
- a class, which is persistent, or has persistent subclasses
- Returns:
- Criteria
public Criteria createCriteria(Class persistentClass, String alias)
Create a new Criteria instance, for the given entity class, or a superclass of an entity class, with the given alias.
- Specified by:
- createCriteria in interface Session
- Parameters:
persistentClass
- a class, which is persistent, or has persistent subclasses
- Returns:
- Criteria
public Criteria createCriteria(String entityName)
Create a new Criteria instance, for the given entity name.
- Specified by:
- createCriteria in interface Session
- Parameters:
entityName
-
- Returns:
- Criteria
public Criteria createCriteria(String entityName, String alias)
Create a new Criteria instance, for the given entity name, with the given alias.
- Specified by:
- createCriteria in interface Session
- Parameters:
entityName
-
- Returns:
- Criteria
public Query createFilter(Object collection, String queryString)
Create a new instance of Query for the given collection and filter string.
- Specified by:
- createFilter in interface Session
- Parameters:
collection
- a persistent collectionqueryString
- a Hibernate query
- Returns:
- Query
public Query createQuery(String queryString)
Create a new instance of Query for the given HQL query string.
- Specified by:
- createQuery in interface Session
- Overrides:
- createQuery in interface AbstractSessionImpl
- Parameters:
queryString
- a HQL query
- Returns:
- Query
public SQLQuery createSQLQuery(String sql)
Create a new instance of SQLQuery for the given SQL query string.
- Specified by:
- createSQLQuery in interface Session
- Overrides:
- createSQLQuery in interface AbstractSessionImpl
- Parameters:
- Returns:
- SQLQuery
public Query createSQLQuery(String sql, String returnAlias, Class returnClass)
Deprecated. will be replaced with a more Query like interface in later release
Create a new instance of Query for the given SQL string.
- Specified by:
- createSQLQuery in interface Session
- Parameters:
sql
- a query expressed in SQLreturnAlias
- a table alias that appears inside {} in the SQL stringreturnClass
- the returned persistent class
public int delete(String query) throws HibernateException
Deprecated. consider using HQL delete statements
Delete all objects returned by the query. Return the number of objects deleted. Note that this is very different from the delete-statement support added in HQL since 3.1. The functionality here is to actually peform the query and then iterate the results callingdelete(Object)
individually.
- Parameters:
query
- the query string
- Returns:
- the number of instances deleted
- Throws:
HibernateException
-
public void delete(String entityName, Object object) throws HibernateException
Delete a persistent object (by explicit entity name)
public void delete(String entityName, Object object, boolean isCascadeDeleteEnabled, Set transientEntities) throws HibernateException
Delete a persistent object
- Specified by:
- delete in interface EventSource
public int delete(String query, Object value, Type type) throws HibernateException
Deprecated. consider using HQL delete statements
Delete all objects returned by the query. Return the number of objects deleted. Note that this is very different from the delete-statement support added in HQL since 3.1. The functionality here is to actually peform the query and then iterate the results callingdelete(Object)
individually.
- Parameters:
query
- the query stringvalue
- a value to be witten to a "?" placeholder in the query string.type
- the hibernate type of value.
- Returns:
- the number of instances deleted
- Throws:
HibernateException
-
public int delete(String query, Object[] values, Type[] types) throws HibernateException
Deprecated. consider using HQL delete statements
Delete all objects returned by the query. Return the number of objects deleted. Note that this is very different from the delete-statement support added in HQL since 3.1. The functionality here is to actually peform the query and then iterate the results callingdelete(Object)
individually.
- Parameters:
query
- the query stringvalues
- a list of values to be written to "?" placeholders in the query.types
- a list of Hibernate types of the values
- Returns:
- the number of instances deleted
- Throws:
HibernateException
-
public void disableFilter(String filterName)
Disable the named filter for the current session.
- Specified by:
- disableFilter in interface Session
- Parameters:
filterName
- The name of the filter to be disabled.
public Connection disconnect() throws HibernateException
Disconnect the Session from the current JDBC connection. If the connection was obtained by Hibernate close it and return it to the connection pool; otherwise, return it to the application. This is used by applications which supply JDBC connections to Hibernate and which require long-sessions (or long-conversations) Note that disconnect() called on a session where the connection was retrieved by Hibernate through its configuredConnectionProvider
has no effect, providedConnectionReleaseMode.ON_CLOSE
is not in effect.
- Specified by:
- disconnect in interface Session
- Returns:
- the application-supplied connection or null
public void doWork(Work work) throws HibernateException
Controller for allowing users to perform JDBC related work using the Connection managed by this Session.
- Parameters:
work
- The work to be performed.
- Throws:
HibernateException
- Generally indicates wrappedjava.sql.SQLException
public Filter enableFilter(String filterName)
Enable the named filter for this current session.
- Specified by:
- enableFilter in interface Session
- Parameters:
filterName
- The name of the filter to be enabled.
- Returns:
- The Filter instance representing the enabled fiter.
public void evict(Object object) throws HibernateException
remove any hard references to the entity that are held by the infrastructure (references held by application or other persistant instances are okay)
public int executeNativeUpdate(NativeSQLQuerySpecification nativeQuerySpecification, QueryParameters queryParameters) throws HibernateException
- Specified by:
- executeNativeUpdate in interface SessionImplementor
public int executeUpdate(String query, QueryParameters queryParameters) throws HibernateException
- Specified by:
- executeUpdate in interface SessionImplementor
public Collection filter(Object collection, String filter) throws HibernateException
Deprecated. use
createFilter(Object, String)
.Query.list()
Apply a filter to a persistent collection. A filter is a Hibernate query that may refer to this, the collection element. Filters allow efficient access to very large lazy collections. (Executing the filter does not initialize the collection.)
- Parameters:
collection
- a persistent collection to filterfilter
- a filter query string
- Returns:
- Collection the resulting collection
- Throws:
HibernateException
-
public Collection filter(Object collection, String filter, Object value, Type type) throws HibernateException
Deprecated. use
createFilter(Object, String)
.setXYZ.Query.list()
Apply a filter to a persistent collection. A filter is a Hibernate query that may refer to this, the collection element.
- Parameters:
collection
- a persistent collection to filterfilter
- a filter query stringvalue
- a value to be witten to a "?" placeholder in the query stringtype
- the hibernate type of value
- Returns:
- Collection
- Throws:
HibernateException
-
public Collection filter(Object collection, String filter, Object[] values, Type[] types) throws HibernateException
Deprecated. use
createFilter(Object, String)
.setXYZ.Query.list()
Apply a filter to a persistent collection. Bind the given parameters to "?" placeholders. A filter is a Hibernate query that may refer to this, the collection element.
- Parameters:
collection
- a persistent collection to filterfilter
- a filter query stringvalues
- a list of values to be written to "?" placeholders in the querytypes
- a list of Hibernate types of the values
- Returns:
- Collection
- Throws:
HibernateException
-
public List find(String query) throws HibernateException
Retrieve a list of persistent objects using a hibernate query
public List find(String query, Object value, Type type) throws HibernateException
Deprecated. use
Session
.setXYZ.Query.list()
Execute a query with bind parameters, binding a value to a "?" parameter in the query string.
- Parameters:
query
- the query stringvalue
- a value to be bound to a "?" placeholder (JDBC IN parameter).type
- the Hibernate type of the value
- Returns:
- a distinct list of instances (or arrays of instances)
- Throws:
HibernateException
-
- See Also:
for access to Type instances
public List find(String query, Object[] values, Type[] types) throws HibernateException
Deprecated. use
Session
.setXYZ.Query.list()
Execute a query with bind parameters, binding an array of values to "?" parameters in the query string.
- Parameters:
query
- the query stringvalues
- an array of values to be bound to the "?" placeholders (JDBC IN parameters).types
- an array of Hibernate types of the values
- Returns:
- a distinct list of instances
- Throws:
HibernateException
-
- See Also:
for access to Type instances
public void flush() throws HibernateException
Force this session to flush. Must be called at the end of a unit of work, before commiting the transaction and closing the session (depending onflush-mode
,Transaction.commit()
calls this method). Flushing is the process of synchronizing the underlying persistent store with persistable state held in memory.
- Specified by:
- flush in interface SessionImplementor
- flush in interface Session
- Throws:
HibernateException
- Indicates problems flushing the session or talking to the database.
public void forceFlush(EntityEntry entityEntry) throws HibernateException
Force an immediate flush
- Specified by:
- forceFlush in interface EventSource
public Object get(Class entityClass, Serializable id) throws HibernateException
Return the persistent instance of the given entity class 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. This method never returns an uninitialized instance.) Obtain the specified lock mode if the instance exists.
- Parameters:
id
- an identifier
- Returns:
- a persistent instance or null
- Throws:
HibernateException
-
public Object get(Class entityClass, Serializable id, LockMode lockMode) throws HibernateException
Return the persistent instance of the given entity class 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. This method never returns an uninitialized instance.) Obtain the specified lock mode if the instance exists.
- Parameters:
id
- an identifierlockMode
- the lock mode
- Returns:
- a persistent instance or null
- Throws:
HibernateException
-
public Object get(String entityName, Serializable id) throws HibernateException
Return the persistent instance of the given named entity 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. This method never returns an uninitialized instance.)
- Parameters:
entityName
- the entity nameid
- an identifier
- Returns:
- a persistent instance or null
- Throws:
HibernateException
-
public Object get(String entityName, Serializable id, LockMode lockMode) throws HibernateException
Return the persistent instance of the given entity class 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. This method never returns an uninitialized instance.) Obtain the specified lock mode if the instance exists.
- Parameters:
entityName
- the entity nameid
- an identifierlockMode
- the lock mode
- Returns:
- a persistent instance or null
- Throws:
HibernateException
-
public ActionQueue getActionQueue()
Get the ActionQueue for this session
- Specified by:
- getActionQueue in interface EventSource
public CacheMode getCacheMode()
Get the current cache mode.
- Specified by:
- getCacheMode in interface SessionImplementor
- getCacheMode in interface Session
- Returns:
- The current cache mode.
public ConnectionReleaseMode getConnectionReleaseMode()
- Specified by:
- getConnectionReleaseMode in interface JDBCContext.Context
public Serializable getContextEntityIdentifier(Object object)
Get the id value for an object that is actually associated with the session. This is a bit stricter than getEntityIdentifierIfNotUnsaved().
- Specified by:
- getContextEntityIdentifier in interface SessionImplementor
public LockMode getCurrentLockMode(Object object) throws HibernateException
Determine the current lock mode of the given object.
- Specified by:
- getCurrentLockMode in interface Session
- Parameters:
object
- a persistent instance
- Returns:
- the current lock mode
- Throws:
HibernateException
-
public int getDontFlushFromFind()
- Specified by:
- getDontFlushFromFind in interface SessionImplementor
public Filter getEnabledFilter(String filterName)
Retrieve a currently enabled filter by name.
- Specified by:
- getEnabledFilter in interface Session
- Parameters:
filterName
- The name of the filter to be retrieved.
- Returns:
- The Filter instance representing the enabled fiter.
public Map getEnabledFilters()
- Specified by:
- getEnabledFilters in interface SessionImplementor
public EntityMode getEntityMode()
Retrieve the entity mode in effect for this session.
- Specified by:
- getEntityMode in interface SessionImplementor
- getEntityMode in interface Session
- Returns:
- The entity mode for this session.
public String getEntityName(Object object)
Return the entity name for a persistent entity
- Specified by:
- getEntityName in interface Session
- Parameters:
object
- a persistent entity
- Returns:
- the entity name
public EntityPersister getEntityPersister(String entityName, Object object)
- Specified by:
- getEntityPersister in interface SessionImplementor
public Object getEntityUsingInterceptor(EntityKey key) throws HibernateException
- Specified by:
- getEntityUsingInterceptor in interface SessionImplementor
public String getFetchProfile()
- Specified by:
- getFetchProfile in interface SessionImplementor
public Type getFilterParameterType(String filterParameterName)
- Specified by:
- getFilterParameterType in interface SessionImplementor
public Object getFilterParameterValue(String filterParameterName)
- Specified by:
- getFilterParameterValue in interface SessionImplementor
public FlushMode getFlushMode()
Get the current flush mode for this session.
- Specified by:
- getFlushMode in interface SessionImplementor
- getFlushMode in interface Session
- Returns:
- The flush mode
public Serializable getIdentifier(Object object) throws HibernateException
Return the identifier value of the given entity as associated with this session. An exception is thrown if the given entity instance is transient or detached in relation to this session.
- Specified by:
- getIdentifier in interface Session
- Parameters:
object
- a persistent instance
- Returns:
- the identifier
public Interceptor getInterceptor()
- Specified by:
- getInterceptor in interface SessionImplementor
public JDBCContext getJDBCContext()
- Specified by:
- getJDBCContext in interface SessionImplementor
public EventListeners getListeners()
- Specified by:
- getListeners in interface SessionImplementor
public Query getNamedQuery(String queryName) throws MappingException
Obtain an instance of Query for a named query string defined in the mapping file.
- Specified by:
- getNamedQuery in interface SessionImplementor
- getNamedQuery in interface Session
- Overrides:
- getNamedQuery in interface AbstractSessionImpl
- Parameters:
queryName
- the name of a query defined externally
- Returns:
- Query
public PersistenceContext getPersistenceContext()
- Specified by:
- getPersistenceContext in interface SessionImplementor
public Session getSession(EntityMode entityMode)
Starts a new Session with the given entity mode in effect. This secondary Session inherits the connection, transaction, and other context information from the primary Session. It doesn't need to be flushed or closed by the developer.
- Specified by:
- getSession in interface Session
- Parameters:
entityMode
- The entity mode to use for the new session.
- Returns:
- The new session
public SessionFactory getSessionFactory()
Get the session factory which created this session.
- Specified by:
- getSessionFactory in interface Session
- Returns:
- The session factory.
- See Also:
SessionFactory
public SessionStatistics getStatistics()
Get the statistics for this session.
- Specified by:
- getStatistics in interface Session
public Transaction getTransaction() throws HibernateException
Get the Transaction instance associated with this session. The class of the returned Transaction object is determined by the property hibernate.transaction_factory.
- Specified by:
- getTransaction in interface Session
- Returns:
- a Transaction instance
- Throws:
HibernateException
-
- See Also:
Transaction
public String guessEntityName(Object object) throws HibernateException
- Specified by:
- guessEntityName in interface SessionImplementor
public Object immediateLoad(String entityName, Serializable id) throws HibernateException
Load the data for the object with the specified id into a newly created object. This is only called when lazily initializing a proxy. Do NOT return a proxy.
- Specified by:
- immediateLoad in interface SessionImplementor
public void initializeCollection(PersistentCollection collection, boolean writing) throws HibernateException
- Specified by:
- initializeCollection in interface SessionImplementor
public Object instantiate(String entityName, Serializable id) throws HibernateException
- Specified by:
- instantiate in interface SessionImplementor
public Object instantiate(EntityPersister persister, Serializable id) throws HibernateException
give the interceptor an opportunity to override the default instantiation
- Specified by:
- instantiate in interface EventSource
public Object internalLoad(String entityName, Serializable id, boolean eager, boolean nullable) throws HibernateException
- Specified by:
- internalLoad in interface SessionImplementor
public boolean isAutoCloseSessionEnabled()
- Specified by:
- isAutoCloseSessionEnabled in interface JDBCContext.Context
public boolean isConnected()
Check if the session is currently connected.
- Specified by:
- isConnected in interface SessionImplementor
- isConnected in interface Session
- Returns:
- boolean
public boolean isDirty() throws HibernateException
Does this session contain any changes which must be synchronized with the database? In other words, would any DML operations be executed if we flushed this session?
- Returns:
- True if the session contains pending changes; false otherwise.
- Throws:
HibernateException
- could not perform dirtying checking
public boolean isEventSource()
- Specified by:
- isEventSource in interface SessionImplementor
public boolean isFlushBeforeCompletionEnabled()
- Specified by:
- isFlushBeforeCompletionEnabled in interface TransactionFactory.Context
public boolean isFlushModeNever()
- Specified by:
- isFlushModeNever in interface TransactionFactory.Context
public boolean isOpen()
Check if the session is still open.
- Specified by:
- isOpen in interface SessionImplementor
- isOpen in interface Session
- Returns:
- boolean
public boolean isTransactionInProgress()
- Specified by:
- isTransactionInProgress in interface SessionImplementor
public Iterator iterate(String query) throws HibernateException
Deprecated. use
Session
.Query.iterate()
Execute a query and return the results in an iterator. If the query has multiple return values, values will be returned in an array of type Object[].
Entities returned as results are initialized on demand. The first SQL query returns identifiers only. So iterate() is usually a less efficient way to retrieve objects than find().
- Parameters:
query
- the query string
- Returns:
- an iterator
- Throws:
HibernateException
-
public Iterator iterate(String query, Object value, Type type) throws HibernateException
Deprecated. use
Session
.setXYZ.Query.iterate()
Execute a query and return the results in an iterator. Write the given value to "?" in the query string. If the query has multiple return values, values will be returned in an array of type Object[].
Entities returned as results are initialized on demand. The first SQL query returns identifiers only. So iterate() is usually a less efficient way to retrieve objects than find().
- Parameters:
query
- the query stringvalue
- a value to be witten to a "?" placeholder in the query stringtype
- the hibernate type of value
- Returns:
- an iterator
- Throws:
HibernateException
-
public Iterator iterate(String query, Object[] values, Type[] types) throws HibernateException
Deprecated. use
Session
.setXYZ.Query.iterate()
Execute a query and return the results in an iterator. Write the given values to "?" in the query string. If the query has multiple return values, values will be returned in an array of type Object[].
Entities returned as results are initialized on demand. The first SQL query returns identifiers only. So iterate() is usually a less efficient way to retrieve objects than find().
- Parameters:
query
- the query stringvalues
- a list of values to be written to "?" placeholders in the querytypes
- a list of Hibernate types of the values
- Returns:
- an iterator
- Throws:
HibernateException
-
public Iterator iterate(String query, QueryParameters queryParameters) throws HibernateException
- Specified by:
- iterate in interface SessionImplementor
public Iterator iterateFilter(Object collection, String filter, QueryParameters queryParameters) throws HibernateException
- Specified by:
- iterateFilter in interface SessionImplementor
public List list(String query, QueryParameters queryParameters) throws HibernateException
- Specified by:
- list in interface SessionImplementor
public List list(CriteriaImpl criteria) throws HibernateException
- Specified by:
- list in interface SessionImplementor
public List listCustomQuery(CustomQuery customQuery, QueryParameters queryParameters) throws HibernateException
- Specified by:
- listCustomQuery in interface SessionImplementor
public List listFilter(Object collection, String filter, QueryParameters queryParameters) throws HibernateException
- Specified by:
- listFilter in interface SessionImplementor
public Object load(Class entityClass, Serializable id) throws HibernateException
Return the persistent instance of the given entity class 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 (use get() instead). Use this only to retrieve an instance that you assume exists, where non-existence would be an actual error.
- Parameters:
id
- a valid identifier of an existing persistent instance of the class
- Returns:
- the persistent instance or proxy
- Throws:
HibernateException
-
public Object load(Class entityClass, Serializable id, LockMode lockMode) throws HibernateException
Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.
- Parameters:
id
- a valid identifier of an existing persistent instance of the classlockMode
- the lock level
- Returns:
- the persistent instance or proxy
- Throws:
HibernateException
-
public void load(Object object, Serializable id) throws HibernateException
Read the persistent state associated with the given identifier into the given transient instance.
- Parameters:
object
- an "empty" instance of the persistent classid
- a valid identifier of an existing persistent instance of the class
- Throws:
HibernateException
-
public Object load(String entityName, Serializable id) throws HibernateException
Return the persistent instance of the given entity class 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 (use get() instead). Use this only to retrieve an instance that you assume exists, where non-existence would be an actual error.
- Parameters:
entityName
- a persistent classid
- a valid identifier of an existing persistent instance of the class
- Returns:
- the persistent instance or proxy
- Throws:
HibernateException
-
public Object load(String entityName, Serializable id, LockMode lockMode) throws HibernateException
Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.
- Parameters:
entityName
- a persistent classid
- a valid identifier of an existing persistent instance of the classlockMode
- the lock level
- Returns:
- the persistent instance or proxy
- Throws:
HibernateException
-
public void lock(Object object, LockMode lockMode) throws HibernateException
Obtain the specified lock level upon the given object. This may be used to perform a version check (LockMode.READ), to upgrade to a pessimistic lock (LockMode.UPGRADE), or to simply reassociate a transient instance with a session (LockMode.NONE). This operation cascades to associated instances if the association is mapped with cascade="lock".
- Parameters:
object
- a persistent or transient instancelockMode
- the lock level
- Throws:
HibernateException
-
public void lock(String entityName, Object object, LockMode lockMode) throws HibernateException
Obtain the specified lock level upon the given object. This may be used to perform a version check (LockMode.READ), to upgrade to a pessimistic lock (LockMode.UPGRADE), or to simply reassociate a transient instance with a session (LockMode.NONE). This operation cascades to associated instances if the association is mapped with cascade="lock".
- Parameters:
object
- a persistent or transient instancelockMode
- the lock level
- Throws:
HibernateException
-
public void managedClose()
- Specified by:
- managedClose in interface TransactionFactory.Context
public void managedFlush()
- Specified by:
- managedFlush in interface TransactionFactory.Context
public Object merge(Object object) throws HibernateException
Copy the state of the given object onto the persistent object with the same identifier. If there is no persistent instance currently associated with the session, it will be loaded. Return the persistent instance. If the given instance is unsaved, save a copy of and return it as a newly persistent instance. The given instance does not become associated with the session. This operation cascades to associated instances if the association is mapped with cascade="merge".
The semantics of this method are defined by JSR-220.
- Parameters:
object
- a detached instance with state to be copied
- Returns:
- an updated persistent instance
public Object merge(String entityName, Object object) throws HibernateException
Copy the state of the given object onto the persistent object with the same identifier. If there is no persistent instance currently associated with the session, it will be loaded. Return the persistent instance. If the given instance is unsaved, save a copy of and return it as a newly persistent instance. The given instance does not become associated with the session. This operation cascades to associated instances if the association is mapped with cascade="merge".
The semantics of this method are defined by JSR-220.
- Parameters:
object
- a detached instance with state to be copied
- Returns:
- an updated persistent instance
public void merge(String entityName, Object object, Map copiedAlready) throws HibernateException
Cascade merge an entity instance
- Specified by:
- merge in interface EventSource
public void persist(Object object) throws HibernateException
Make a transient instance persistent. This operation cascades to associated instances if the association is mapped with cascade="persist".
The semantics of this method are defined by JSR-220.
- Parameters:
object
- a transient instance to be made persistent
public void persist(String entityName, Object object) throws HibernateException
Make a transient instance persistent. This operation cascades to associated instances if the association is mapped with cascade="persist".
The semantics of this method are defined by JSR-220.
- Parameters:
object
- a transient instance to be made persistent
public void persist(String entityName, Object object, Map copiedAlready) throws HibernateException
Cascade persist an entity instance
- Specified by:
- persist in interface EventSource
public void persistOnFlush(String entityName, Object object) throws HibernateException
public void persistOnFlush(String entityName, Object object, Map copiedAlready) throws HibernateException
Cascade persist an entity instance during the flush process
- Specified by:
- persistOnFlush in interface EventSource
public void reconnect() throws HibernateException
Deprecated. Manual reconnection is only needed in the case of application-supplied connections, in which case the
reconnect(java.sql.Connection)
for should be used.Obtain a new JDBC connection. This is used by applications which require long transactions and do not supply connections to the session.
- See Also:
Session.disconnect()
public void reconnect(Connection conn) throws HibernateException
Reconnect to the given JDBC connection. This is used by applications which require long transactions and use application-supplied connections.
- Parameters:
- See Also:
Session.disconnect()
public void refresh(Object object) throws HibernateException
Re-read the state of the given instance from the underlying database. It is inadvisable to use this to implement long-running sessions that span many business tasks. This method is, however, useful in certain special circumstances. For example
- where a database trigger alters the object state upon insert or update
- after executing direct SQL (eg. a mass update) in the same session
- after inserting a Blob or Clob
- Parameters:
object
- a persistent or detached instance
- Throws:
HibernateException
-
public void refresh(Object object, Map refreshedAlready) throws HibernateException
Cascade refesh an entity instance
- Specified by:
- refresh in interface EventSource
public void refresh(Object object, LockMode lockMode) throws HibernateException
Re-read the state of the given instance from the underlying database, with the given LockMode. It is inadvisable to use this to implement long-running sessions that span many business tasks. This method is, however, useful in certain special circumstances.
- Parameters:
object
- a persistent or detached instancelockMode
- the lock mode to use
- Throws:
HibernateException
-
public void replicate(Object obj, ReplicationMode replicationMode) throws HibernateException
Persist the state of the given detached instance, reusing the current identifier value. This operation cascades to associated instances if the association is mapped with cascade="replicate".
- Parameters:
public void replicate(String entityName, Object obj, ReplicationMode replicationMode) throws HibernateException
Persist the state of the given detached instance, reusing the current identifier value. This operation cascades to associated instances if the association is mapped with cascade="replicate".
- Parameters:
public Serializable save(Object obj) throws HibernateException
Persist the given transient instance, first assigning a generated identifier. (Or using the current value of the identifier property if the assigned generator is used.) This operation cascades to associated instances if the association is mapped with cascade="save-update".
- Parameters:
- Returns:
- the generated identifier
- Throws:
HibernateException
-
public void save(Object obj, Serializable id) throws HibernateException
Deprecated. declare identifier properties for all classes
Persist the given transient instance, using the given identifier. This operation cascades to associated instances if the association is mapped with cascade="save-update".
- Parameters:
id
- an unused valid identifier
- Throws:
HibernateException
-
public Serializable save(String entityName, Object object) throws HibernateException
Persist the given transient instance, first assigning a generated identifier. (Or using the current value of the identifier property if the assigned generator is used.) This operation cascades to associated instances if the association is mapped with cascade="save-update".
- Parameters:
object
- a transient instance of a persistent class
- Returns:
- the generated identifier
- Throws:
HibernateException
-
public void save(String entityName, Object object, Serializable id) throws HibernateException
Deprecated. declare identifier properties for all classes
Persist the given transient instance, using the given identifier. This operation cascades to associated instances if the association is mapped with cascade="save-update".
- Parameters:
object
- a transient instance of a persistent classid
- an unused valid identifier
- Throws:
HibernateException
-
public void saveOrUpdate(Object object) throws HibernateException
EitherSession.save(Object)
orSession.update(Object)
the given instance, depending upon resolution of the unsaved-value checks (see the manual for discussion of unsaved-value checking). This operation cascades to associated instances if the association is mapped with cascade="save-update".
- Specified by:
- saveOrUpdate in interface Session
- Parameters:
object
- a transient or detached instance containing new or updated state
- Throws:
HibernateException
-
- See Also:
Session.save(java.lang.Object)
,Session.update(Object object)
public void saveOrUpdate(String entityName, Object obj) throws HibernateException
EitherSession.save(String,Object)
orSession.update(String,Object)
the given instance, depending upon resolution of the unsaved-value checks (see the manual for discussion of unsaved-value checking). This operation cascades to associated instances if the association is mapped with cascade="save-update".
- Specified by:
- saveOrUpdate in interface Session
- Parameters:
- Throws:
HibernateException
-
public Object saveOrUpdateCopy(Object object) throws HibernateException
Deprecated. use
Session.merge(Object)
Copy the state of the given object onto the persistent object with the same identifier. If there is no persistent instance currently associated with the session, it will be loaded. Return the persistent instance. If the given instance is unsaved or does not exist in the database, save it and return it as a newly persistent instance. Otherwise, the given instance does not become associated with the session.
- Specified by:
- saveOrUpdateCopy in interface Session
- Parameters:
object
- a transient instance with state to be copied
- Returns:
- an updated persistent instance
public Object saveOrUpdateCopy(Object object, Serializable id) throws HibernateException
Deprecated. with no replacement
Copy the state of the given object onto the persistent object with the given identifier. If there is no persistent instance currently associated with the session, it will be loaded. Return the persistent instance. If there is no database row with the given identifier, save the given instance and return it as a newly persistent instance. Otherwise, the given instance does not become associated with the session.
- Specified by:
- saveOrUpdateCopy in interface Session
- Parameters:
object
- a persistent or transient instance with state to be copiedid
- the identifier of the instance to copy to
- Returns:
- an updated persistent instance
public Object saveOrUpdateCopy(String entityName, Object object) throws HibernateException
Deprecated. use
Session.merge(String,Object)
Copy the state of the given object onto the persistent object with the same identifier. If there is no persistent instance currently associated with the session, it will be loaded. Return the persistent instance. If the given instance is unsaved or does not exist in the database, save it and return it as a newly persistent instance. Otherwise, the given instance does not become associated with the session.
- Specified by:
- saveOrUpdateCopy in interface Session
- Parameters:
object
- a transient instance with state to be copied
- Returns:
- an updated persistent instance
public void saveOrUpdateCopy(String entityName, Object object, Map copiedAlready) throws HibernateException
Cascade copy an entity instance
- Specified by:
- saveOrUpdateCopy in interface EventSource
public Object saveOrUpdateCopy(String entityName, Object object, Serializable id) throws HibernateException
Deprecated. with no replacement
Copy the state of the given object onto the persistent object with the given identifier. If there is no persistent instance currently associated with the session, it will be loaded. Return the persistent instance. If there is no database row with the given identifier, save the given instance and return it as a newly persistent instance. Otherwise, the given instance does not become associated with the session.
- Specified by:
- saveOrUpdateCopy in interface Session
- Parameters:
object
- a persistent or transient instance with state to be copiedid
- the identifier of the instance to copy to
- Returns:
- an updated persistent instance
public ScrollableResults scroll(String query, QueryParameters queryParameters) throws HibernateException
- Specified by:
- scroll in interface SessionImplementor
public ScrollableResults scroll(CriteriaImpl criteria, ScrollMode scrollMode)
- Specified by:
- scroll in interface SessionImplementor
public ScrollableResults scrollCustomQuery(CustomQuery customQuery, QueryParameters queryParameters) throws HibernateException
- Specified by:
- scrollCustomQuery in interface SessionImplementor
public void setAutoClear(boolean enabled)
- Specified by:
- setAutoClear in interface SessionImplementor
public void setCacheMode(CacheMode cacheMode)
Set the cache mode. Cache mode determines the manner in which this session can interact with the second level cache.
- Specified by:
- setCacheMode in interface SessionImplementor
- setCacheMode in interface Session
- Parameters:
cacheMode
- The new cache mode.
public void setFetchProfile(String fetchProfile)
- Specified by:
- setFetchProfile in interface SessionImplementor
public void setFlushMode(FlushMode flushMode)
Set the flush mode for this session. The flush mode determines the points at which the session is flushed. Flushing is the process of synchronizing the underlying persistent store with persistable state held in memory. For a logically "read only" session, it is reasonable to set the session's flush mode toFlushMode.MANUAL
at the start of the session (in order to achieve some extra performance).
- Specified by:
- setFlushMode in interface SessionImplementor
- setFlushMode in interface Session
- Parameters:
flushMode
- the new flush mode
- See Also:
FlushMode
public void setReadOnly(Object entity, boolean readOnly)
Set an unmodified persistent object to read only mode, or a read only object to modifiable mode. In read only mode, no snapshot is maintained and the instance is never dirty checked.
- Specified by:
- setReadOnly in interface Session
- See Also:
Query.setReadOnly(boolean)
public boolean shouldAutoClose()
- Specified by:
- shouldAutoClose in interface TransactionFactory.Context
public String toString()
public void update(Object obj) throws HibernateException
Update the persistent instance with the identifier of the given detached instance. If there is a persistent instance with the same identifier, an exception is thrown. This operation cascades to associated instances if the association is mapped with cascade="save-update".
- Parameters:
- Throws:
HibernateException
-
public void update(Object obj, Serializable id) throws HibernateException
Deprecated. declare identifier properties for all classes
Update the persistent state associated with the given identifier. An exception is thrown if there is a persistent instance with the same identifier in the current session. This operation cascades to associated instances if the association is mapped with cascade="save-update".
- Parameters:
id
- identifier of persistent instance
- Throws:
HibernateException
-
public void update(String entityName, Object object) throws HibernateException
Update the persistent instance with the identifier of the given detached instance. If there is a persistent instance with the same identifier, an exception is thrown. This operation cascades to associated instances if the association is mapped with cascade="save-update".
- Parameters:
object
- a detached instance containing updated state
- Throws:
HibernateException
-
public void update(String entityName, Object object, Serializable id) throws HibernateException
Deprecated. declare identifier properties for all classes
Update the persistent state associated with the given identifier. An exception is thrown if there is a persistent instance with the same identifier in the current session. This operation cascades to associated instances if the association is mapped with cascade="save-update".
- Parameters:
object
- a detached instance containing updated stateid
- identifier of persistent instance
- Throws:
HibernateException
-