org.hibernate.impl

Class SessionImpl

Implemented Interfaces:
EventSource, Serializable, JDBCContext.Context, Session, Session, SessionImplementor, TransactionFactory.Context

public final class SessionImpl
extends AbstractSessionImpl
implements EventSource, Session, JDBCContext.Context

Concrete implementation of a Session, and also the central, organizing component of Hibernate's internal implementation. As such, this class exposes two interfaces; Session itself, to the application, and SessionImplementor, to other components of Hibernate. This class is not threadsafe.
Author:
Gavin King

Field Summary

Fields inherited from class org.hibernate.impl.AbstractSessionImpl

factory

Method Summary

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
void
afterScrollOperation()
void
afterTransactionBegin(Transaction tx)
We cannot rely upon this method being called! It is only called if we are using Hibernate Transaction API.
void
afterTransactionCompletion(boolean success, Transaction tx)
protected boolean
autoFlushIfRequired(Set querySpaces)
detect in-memory changes, determine if the changes are to tables named in the query and, if so, complete execution the flush
void
beforeTransactionCompletion(Transaction tx)
Transaction
beginTransaction()
Begin a unit of work and return the associated Transaction object.
String
bestGuessEntityName(Object object)
void
cancelQuery()
Cancel the execution of the current query.
void
clear()
Completely clear the session.
Connection
close()
End the session by releasing the JDBC connection and cleaning up.
Connection
connection()
Deprecated. (scheduled for removal in 4.x).
boolean
contains(Object object)
Check if this instance is associated with this Session.
Criteria
createCriteria(Class persistentClass)
Create a new Criteria instance, for the given entity class, or a superclass of an entity class.
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.
Criteria
createCriteria(String entityName)
Create a new Criteria instance, for the given entity name.
Criteria
createCriteria(String entityName, String alias)
Create a new Criteria instance, for the given entity name, with the given alias.
Query
createFilter(Object collection, String queryString)
Create a new instance of Query for the given collection and filter string.
Query
createQuery(String queryString)
Create a new instance of Query for the given HQL query string.
SQLQuery
createSQLQuery(String sql)
Create a new instance of SQLQuery for the given SQL query string.
Query
createSQLQuery(String sql, String returnAlias, Class returnClass)
Deprecated. will be replaced with a more Query like interface in later release
Query
createSQLQuery(String sql, returnAliases[] , returnClasses[] )
void
delete(Object object)
Delete a persistent object
int
delete(String query)
Deprecated. consider using HQL delete statements
void
delete(String entityName, Object object)
Delete a persistent object (by explicit entity name)
void
delete(String entityName, Object object, boolean isCascadeDeleteEnabled, Set transientEntities)
Delete a persistent object
int
delete(String query, Object value, Type type)
Deprecated. consider using HQL delete statements
int
delete(String query, Object[] values, Type[] types)
Deprecated. consider using HQL delete statements
void
disableFilter(String filterName)
Disable the named filter for the current session.
Connection
disconnect()
Disconnect the Session from the current JDBC connection.
void
doWork(Work work)
Controller for allowing users to perform JDBC related work using the Connection managed by this Session.
Filter
enableFilter(String filterName)
Enable the named filter for this current session.
void
evict(Object object)
remove any hard references to the entity that are held by the infrastructure (references held by application or other persistant instances are okay)
int
executeNativeUpdate(NativeSQLQuerySpecification nativeQuerySpecification, QueryParameters queryParameters)
int
executeUpdate(String query, QueryParameters queryParameters)
Collection
filter(Object collection, String filter)
Deprecated. use createFilter(Object, String).Query.list()
Collection
filter(Object collection, String filter, Object value, Type type)
Deprecated. use createFilter(Object, String).setXYZ.Query.list()
Collection
filter(Object collection, String filter, Object[] values, Type[] types)
Deprecated. use createFilter(Object, String).setXYZ.Query.list()
List
find(String query)
Retrieve a list of persistent objects using a hibernate query
List
find(String query, Object value, Type type)
Deprecated. use Session.setXYZ.Query.list()
List
find(String query, Object[] values, Type[] types)
Deprecated. use Session.setXYZ.Query.list()
void
flush()
Force this session to flush.
void
forceFlush(EntityEntry entityEntry)
Force an immediate flush
Object
get(Class entityClass, Serializable id)
Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance.
Object
get(Class entityClass, Serializable id, LockMode lockMode)
Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance.
Object
get(String entityName, Serializable id)
Return the persistent instance of the given named entity with the given identifier, or null if there is no such persistent instance.
Object
get(String entityName, Serializable id, LockMode lockMode)
Return the persistent instance of the given entity class with the given identifier, or null if there is no such persistent instance.
ActionQueue
getActionQueue()
Get the ActionQueue for this session
Batcher
getBatcher()
CacheMode
getCacheMode()
Get the current cache mode.
ConnectionReleaseMode
getConnectionReleaseMode()
Serializable
getContextEntityIdentifier(Object object)
Get the id value for an object that is actually associated with the session.
LockMode
getCurrentLockMode(Object object)
Determine the current lock mode of the given object.
int
getDontFlushFromFind()
Filter
getEnabledFilter(String filterName)
Retrieve a currently enabled filter by name.
Map
getEnabledFilters()
EntityMode
getEntityMode()
Retrieve the entity mode in effect for this session.
String
getEntityName(Object object)
Return the entity name for a persistent entity
EntityPersister
getEntityPersister(String entityName, Object object)
Object
getEntityUsingInterceptor(EntityKey key)
String
getFetchProfile()
Type
getFilterParameterType(String filterParameterName)
Object
getFilterParameterValue(String filterParameterName)
FlushMode
getFlushMode()
Get the current flush mode for this session.
Serializable
getIdentifier(Object object)
Return the identifier value of the given entity as associated with this session.
Interceptor
getInterceptor()
JDBCContext
getJDBCContext()
EventListeners
getListeners()
Query
getNamedQuery(String queryName)
Obtain an instance of Query for a named query string defined in the mapping file.
PersistenceContext
getPersistenceContext()
Session
getSession(EntityMode entityMode)
Starts a new Session with the given entity mode in effect.
SessionFactory
getSessionFactory()
Get the session factory which created this session.
SessionStatistics
getStatistics()
Get the statistics for this session.
long
getTimestamp()
Transaction
getTransaction()
Get the Transaction instance associated with this session.
String
guessEntityName(Object object)
Object
immediateLoad(String entityName, Serializable id)
Load the data for the object with the specified id into a newly created object.
void
initializeCollection(PersistentCollection collection, boolean writing)
Object
instantiate(String entityName, Serializable id)
Object
instantiate(EntityPersister persister, Serializable id)
give the interceptor an opportunity to override the default instantiation
Object
internalLoad(String entityName, Serializable id, boolean eager, boolean nullable)
boolean
isAutoCloseSessionEnabled()
boolean
isConnected()
Check if the session is currently connected.
boolean
isDirty()
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?
boolean
isEventSource()
boolean
isFlushBeforeCompletionEnabled()
boolean
isFlushModeNever()
boolean
isOpen()
Check if the session is still open.
boolean
isTransactionInProgress()
Iterator
iterate(String query)
Deprecated. use Session.Query.iterate()
Iterator
iterate(String query, Object value, Type type)
Deprecated. use Session.setXYZ.Query.iterate()
Iterator
iterate(String query, Object[] values, Type[] types)
Deprecated. use Session.setXYZ.Query.iterate()
Iterator
iterate(String query, QueryParameters queryParameters)
Iterator
iterateFilter(Object collection, String filter, QueryParameters queryParameters)
List
list(String query, QueryParameters queryParameters)
List
list(CriteriaImpl criteria)
List
listCustomQuery(CustomQuery customQuery, QueryParameters queryParameters)
List
listFilter(Object collection, String filter, QueryParameters queryParameters)
Object
load(Class entityClass, Serializable id)
Return the persistent instance of the given entity class with the given identifier, assuming that the instance exists.
Object
load(Class entityClass, Serializable id, LockMode lockMode)
Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.
void
load(Object object, Serializable id)
Read the persistent state associated with the given identifier into the given transient instance.
Object
load(String entityName, Serializable id)
Return the persistent instance of the given entity class with the given identifier, assuming that the instance exists.
Object
load(String entityName, Serializable id, LockMode lockMode)
Return the persistent instance of the given entity class with the given identifier, obtaining the specified lock mode, assuming the instance exists.
void
lock(Object object, LockMode lockMode)
Obtain the specified lock level upon the given object.
void
lock(String entityName, Object object, LockMode lockMode)
Obtain the specified lock level upon the given object.
void
managedClose()
void
managedFlush()
Object
merge(Object object)
Copy the state of the given object onto the persistent object with the same identifier.
Object
merge(String entityName, Object object)
Copy the state of the given object onto the persistent object with the same identifier.
void
merge(String entityName, Object object, Map copiedAlready)
Cascade merge an entity instance
void
persist(Object object)
Make a transient instance persistent.
void
persist(String entityName, Object object)
Make a transient instance persistent.
void
persist(String entityName, Object object, Map copiedAlready)
Cascade persist an entity instance
void
persistOnFlush(Object object)
void
persistOnFlush(String entityName, Object object)
void
persistOnFlush(String entityName, Object object, Map copiedAlready)
Cascade persist an entity instance during the flush process
void
reconnect()
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.
void
reconnect(Connection conn)
Reconnect to the given JDBC connection.
void
refresh(Object object)
Re-read the state of the given instance from the underlying database.
void
refresh(Object object, Map refreshedAlready)
Cascade refesh an entity instance
void
refresh(Object object, LockMode lockMode)
Re-read the state of the given instance from the underlying database, with the given LockMode.
void
replicate(Object obj, ReplicationMode replicationMode)
Persist the state of the given detached instance, reusing the current identifier value.
void
replicate(String entityName, Object obj, ReplicationMode replicationMode)
Persist the state of the given detached instance, reusing the current identifier value.
Serializable
save(Object obj)
Persist the given transient instance, first assigning a generated identifier.
void
save(Object obj, Serializable id)
Deprecated. declare identifier properties for all classes
Serializable
save(String entityName, Object object)
Persist the given transient instance, first assigning a generated identifier.
void
save(String entityName, Object object, Serializable id)
Deprecated. declare identifier properties for all classes
void
saveOrUpdate(Object object)
Either Session.save(Object) or Session.update(Object) the given instance, depending upon resolution of the unsaved-value checks (see the manual for discussion of unsaved-value checking).
void
saveOrUpdate(String entityName, Object obj)
Either Session.save(String,Object) or Session.update(String,Object) the given instance, depending upon resolution of the unsaved-value checks (see the manual for discussion of unsaved-value checking).
Object
saveOrUpdateCopy(Object object)
Deprecated. use Session.merge(Object)
Object
saveOrUpdateCopy(Object object, Serializable id)
Deprecated. with no replacement
Object
saveOrUpdateCopy(String entityName, Object object)
Deprecated. use Session.merge(String,Object)
void
saveOrUpdateCopy(String entityName, Object object, Map copiedAlready)
Cascade copy an entity instance
Object
saveOrUpdateCopy(String entityName, Object object, Serializable id)
Deprecated. with no replacement
ScrollableResults
scroll(String query, QueryParameters queryParameters)
ScrollableResults
scroll(CriteriaImpl criteria, ScrollMode scrollMode)
ScrollableResults
scrollCustomQuery(CustomQuery customQuery, QueryParameters queryParameters)
void
setAutoClear(boolean enabled)
void
setCacheMode(CacheMode cacheMode)
Set the cache mode.
void
setFetchProfile(String fetchProfile)
void
setFlushMode(FlushMode flushMode)
Set the flush mode for this session.
void
setReadOnly(Object entity, boolean readOnly)
Set an unmodified persistent object to read only mode, or a read only object to modifiable mode.
boolean
shouldAutoClose()
String
toString()
void
update(Object obj)
Update the persistent instance with the identifier of the given detached instance.
void
update(Object obj, Serializable id)
Deprecated. declare identifier properties for all classes
void
update(String entityName, Object object)
Update the persistent instance with the identifier of the given detached instance.
void
update(String entityName, Object object, Serializable id)
Deprecated. declare identifier properties for all classes

Methods inherited from class org.hibernate.impl.AbstractSessionImpl

createQuery, createSQLQuery, errorIfClosed, getFactory, getHQLQueryPlan, getNamedQuery, getNamedSQLQuery, getNativeSQLQueryPlan, isClosed, list, scroll, setClosed

Method Details

afterOperation

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

afterScrollOperation

public void afterScrollOperation()
Specified by:
afterScrollOperation in interface SessionImplementor

afterTransactionBegin

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

afterTransactionCompletion

public void afterTransactionCompletion(boolean success,
                                       Transaction tx)
Specified by:
afterTransactionCompletion in interface SessionImplementor
afterTransactionCompletion in interface JDBCContext.Context

autoFlushIfRequired

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

beforeTransactionCompletion

public void beforeTransactionCompletion(Transaction tx)
Specified by:
beforeTransactionCompletion in interface SessionImplementor
beforeTransactionCompletion in interface JDBCContext.Context

beginTransaction

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
See Also:
Transaction

bestGuessEntityName

public String bestGuessEntityName(Object object)
Specified by:
bestGuessEntityName in interface SessionImplementor

cancelQuery

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

clear

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.
Specified by:
clear in interface Session

close

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 least Session.disconnect() it.
Specified by:
close in interface Session
Returns:
the connection provided by the application or null.
Throws:
HibernateException - Indicates problems cleaning up.

connection

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

contains

public boolean contains(Object object)
Check if this instance is associated with this Session.
Specified by:
contains in interface Session
Parameters:
object - an instance of a persistent class
Returns:
true if the given instance is associated with this Session

createCriteria

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

createCriteria

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

createCriteria

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

createCriteria

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

createFilter

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 collection
queryString - a Hibernate query
Returns:
Query

createQuery

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

createSQLQuery

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

createSQLQuery

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 SQL
returnAlias - a table alias that appears inside {} in the SQL string
returnClass - the returned persistent class

createSQLQuery

public Query createSQLQuery(String sql,
                            returnAliases[] ,
                            returnClasses[] )

delete

public void delete(Object object)
            throws HibernateException
Delete a persistent object
Specified by:
delete in interface Session

delete

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 calling delete(Object) individually.

Specified by:
delete in interface Session
Parameters:
query - the query string
Returns:
the number of instances deleted

delete

public void delete(String entityName,
                   Object object)
            throws HibernateException
Delete a persistent object (by explicit entity name)
Specified by:
delete in interface Session

delete

public void delete(String entityName,
                   Object object,
                   boolean isCascadeDeleteEnabled,
                   Set transientEntities)
            throws HibernateException
Delete a persistent object
Specified by:
delete in interface EventSource

delete

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 calling delete(Object) individually.

Specified by:
delete in interface Session
Parameters:
query - the query string
value - a value to be witten to a "?" placeholder in the query string.
type - the hibernate type of value.
Returns:
the number of instances deleted

delete

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 calling delete(Object) individually.

Specified by:
delete in interface Session
Parameters:
query - the query string
values - 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

disableFilter

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.

disconnect

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 configured ConnectionProvider has no effect, provided ConnectionReleaseMode.ON_CLOSE is not in effect.

Specified by:
disconnect in interface Session
Returns:
the application-supplied connection or null

doWork

public void doWork(Work work)
            throws HibernateException
Controller for allowing users to perform JDBC related work using the Connection managed by this Session.
Specified by:
doWork in interface Session
Parameters:
work - The work to be performed.
Throws:
HibernateException - Generally indicates wrapped java.sql.SQLException

enableFilter

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.

evict

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)
Specified by:
evict in interface Session

executeNativeUpdate

public int executeNativeUpdate(NativeSQLQuerySpecification nativeQuerySpecification,
                               QueryParameters queryParameters)
            throws HibernateException
Specified by:
executeNativeUpdate in interface SessionImplementor

executeUpdate

public int executeUpdate(String query,
                         QueryParameters queryParameters)
            throws HibernateException
Specified by:
executeUpdate in interface SessionImplementor

filter

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.)
Specified by:
filter in interface Session
Parameters:
collection - a persistent collection to filter
filter - a filter query string
Returns:
Collection the resulting collection

filter

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.
Specified by:
filter in interface Session
Parameters:
collection - a persistent collection to filter
filter - a filter query string
value - a value to be witten to a "?" placeholder in the query string
type - the hibernate type of value
Returns:
Collection

filter

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.
Specified by:
filter in interface Session
Parameters:
collection - a persistent collection to filter
filter - a filter query string
values - a list of values to be written to "?" placeholders in the query
types - a list of Hibernate types of the values
Returns:
Collection

find

public List find(String query)
            throws HibernateException
Retrieve a list of persistent objects using a hibernate query
Specified by:
find in interface Session

find

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.
Specified by:
find in interface Session
Parameters:
query - the query string
value - 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)

find

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.
Specified by:
find in interface Session
Parameters:
query - the query string
values - 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

flush

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 on flush-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.

forceFlush

public void forceFlush(EntityEntry entityEntry)
            throws HibernateException
Force an immediate flush
Specified by:
forceFlush in interface EventSource

get

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.
Specified by:
get in interface Session
Parameters:
id - an identifier
Returns:
a persistent instance or null

get

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.
Specified by:
get in interface Session
Parameters:
id - an identifier
lockMode - the lock mode
Returns:
a persistent instance or null

get

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.)
Specified by:
get in interface Session
Parameters:
entityName - the entity name
id - an identifier
Returns:
a persistent instance or null

get

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.
Specified by:
get in interface Session
Parameters:
entityName - the entity name
id - an identifier
lockMode - the lock mode
Returns:
a persistent instance or null

getActionQueue

public ActionQueue getActionQueue()
Get the ActionQueue for this session
Specified by:
getActionQueue in interface EventSource

getBatcher

public Batcher getBatcher()
Specified by:
getBatcher in interface SessionImplementor

getCacheMode

public CacheMode getCacheMode()
Get the current cache mode.
Specified by:
getCacheMode in interface SessionImplementor
getCacheMode in interface Session
Returns:
The current cache mode.

getConnectionReleaseMode

public ConnectionReleaseMode getConnectionReleaseMode()
Specified by:
getConnectionReleaseMode in interface JDBCContext.Context

getContextEntityIdentifier

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

getCurrentLockMode

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

getDontFlushFromFind

public int getDontFlushFromFind()
Specified by:
getDontFlushFromFind in interface SessionImplementor

getEnabledFilter

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.

getEnabledFilters

public Map getEnabledFilters()
Specified by:
getEnabledFilters in interface SessionImplementor

getEntityMode

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.

getEntityName

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

getEntityPersister

public EntityPersister getEntityPersister(String entityName,
                                          Object object)
Specified by:
getEntityPersister in interface SessionImplementor

getEntityUsingInterceptor

public Object getEntityUsingInterceptor(EntityKey key)
            throws HibernateException
Specified by:
getEntityUsingInterceptor in interface SessionImplementor

getFetchProfile

public String getFetchProfile()
Specified by:
getFetchProfile in interface SessionImplementor

getFilterParameterType

public Type getFilterParameterType(String filterParameterName)
Specified by:
getFilterParameterType in interface SessionImplementor

getFilterParameterValue

public Object getFilterParameterValue(String filterParameterName)
Specified by:
getFilterParameterValue in interface SessionImplementor

getFlushMode

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

getIdentifier

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

getInterceptor

public Interceptor getInterceptor()
Specified by:
getInterceptor in interface SessionImplementor

getJDBCContext

public JDBCContext getJDBCContext()
Specified by:
getJDBCContext in interface SessionImplementor

getListeners

public EventListeners getListeners()
Specified by:
getListeners in interface SessionImplementor

getNamedQuery

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

getPersistenceContext

public PersistenceContext getPersistenceContext()
Specified by:
getPersistenceContext in interface SessionImplementor

getSession

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

getSessionFactory

public SessionFactory getSessionFactory()
Get the session factory which created this session.
Specified by:
getSessionFactory in interface Session
Returns:
The session factory.

getStatistics

public SessionStatistics getStatistics()
Get the statistics for this session.
Specified by:
getStatistics in interface Session

getTimestamp

public long getTimestamp()
Specified by:
getTimestamp in interface SessionImplementor

getTransaction

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
See Also:
Transaction

guessEntityName

public String guessEntityName(Object object)
            throws HibernateException
Specified by:
guessEntityName in interface SessionImplementor

immediateLoad

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

initializeCollection

public void initializeCollection(PersistentCollection collection,
                                 boolean writing)
            throws HibernateException
Specified by:
initializeCollection in interface SessionImplementor

instantiate

public Object instantiate(String entityName,
                          Serializable id)
            throws HibernateException
Specified by:
instantiate in interface SessionImplementor

instantiate

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

internalLoad

public Object internalLoad(String entityName,
                           Serializable id,
                           boolean eager,
                           boolean nullable)
            throws HibernateException
