org.hibernate.internal

Class StatelessSessionImpl

java.lang.Object

org.hibernate.internal.AbstractSessionImpl

org.hibernate.internal.StatelessSessionImpl

All Implemented Interfaces:

Closeable, Serializable, AutoCloseable, LobCreationContext, SessionImplementor, JdbcSessionOwner, TransactionCoordinatorBuilder.TransactionCoordinatorOptions, SharedSessionContract, StatelessSession, WrapperOptionsContext

public class StatelessSessionImpl
extends AbstractSessionImpl
implements StatelessSession

Author:

Gavin King, Steve Ebersole

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.hibernate.internal.AbstractSessionImpl

AbstractSessionImpl.JdbcObserverImpl, AbstractSessionImpl.JdbcSessionContextImpl

Nested classes/interfaces inherited from interface org.hibernate.engine.jdbc.LobCreationContext

LobCreationContext.Callback<T>

Field Summary

Fields inherited from class org.hibernate.internal.AbstractSessionImpl

currentHibernateTransaction, factory, wrapperOptions

Method Summary

Modifier and Type	Method and Description
void	afterOperation(boolean success)
void	afterScrollOperation()
void	afterTransactionBegin() A after-begin callback from the coordinator to its owner.
void	afterTransactionCompletion(boolean successful, boolean delayed) An after-completion callback to the owner.
void	beforeTransactionCompletion() A before-completion callback to the owner.
Transaction	beginTransaction() Begin a unit of work and return the associated Transaction object.
String	bestGuessEntityName(Object object) The best guess entity name for an entity not in an association
void	close() Close the stateless session and release the JDBC connection.
Connection	connection() Returns the current JDBC connection associated with this instance. If the session is using aggressive connection release (as in a CMT environment), it is the application's responsibility to close the connection returned by this call.
Criteria	createCriteria(Class persistentClass) Create Criteria instance for the given class (entity or subclasses/implementors).
Criteria	createCriteria(Class persistentClass, String alias) Create Criteria instance for the given class (entity or subclasses/implementors), using a specific alias.
Criteria	createCriteria(String entityName) Create Criteria instance for the given entity name.
Criteria	createCriteria(String entityName, String alias) Create Criteria instance for the given entity name, using a specific alias.
void	delete(Object entity) Delete a row.
void	delete(String entityName, Object entity) Delete a row.
void	disableTransactionAutoJoin() Disable automatic transaction joining.
int	executeNativeUpdate(NativeSQLQuerySpecification nativeSQLQuerySpecification, QueryParameters queryParameters) Execute a native SQL update or delete query
int	executeUpdate(String query, QueryParameters queryParameters) Execute a HQL update or delete query
void	flush()
void	flushBeforeTransactionCompletion()
Object	get(Class entityClass, Serializable id) Retrieve a row.
Object	get(Class entityClass, Serializable id, LockMode lockMode) Retrieve a row, obtaining the specified lock mode.
Object	get(String entityName, Serializable id) Retrieve a row.
Object	get(String entityName, Serializable id, LockMode lockMode) Retrieve a row, obtaining the specified lock mode.
CacheMode	getCacheMode()
Serializable	getContextEntityIdentifier(Object object) Return the identifier of the persistent object, or null if not associated with the session
int	getDontFlushFromFind()
EntityMode	getEntityMode()
EntityPersister	getEntityPersister(String entityName, Object object) Get the EntityPersister for any instance
Object	getEntityUsingInterceptor(EntityKey key) Get the entity instance associated with the given Key, calling the Interceptor if necessary
SessionEventListenerManager	getEventListenerManager()
FlushMode	getFlushMode()
Interceptor	getInterceptor() Retrieves the interceptor currently in use by this event source.
JdbcCoordinator	getJdbcCoordinator()
JdbcSessionContext	getJdbcSessionContext()
LoadQueryInfluencers	getLoadQueryInfluencers() Get the load query influencers associated with this session.
PersistenceContext	getPersistenceContext() Get the persistence context for this session
long	getTimestamp() System time before the start of the transaction
TransactionCoordinator	getTransactionCoordinator() Retrieve access to the session's transaction coordinator.
String	guessEntityName(Object entity) The guessed entity name for an entity not in an association
Object	immediateLoad(String entityName, Serializable id) Load an instance immediately.
void	initializeCollection(PersistentCollection collection, boolean writing) Initialize the collection (if not already initialized)
Serializable	insert(Object entity) Insert a row.
Serializable	insert(String entityName, Object entity) Insert a row.
Object	instantiate(String entityName, Serializable id) Instantiate the entity class, initializing with the given identifier
Object	internalLoad(String entityName, Serializable id, boolean eager, boolean nullable) Load an instance without checking if it was deleted.
boolean	isAutoCloseSessionEnabled()
boolean	isConnected()
boolean	isDefaultReadOnly()
boolean	isEventSource()
boolean	isOpen()
boolean	isTransactionInProgress() Does this Session have an active Hibernate transaction or is there a JTA transaction in progress?
Iterator	iterate(String query, QueryParameters queryParameters) Execute an iterate() query
Iterator	iterateFilter(Object collection, String filter, QueryParameters queryParameters) Iterate a filter
List	list(Criteria criteria) Execute a criteria query
List	list(String query, QueryParameters queryParameters) Execute a find() query
List	listCustomQuery(CustomQuery customQuery, QueryParameters queryParameters) Execute an SQL Query
List	listFilter(Object collection, String filter, QueryParameters queryParameters) Execute a filter
void	refresh(Object entity) Refresh the entity instance state from the database.
void	refresh(Object entity, LockMode lockMode) Refresh the entity instance state from the database.
void	refresh(String entityName, Object entity) Refresh the entity instance state from the database.
void	refresh(String entityName, Object entity, LockMode lockMode) Refresh the entity instance state from the database.
ScrollableResults	scroll(Criteria criteria, ScrollMode scrollMode) Execute a criteria query
ScrollableResults	scroll(String query, QueryParameters queryParameters) Execute a scroll() query
ScrollableResults	scrollCustomQuery(CustomQuery customQuery, QueryParameters queryParameters) Execute an SQL Query
void	setAutoClear(boolean enabled) Enable/disable automatic cache clearing from after transaction completion (for EJB3)
void	setCacheMode(CacheMode cm)
void	setDefaultReadOnly(boolean readOnly)
void	setFlushMode(FlushMode fm)
boolean	shouldAutoClose()
boolean	shouldAutoJoinTransaction() Indicates whether an active transaction should be automatically joined.
void	update(Object entity) Update a row.
void	update(String entityName, Object entity) Update a row.

Methods inherited from class org.hibernate.internal.AbstractSessionImpl

createQuery, createQuery, createSQLQuery, createSQLQuery, createStoredProcedureCall, createStoredProcedureCall, createStoredProcedureCall, errorIfClosed, execute, generateEntityKey, getFactory, getHQLQueryPlan, getJdbcConnectionAccess, getNamedProcedureCall, getNamedQuery, getNamedSQLQuery, getNativeSQLQueryPlan, getSessionIdentifier, getTenantIdentifier, getTransaction, getTransactionCoordinatorBuilder, getWrapperOptions, isClosed, list, scroll, setClosed

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.hibernate.SharedSessionContract

createQuery, createSQLQuery, createStoredProcedureCall, createStoredProcedureCall, createStoredProcedureCall, getNamedProcedureCall, getNamedQuery, getTenantIdentifier, getTransaction

Method Detail

getTransactionCoordinator

public TransactionCoordinator getTransactionCoordinator()

Description copied from interface: SessionImplementor

Retrieve access to the session's transaction coordinator.

Specified by:

getTransactionCoordinator in interface SessionImplementor

Returns:

The transaction coordinator.

getJdbcCoordinator

public JdbcCoordinator getJdbcCoordinator()

Specified by:

getJdbcCoordinator in interface SessionImplementor

shouldAutoJoinTransaction

public boolean shouldAutoJoinTransaction()

Description copied from interface: TransactionCoordinatorBuilder.TransactionCoordinatorOptions

Indicates whether an active transaction should be automatically joined. Only relevant for JTA-based TransactionCoordinator instances.

Specified by:

shouldAutoJoinTransaction in interface TransactionCoordinatorBuilder.TransactionCoordinatorOptions

Specified by:

shouldAutoJoinTransaction in class AbstractSessionImpl

Returns:

true indicates the active transaction should be auto joined; false indicates it should not (until TransactionCoordinator.explicitJoin() is called).

insert

public Serializable insert(Object entity)

Description copied from interface: StatelessSession

Insert a row.

Specified by:

insert in interface StatelessSession

Parameters:

entity - a new transient instance

Returns:

The identifier of the inserted entity

insert

public Serializable insert(String entityName,
                           Object entity)

Description copied from interface: StatelessSession

Insert a row.

Specified by:

insert in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be inserted

entity - a new transient instance

Returns:

the identifier of the instance

delete

public void delete(Object entity)

Description copied from interface: StatelessSession

Delete a row.

Specified by:

delete in interface StatelessSession

Parameters:

entity - a detached entity instance

delete

public void delete(String entityName,
                   Object entity)

Description copied from interface: StatelessSession

Delete a row.

Specified by:

delete in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be deleted

entity - a detached entity instance

update

public void update(Object entity)

Description copied from interface: StatelessSession

Update a row.

Specified by:

update in interface StatelessSession

Parameters:

entity - a detached entity instance

update

public void update(String entityName,
                   Object entity)

Description copied from interface: StatelessSession

Update a row.

Specified by:

update in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be updated

entity - a detached entity instance

get

public Object get(Class entityClass,
                  Serializable id)

Description copied from interface: StatelessSession

Retrieve a row.

Specified by:

get in interface StatelessSession

Parameters:

entityClass - The class of the entity to retrieve

id - The id of the entity to retrieve

Returns:

a detached entity instance

get

public Object get(Class entityClass,
                  Serializable id,
                  LockMode lockMode)

Description copied from interface: StatelessSession

Retrieve a row, obtaining the specified lock mode.

Specified by:

get in interface StatelessSession

Parameters:

entityClass - The class of the entity to retrieve

id - The id of the entity to retrieve

lockMode - The lock mode to apply to the entity

Returns:

a detached entity instance

get

public Object get(String entityName,
                  Serializable id)

Description copied from interface: StatelessSession

Retrieve a row.

Specified by:

get in interface StatelessSession

Parameters:

entityName - The name of the entity to retrieve

id - The id of the entity to retrieve

Returns:

a detached entity instance

get

public Object get(String entityName,
                  Serializable id,
                  LockMode lockMode)

Description copied from interface: StatelessSession

Retrieve a row, obtaining the specified lock mode.

Specified by:

get in interface StatelessSession

Parameters:

entityName - The name of the entity to retrieve

id - The id of the entity to retrieve

lockMode - The lock mode to apply to the entity

Returns:

a detached entity instance

refresh

public void refresh(Object entity)

Description copied from interface: StatelessSession

Refresh the entity instance state from the database.

Specified by:

refresh in interface StatelessSession

Parameters:

entity - The entity to be refreshed.

refresh

public void refresh(String entityName,
                    Object entity)

Description copied from interface: StatelessSession

Refresh the entity instance state from the database.

Specified by:

refresh in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be refreshed.

entity - The entity to be refreshed.

refresh

public void refresh(Object entity,
                    LockMode lockMode)

Description copied from interface: StatelessSession

Refresh the entity instance state from the database.

Specified by:

refresh in interface StatelessSession

Parameters:

entity - The entity to be refreshed.

lockMode - The LockMode to be applied.

refresh

public void refresh(String entityName,
                    Object entity,
                    LockMode lockMode)

Description copied from interface: StatelessSession

Refresh the entity instance state from the database.

Specified by:

refresh in interface StatelessSession

Parameters:

entityName - The entityName for the entity to be refreshed.

entity - The entity to be refreshed.

lockMode - The LockMode to be applied.

immediateLoad

public Object immediateLoad(String entityName,
                            Serializable id)
                     throws HibernateException

Description copied from interface: SessionImplementor

Load an instance immediately. This method is only called when lazily initializing a proxy. Do not return the proxy.

Specified by:

immediateLoad in interface SessionImplementor

Throws:

HibernateException

initializeCollection

public void initializeCollection(PersistentCollection collection,
                                 boolean writing)
                          throws HibernateException

Description copied from interface: SessionImplementor

Initialize the collection (if not already initialized)

Specified by:

initializeCollection in interface SessionImplementor

Throws:

HibernateException

instantiate

public Object instantiate(String entityName,
                          Serializable id)
                   throws HibernateException

Description copied from interface: SessionImplementor

Instantiate the entity class, initializing with the given identifier

Specified by:

instantiate in interface SessionImplementor

Throws:

HibernateException

internalLoad

public Object internalLoad(String entityName,
                           Serializable id,
                           boolean eager,
                           boolean nullable)
                    throws HibernateException

Description copied from interface: SessionImplementor

Load an instance without checking if it was deleted.

When nullable is disabled this method may create a new proxy or return an existing proxy; if it does not exist, throw an exception.

When nullable is enabled, the method does not create new proxies (but might return an existing proxy); if it does not exist, return null.

When eager is enabled, the object is eagerly fetched

Specified by:

internalLoad in interface SessionImplementor

Throws:

HibernateException

iterate

public Iterator iterate(String query,
                        QueryParameters queryParameters)
                 throws HibernateException

Description copied from interface: SessionImplementor

Execute an iterate() query

Specified by:

iterate in interface SessionImplementor

Throws:

HibernateException

iterateFilter

public Iterator iterateFilter(Object collection,
                              String filter,
                              QueryParameters queryParameters)
                       throws HibernateException

Description copied from interface: SessionImplementor

Iterate a filter

Specified by:

iterateFilter in interface SessionImplementor

Throws:

HibernateException

listFilter

public List listFilter(Object collection,
                       String filter,
                       QueryParameters queryParameters)
                throws HibernateException

Description copied from interface: SessionImplementor

Execute a filter

Specified by:

listFilter in interface SessionImplementor

Throws:

HibernateException

isOpen

public boolean isOpen()

Specified by:

isOpen in interface SessionImplementor

close

public void close()

Description copied from interface: StatelessSession

Close the stateless session and release the JDBC connection.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface StatelessSession

isAutoCloseSessionEnabled

public boolean isAutoCloseSessionEnabled()

Specified by:

isAutoCloseSessionEnabled in interface SessionImplementor

shouldAutoClose

public boolean shouldAutoClose()

Specified by:

shouldAutoClose in interface SessionImplementor

getEventListenerManager

public SessionEventListenerManager getEventListenerManager()

Specified by:

getEventListenerManager in interface SessionImplementor

bestGuessEntityName

public String bestGuessEntityName(Object object)

Description copied from interface: SessionImplementor

The best guess entity name for an entity not in an association

Specified by:

bestGuessEntityName in interface SessionImplementor

connection

public Connection connection()

Description copied from interface: StatelessSession

Returns the current JDBC connection associated with this instance.

If the session is using aggressive connection 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

Specified by:

connection in interface StatelessSession

Returns:

The connection associated with this stateless session

executeUpdate

public int executeUpdate(String query,
                         QueryParameters queryParameters)
                  throws HibernateException

Description copied from interface: SessionImplementor

Execute a HQL update or delete query

Specified by:

executeUpdate in interface SessionImplementor

Throws:

HibernateException

getCacheMode

public CacheMode getCacheMode()

Specified by:

getCacheMode in interface SessionImplementor

getDontFlushFromFind

public int getDontFlushFromFind()

Specified by:

getDontFlushFromFind in interface SessionImplementor

getContextEntityIdentifier

public Serializable getContextEntityIdentifier(Object object)

Description copied from interface: SessionImplementor

Return the identifier of the persistent object, or null if not associated with the session

Specified by:

getContextEntityIdentifier in interface SessionImplementor

getEntityMode

public EntityMode getEntityMode()

getEntityPersister

public EntityPersister getEntityPersister(String entityName,
                                          Object object)
                                   throws HibernateException

Description copied from interface: SessionImplementor

Get the EntityPersister for any instance

Specified by:

getEntityPersister in interface SessionImplementor

Parameters:

entityName - optional entity name

object - the entity instance

Throws:

HibernateException

getEntityUsingInterceptor

public Object getEntityUsingInterceptor(EntityKey key)
                                 throws HibernateException

Description copied from interface: SessionImplementor

Get the entity instance associated with the given Key, calling the Interceptor if necessary

Specified by:

getEntityUsingInterceptor in interface SessionImplementor

Throws:

HibernateException

getFlushMode

public FlushMode getFlushMode()

Specified by:

getFlushMode in interface SessionImplementor

getInterceptor

public Interceptor getInterceptor()

Description copied from interface: SessionImplementor

Retrieves the interceptor currently in use by this event source.

Specified by:

getInterceptor in interface SessionImplementor

Returns:

The interceptor.

getPersistenceContext

public PersistenceContext getPersistenceContext()

Description copied from interface: SessionImplementor

Get the persistence context for this session

Specified by:

getPersistenceContext in interface SessionImplementor

getTimestamp

public long getTimestamp()

Description copied from interface: SessionImplementor

System time before the start of the transaction

Specified by:

getTimestamp in interface SessionImplementor

guessEntityName

public String guessEntityName(Object entity)
                       throws HibernateException

Description copied from interface: SessionImplementor

The guessed entity name for an entity not in an association

Specified by:

guessEntityName in interface SessionImplementor

Throws:

HibernateException

isConnected

public boolean isConnected()

Specified by:

isConnected in interface SessionImplementor

isTransactionInProgress

public boolean isTransactionInProgress()

Description copied from interface: SessionImplementor

Does this Session have an active Hibernate transaction or is there a JTA transaction in progress?

Specified by:

isTransactionInProgress in interface SessionImplementor

setAutoClear

public void setAutoClear(boolean enabled)

Description copied from interface: SessionImplementor

Enable/disable automatic cache clearing from after transaction completion (for EJB3)

Specified by:

setAutoClear in interface SessionImplementor

disableTransactionAutoJoin

public void disableTransactionAutoJoin()

Description copied from interface: SessionImplementor

Disable automatic transaction joining. The really only has any effect for CMT transactions. The default Hibernate behavior is to auto join any active JTA transaction (register Synchronization). JPA however defines an explicit join transaction operation.

See javax.persistence.EntityManager#joinTransaction

Specified by:

disableTransactionAutoJoin in interface SessionImplementor

setCacheMode

public void setCacheMode(CacheMode cm)

Specified by:

setCacheMode in interface SessionImplementor

setFlushMode

public void setFlushMode(FlushMode fm)

Specified by:

setFlushMode in interface SessionImplementor

beginTransaction

public Transaction beginTransaction()
                             throws HibernateException

Description copied from interface: SharedSessionContract

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.

Specified by:

beginTransaction in interface SharedSessionContract

Returns:

a Transaction instance

Throws:

HibernateException

See Also:

SharedSessionContract.getTransaction()

isEventSource

public boolean isEventSource()

Specified by:

isEventSource in interface SessionImplementor

isDefaultReadOnly

public boolean isDefaultReadOnly()

setDefaultReadOnly

public void setDefaultReadOnly(boolean readOnly)
                        throws HibernateException

Throws:

HibernateException

list

public List list(String query,
                 QueryParameters queryParameters)
          throws HibernateException

Description copied from interface: SessionImplementor

Execute a find() query

Specified by:

list in interface SessionImplementor

Throws:

HibernateException

afterOperation

public void afterOperation(boolean success)

createCriteria

public Criteria createCriteria(Class persistentClass,
                               String alias)

Description copied from interface: SharedSessionContract

Create Criteria instance for the given class (entity or subclasses/implementors), using a specific alias.

Specified by:

createCriteria in interface SharedSessionContract

Parameters:

persistentClass - The class, which is an entity, or has entity subclasses/implementors

alias - The alias to use

Returns:

The criteria instance for manipulation and execution

createCriteria

public Criteria createCriteria(String entityName,
                               String alias)

Description copied from interface: SharedSessionContract

Create Criteria instance for the given entity name, using a specific alias.

