SqlSessionTemplate (mybatis-spring 1.0.2 API)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.mybatis.spring
Class SqlSessionTemplate

java.lang.Object
  org.mybatis.spring.SqlSessionTemplate

All Implemented Interfaces:: org.apache.ibatis.session.SqlSession

public class SqlSessionTemplate
extends Object
implements org.apache.ibatis.session.SqlSession
extends Object
implements org.apache.ibatis.session.SqlSession

Thread safe, Spring managed, SqlSession that works with Spring transaction management to ensure that that the actual SqlSession used is the one associated with the current Spring transaction. In addition, it manages the session life-cycle, including closing, committing or rolling back the session as necessary based on the Spring transaction configuration.

The template needs a SqlSessionFactory to create SqlSessions, passed as a constructor argument. It also can be constructed indicating the executor type to be used, if not, the default executor type, defined in the session factory will be used.

This template converts MyBatis PersistenceExceptions into unchecked DataAccessExceptions, using, by default, a MyBatisExceptionTranslator.

Because SqlSessionTemplate is thread safe, a single instance can be shared by all DAOs; there should also be a small memory savings by doing this. This pattern can be used in Spring configuration files as follows:

 <bean id="sqlSessionTemplate" class="org.mybatis.spring.SqlSessionTemplate"> 
   <constructor-arg ref="sqlSessionFactory" /> 
 </bean>

Version:: $Id: SqlSessionTemplate.java 3908 2011-09-12 07:10:50Z [email protected] $
See Also:: SqlSessionFactory, MyBatisExceptionTranslator

Constructor Summary
`SqlSessionTemplate(org.apache.ibatis.session.SqlSessionFactory sqlSessionFactory)` Constructs a Spring managed SqlSession with the `SqlSessionFactory` provided as an argument.
`SqlSessionTemplate(org.apache.ibatis.session.SqlSessionFactory sqlSessionFactory, org.apache.ibatis.session.ExecutorType executorType)` Constructs a Spring managed SqlSession with the `SqlSessionFactory` provided as an argument and the given `ExecutorType` `ExecutorType` cannot be changed once the `SqlSessionTemplate` is constructed.
`SqlSessionTemplate(org.apache.ibatis.session.SqlSessionFactory sqlSessionFactory, org.apache.ibatis.session.ExecutorType executorType, org.springframework.dao.support.PersistenceExceptionTranslator exceptionTranslator)` Constructs a Spring managed `SqlSession` with the given `SqlSessionFactory` and `ExecutorType`.

Method Summary

void clearCache()

void close()

void commit()

void commit(boolean force)

int delete(String statement)

int delete(String statement, Object parameter)

List<org.apache.ibatis.executor.BatchResult> flushStatements()

org.apache.ibatis.session.Configuration getConfiguration()

Connection getConnection()

org.apache.ibatis.session.ExecutorType getExecutorType()





<T> T

getMapper(Class<T> type)

org.springframework.dao.support.PersistenceExceptionTranslator getPersistenceExceptionTranslator()

org.apache.ibatis.session.SqlSessionFactory getSqlSessionFactory()

int insert(String statement)

int insert(String statement, Object parameter)

void rollback()

void rollback(boolean force)

void select(String statement, Object parameter, org.apache.ibatis.session.ResultHandler handler)

void select(String statement, Object parameter, org.apache.ibatis.session.RowBounds rowBounds, org.apache.ibatis.session.ResultHandler handler)

void select(String statement, org.apache.ibatis.session.ResultHandler handler)

List<?> selectList(String statement)

List<?> selectList(String statement, Object parameter)

List<?> selectList(String statement, Object parameter, org.apache.ibatis.session.RowBounds rowBounds)

Map<?,?> selectMap(String statement, Object parameter, String mapKey)

Map<?,?> selectMap(String statement, Object parameter, String mapKey, org.apache.ibatis.session.RowBounds rowBounds)

Map<?,?> selectMap(String statement, String mapKey)

Object selectOne(String statement)

Object selectOne(String statement, Object parameter)

int update(String statement)

int update(String statement, Object parameter)

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail