org.mybatis.spring
Class SqlSessionUtils

java.lang.Object
  org.mybatis.spring.SqlSessionUtils

public final class SqlSessionUtils
extends Object

Handles MyBatis SqlSession life cycle. It can register and get SqlSessions from Spring TransactionSynchronizationManager. Also works if no transaction is active.

Version:

$Id: SqlSessionUtils.java 3263 2010-11-22 04:24:13Z putthibongb $

See Also:

DataSourceUtils, TransactionSynchronizationManager

Method Summary

static void	closeSqlSession(org.apache.ibatis.session.SqlSession session, org.apache.ibatis.session.SqlSessionFactory sessionFactory) Checks if SqlSession passed as an argument is managed by Spring TransactionSynchronizationManager If it is not, it closes it, otherwise it just updates the reference counter and lets Spring call the close callback when the managed transaction ends
static org.apache.ibatis.session.SqlSession	getSqlSession(org.apache.ibatis.session.SqlSessionFactory sqlSessionFactory) Creates a new MyBatis SqlSession from the SqlSessionFactory provided as a parameter and using its DataSource and ExecutorType
static org.apache.ibatis.session.SqlSession	getSqlSession(org.apache.ibatis.session.SqlSessionFactory sessionFactory, org.apache.ibatis.session.ExecutorType executorType) If a Spring transaction is active it uses DataSourceUtils to get a Spring managed Connection, then creates a new SqlSession with this connection and synchronizes it with the transaction.
static boolean	isSqlSessionTransactional(org.apache.ibatis.session.SqlSession session, org.apache.ibatis.session.SqlSessionFactory sessionFactory) Returns if the SqlSession passed as an argument is being managed by Spring

Methods inherited from class java.lang.Object

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

Method Detail

getSqlSession

public static org.apache.ibatis.session.SqlSession getSqlSession(org.apache.ibatis.session.SqlSessionFactory sqlSessionFactory)

Creates a new MyBatis SqlSession from the SqlSessionFactory provided as a parameter and using its DataSource and ExecutorType

Parameters:

sqlSessionFactory - a MyBatis SqlSessionFactory to create new sessions

Returns:

a MyBatis SqlSession

Throws:

org.springframework.dao.TransientDataAccessResourceException - if a transaction is active and the SqlSessionFactory is not using a SpringManagedTransactionFactory

getSqlSession

public static org.apache.ibatis.session.SqlSession getSqlSession(org.apache.ibatis.session.SqlSessionFactory sessionFactory,
                                                                 org.apache.ibatis.session.ExecutorType executorType)

If a Spring transaction is active it uses DataSourceUtils to get a Spring managed Connection, then creates a new SqlSession with this connection and synchronizes it with the transaction. If there is not an active transaction it gets a connection directly from the DataSource and creates a SqlSession with it.

Throws:

org.springframework.dao.TransientDataAccessResourceException - if a transaction is active and the SqlSessionFactory is not using a SpringManagedTransactionFactory

See Also:

SpringManagedTransactionFactory

closeSqlSession

public static void closeSqlSession(org.apache.ibatis.session.SqlSession session,
                                   org.apache.ibatis.session.SqlSessionFactory sessionFactory)

Checks if SqlSession passed as an argument is managed by Spring TransactionSynchronizationManager If it is not, it closes it, otherwise it just updates the reference counter and lets Spring call the close callback when the managed transaction ends

Parameters:

session -

sessionFactory -

isSqlSessionTransactional

public static boolean isSqlSessionTransactional(org.apache.ibatis.session.SqlSession session,
                                                org.apache.ibatis.session.SqlSessionFactory sessionFactory)

Returns if the SqlSession passed as an argument is being managed by Spring

Parameters:

session - a MyBatis SqlSession to check

sessionFactory - the SqlSessionFactory which the SqlSession was built with

Returns:

true if session is transactional, otherwise false