Specified by:
internalLoad in interface SessionImplementor

isAutoCloseSessionEnabled

public boolean isAutoCloseSessionEnabled()
Specified by:
isAutoCloseSessionEnabled in interface JDBCContext.Context

isConnected

public boolean isConnected()
Check if the session is currently connected.
Specified by:
isConnected in interface SessionImplementor
isConnected in interface Session
Returns:
boolean

isDirty

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?
Specified by:
isDirty in interface Session
Returns:
True if the session contains pending changes; false otherwise.
Throws:
HibernateException - could not perform dirtying checking

isEventSource

public boolean isEventSource()
Specified by:
isEventSource in interface SessionImplementor

isFlushBeforeCompletionEnabled

public boolean isFlushBeforeCompletionEnabled()
Specified by:
isFlushBeforeCompletionEnabled in interface TransactionFactory.Context

isFlushModeNever

public boolean isFlushModeNever()
Specified by:
isFlushModeNever in interface TransactionFactory.Context

isOpen

public boolean isOpen()
Check if the session is still open.
Specified by:
isOpen in interface SessionImplementor
isOpen in interface Session
Returns:
boolean

isTransactionInProgress

public boolean isTransactionInProgress()
Specified by:
isTransactionInProgress in interface SessionImplementor

iterate

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().
Specified by:
iterate in interface Session
Parameters:
query - the query string
Returns:
an iterator

iterate

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().
Specified by:
iterate in interface Session
Parameters:
query - the query string
value - a value to be witten to a "?" placeholder in the query string
type - the hibernate type of value
Returns:
an iterator

iterate

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().
Specified by:
iterate in interface Session
Parameters:
query - the query string
values - a list of values to be written to "?" placeholders in the query
types - a list of Hibernate types of the values
Returns:
an iterator

iterate

public Iterator iterate(String query,
                        QueryParameters queryParameters)
            throws HibernateException
Specified by:
iterate in interface SessionImplementor

iterateFilter

public Iterator iterateFilter(Object collection,
                              String filter,
                              QueryParameters queryParameters)
            throws HibernateException
Specified by:
iterateFilter in interface SessionImplementor

list

public List list(String query,
                 QueryParameters queryParameters)
            throws HibernateException
Specified by:
list in interface SessionImplementor

list

public List list(CriteriaImpl criteria)
            throws HibernateException
Specified by:
list in interface SessionImplementor

listCustomQuery

public List listCustomQuery(CustomQuery customQuery,
                            QueryParameters queryParameters)
            throws HibernateException
Specified by:
listCustomQuery in interface SessionImplementor

listFilter

public List listFilter(Object collection,
                       String filter,
                       QueryParameters queryParameters)
            throws HibernateException
Specified by:
listFilter in interface SessionImplementor

load

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.
Specified by:
load in interface Session
Parameters:
id - a valid identifier of an existing persistent instance of the class
Returns:
the persistent instance or proxy

load

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.
Specified by:
load in interface Session
Parameters:
id - a valid identifier of an existing persistent instance of the class
lockMode - the lock level
Returns:
the persistent instance or proxy

load

public void load(Object object,
                 Serializable id)
            throws HibernateException
Read the persistent state associated with the given identifier into the given transient instance.
Specified by:
load in interface Session
Parameters:
object - an "empty" instance of the persistent class
id - a valid identifier of an existing persistent instance of the class

load

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.
Specified by:
load in interface Session
Parameters:
entityName - a persistent class
id - a valid identifier of an existing persistent instance of the class
Returns:
the persistent instance or proxy

load

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.
Specified by:
load in interface Session
Parameters:
entityName - a persistent class
id - a valid identifier of an existing persistent instance of the class
lockMode - the lock level
Returns:
the persistent instance or proxy

lock

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".
Specified by:
lock in interface Session
Parameters:
object - a persistent or transient instance
lockMode - the lock level

lock

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".
Specified by:
lock in interface Session
Parameters:
object - a persistent or transient instance
lockMode - the lock level

managedClose

public void managedClose()
Specified by:
managedClose in interface TransactionFactory.Context

managedFlush

public void managedFlush()
Specified by:
managedFlush in interface TransactionFactory.Context

merge

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.
Specified by:
merge in interface Session
Parameters:
object - a detached instance with state to be copied
Returns:
an updated persistent instance

merge

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.
Specified by:
merge in interface Session
Parameters:
object - a detached instance with state to be copied
Returns:
an updated persistent instance

merge

public void merge(String entityName,
                  Object object,
                  Map copiedAlready)
            throws HibernateException
Cascade merge an entity instance
Specified by:
merge in interface EventSource

persist

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.
Specified by:
persist in interface Session
Parameters:
object - a transient instance to be made persistent

persist

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.
Specified by:
persist in interface Session
Parameters:
object - a transient instance to be made persistent

persist

public void persist(String entityName,
                    Object object,
                    Map copiedAlready)
            throws HibernateException
Cascade persist an entity instance
Specified by:
persist in interface EventSource

persistOnFlush

public void persistOnFlush(Object object)
            throws HibernateException

persistOnFlush

public void persistOnFlush(String entityName,
                           Object object)
            throws HibernateException

persistOnFlush

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

reconnect

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.
Specified by:
reconnect in interface Session

reconnect

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.
Specified by:
reconnect in interface Session
Parameters:

refresh

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
Specified by:
refresh in interface Session
Parameters:
object - a persistent or detached instance

refresh

public void refresh(Object object,
                    Map refreshedAlready)
            throws HibernateException
Cascade refesh an entity instance
Specified by:
refresh in interface EventSource

refresh

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.
Specified by:
refresh in interface Session
Parameters:
object - a persistent or detached instance
lockMode - the lock mode to use

replicate

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".
Specified by:
replicate in interface Session
Parameters:

replicate

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".
Specified by:
replicate in interface Session
Parameters:

save

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".
Specified by:
save in interface Session
Parameters:
Returns:
the generated identifier

save

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".
Specified by:
save in interface Session
Parameters:
id - an unused valid identifier

save

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".
Specified by:
save in interface Session
Parameters:
object - a transient instance of a persistent class
Returns:
the generated identifier

save

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".
Specified by:
save in interface Session
Parameters:
object - a transient instance of a persistent class
id - an unused valid identifier

saveOrUpdate

public void saveOrUpdate(Object object)
            throws HibernateException
Either Session.save(Object) or Session.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
See Also:
Session.save(java.lang.Object), Session.update(Object object)

saveOrUpdate

public void saveOrUpdate(String entityName,
                         Object obj)
            throws HibernateException
Either Session.save(String,Object) or Session.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:

saveOrUpdateCopy

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

saveOrUpdateCopy

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 copied
id - the identifier of the instance to copy to
Returns:
an updated persistent instance

saveOrUpdateCopy

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

saveOrUpdateCopy

public void saveOrUpdateCopy(String entityName,
                             Object object,
                             Map copiedAlready)
            throws HibernateException
Cascade copy an entity instance
Specified by:
saveOrUpdateCopy in interface EventSource

saveOrUpdateCopy

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 copied
id - the identifier of the instance to copy to
Returns:
an updated persistent instance

scroll

public ScrollableResults scroll(String query,
                                QueryParameters queryParameters)
            throws HibernateException
Specified by:
scroll in interface SessionImplementor

scroll

public ScrollableResults scroll(CriteriaImpl criteria,
                                ScrollMode scrollMode)
Specified by:
scroll in interface SessionImplementor

scrollCustomQuery

public ScrollableResults scrollCustomQuery(CustomQuery customQuery,
                                           QueryParameters queryParameters)
            throws HibernateException
Specified by:
scrollCustomQuery in interface SessionImplementor

setAutoClear

public void setAutoClear(boolean enabled)
Specified by:
setAutoClear in interface SessionImplementor

setCacheMode

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.

setFetchProfile

public void setFetchProfile(String fetchProfile)
Specified by:
setFetchProfile in interface SessionImplementor

setFlushMode

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 to FlushMode.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

setReadOnly

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

shouldAutoClose

public boolean shouldAutoClose()
Specified by:
shouldAutoClose in interface TransactionFactory.Context

toString

public String toString()

update

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".
Specified by:
update in interface Session
Parameters:

update

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".
Specified by:
update in interface Session
Parameters:
id - identifier of persistent instance

update

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".
Specified by:
update in interface Session
Parameters:
object - a detached instance containing updated state

update

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".
Specified by:
update in interface Session
Parameters:
object - a detached instance containing updated state
id - identifier of persistent instance