Specified by:

createCriteria in interface SharedSessionContract

Parameters:

entityName - The entity name

alias - The alias to use

Returns:

The criteria instance for manipulation and execution

createCriteria

public Criteria createCriteria(Class persistentClass)

Description copied from interface: SharedSessionContract

Create Criteria instance for the given class (entity or subclasses/implementors).

Specified by:

createCriteria in interface SharedSessionContract

Parameters:

persistentClass - The class, which is an entity, or has entity subclasses/implementors

Returns:

The criteria instance for manipulation and execution

createCriteria

public Criteria createCriteria(String entityName)

Description copied from interface: SharedSessionContract

Create Criteria instance for the given entity name.

Specified by:

createCriteria in interface SharedSessionContract

Parameters:

entityName - The entity name

Returns:

The criteria instance for manipulation and execution

scroll

public ScrollableResults scroll(Criteria criteria,
                                ScrollMode scrollMode)

Description copied from interface: SessionImplementor

Execute a criteria query

Specified by:

scroll in interface SessionImplementor

list

public List list(Criteria criteria)
          throws HibernateException

Description copied from interface: SessionImplementor

Execute a criteria query

Specified by:

list in interface SessionImplementor

Throws:

HibernateException

listCustomQuery

public List listCustomQuery(CustomQuery customQuery,
                            QueryParameters queryParameters)
                     throws HibernateException

Description copied from interface: SessionImplementor

Execute an SQL Query

Specified by:

listCustomQuery in interface SessionImplementor

Throws:

HibernateException

scrollCustomQuery

public ScrollableResults scrollCustomQuery(CustomQuery customQuery,
                                           QueryParameters queryParameters)
                                    throws HibernateException

Description copied from interface: SessionImplementor

Execute an SQL Query

Specified by:

scrollCustomQuery in interface SessionImplementor

Throws:

HibernateException

scroll

public ScrollableResults scroll(String query,
                                QueryParameters queryParameters)
                         throws HibernateException

Description copied from interface: SessionImplementor

Execute a scroll() query

Specified by:

scroll in interface SessionImplementor

Throws:

HibernateException

afterScrollOperation

public void afterScrollOperation()

Specified by:

afterScrollOperation in interface SessionImplementor

flush

public void flush()

Specified by:

flush in interface SessionImplementor

getLoadQueryInfluencers

public LoadQueryInfluencers getLoadQueryInfluencers()

Description copied from interface: SessionImplementor

Get the load query influencers associated with this session.

Specified by:

getLoadQueryInfluencers in interface SessionImplementor

Returns:

the load query influencers associated with this session; should never be null.

executeNativeUpdate

public int executeNativeUpdate(NativeSQLQuerySpecification nativeSQLQuerySpecification,
                               QueryParameters queryParameters)
                        throws HibernateException

Description copied from interface: SessionImplementor

Execute a native SQL update or delete query

Specified by:

executeNativeUpdate in interface SessionImplementor

Throws:

HibernateException

getJdbcSessionContext

public JdbcSessionContext getJdbcSessionContext()

Specified by:

getJdbcSessionContext in interface JdbcSessionOwner

afterTransactionBegin

public void afterTransactionBegin()

Description copied from interface: JdbcSessionOwner

A after-begin callback from the coordinator to its owner.

Specified by:

afterTransactionBegin in interface JdbcSessionOwner

beforeTransactionCompletion

public void beforeTransactionCompletion()

Description copied from interface: JdbcSessionOwner

A before-completion callback to the owner.

Specified by:

beforeTransactionCompletion in interface JdbcSessionOwner

afterTransactionCompletion

public void afterTransactionCompletion(boolean successful,
                                       boolean delayed)

Description copied from interface: JdbcSessionOwner

An after-completion callback to the owner.

Specified by:

afterTransactionCompletion in interface JdbcSessionOwner

Parameters:

successful - Was the transaction successful?

delayed - Is this a delayed after transaction completion call (aka after a timeout)?

flushBeforeTransactionCompletion

public void flushBeforeTransactionCompletion()

Specified by:

flushBeforeTransactionCompletion in interface JdbcSessionOwner