/*

 *    Copyright 2010 The myBatis Team

 *

 *    Licensed under the Apache License, Version 2.0 (the “License”);

 *    you may not use this file except in compliance with the License.

 *    You may obtain a copy of the License at

 *

 *       http://www.apache.org/licenses/LICENSE-2.0

 *

 *    Unless required by applicable law or agreed to in writing, software

 *    distributed under the License is distributed on an “AS IS” BASIS,

 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 *    See the License for the specific language governing permissions and

 *    limitations under the License.

 */

package org.mybatis.spring.support;

import org.apache.ibatis.session.SqlSession;

import org.apache.ibatis.session.SqlSessionFactory;

import org.mybatis.spring.SqlSessionTemplate;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.dao.support.DaoSupport;

import org.springframework.util.Assert;

/**

 * Convenient super class for MyBatis SqlSession data access objects.

 * It gives you access to the template which can then be used to execute SQL methods.

 * <p>

 * This class needs a SqlSessionTemplate or a SqlSessionFactory.

 * If both are set the SqlSessionFactory will be ignored.

 *

 * @see #setSqlSessionFactory

 * @see #setSqlSessionTemplate

 * @see SqlSessionTemplate

 * @version $Id: SqlSessionDaoSupport.java 3266 2010-11-22 06:56:51Z simone.tripodi$

 */

public abstract class SqlSessionDaoSupport extends DaoSupport {

    // 這個SqlSession就是我們平時用來執行SQL和事務的一次會話

    private SqlSession sqlSession;

    private boolean externalSqlSession;

    // 可以看到以下兩個Autowired的set方法,實際上他們的功能都是設定sqlSession的例項

    // 區別在於一個是通過傳入sqlSessionFactory然後包裝成SqlSessionTemplate

    // 另一個直接傳入SqlSessionTemplate賦值給sqlSession

    @Autowired(required = false)

    public final void setSqlSessionFactory(SqlSessionFactory sqlSessionFactory) {

        if (!this.externalSqlSession) {

            this.sqlSession = new SqlSessionTemplate(sqlSessionFactory);

        }

    }

    @Autowired(required = false)

    public final void setSqlSessionTemplate(SqlSessionTemplate sqlSessionTemplate) {

        this.sqlSession = sqlSessionTemplate;

        this.externalSqlSession = true;

    }

    /**

     * Users should use this method to get a SqlSession to call its statement methods

     * This is SqlSession is managed by spring. Users should not commit/rollback/close it

     * because it will be automatically done.

     *

     * @return Spring managed thread safe SqlSession

     */

    public final SqlSession getSqlSession() {

        return this.sqlSession;

    }

    /**

     * {@inheritDoc}

     */

    protected void checkDaoConfig() {

        Assert.notNull(this.sqlSession, “Property ‘sqlSessionFactory’ or ‘sqlSessionTemplate’ are required”);

    }

}

    <!– 配置資料來源 –>

    <bean id=“dataSource” class=“org.springframework.jndi.JndiObjectFactoryBean”>

       <property name=“jndiName” value=“java:comp/env/jdbc/bmc” />

       <!–property name=”jndiName” value=”bmc” / –>

    </bean>

    <!– sqlSessionFactory配置 –>

    <bean id=“sqlSessionFactory” class=“org.mybatis.spring.SqlSessionFactoryBean”>

       <property name=“configLocation” value=“classpath:mybatis-config.xml” />

       <property name=“mapperLocations” value=“classpath:BMC_*.xml” />

       <property name=“dataSource” ref=“dataSource” />

    </bean>

    <!– sqlSessionTemplate配置（支援批量） –>

    <bean id=“sqlSessionTemplate” class=“org.mybatis.spring.SqlSessionTemplate”>

       <!– 引數1: sqlSessionFactory|引數2：ExecutorType –>

       <constructor-arg index=“0” ref=“sqlSessionFactory” />

       <constructor-arg index=“1” value=“BATCH” />

    </bean>

SqlSessionUtils:46 - Creating a new SqlSession

SqlSessionUtils:46 - SqlSession [[email protected]] was not registered for synchronization because synchronization is not active

DataSourceUtils:110 - Fetching JDBC Connection from DataSource

SpringManagedTransaction:46 - JDBC Connection [jdbc:oracle:thin:@127.0.0.1:1521:bmcdb, UserName=BMC, Oracle JDBC driver] will not be managed by Spring

findRescByRoleID:46 - ooo Using Connection [jdbc:oracle:thin:@127.0.0.1:1521:bmcdb, UserName=BMC, Oracle JDBC driver]

findRescByRoleID:46 - ==>  Preparing: SELECT R.RESCID,R.RESCTYPE,R.RESCNAME,R.RESCURL FROM BMC_RESOURCE R LEFT JOIN BMC_ROLE_RESOURCE RR ON R.RESCID = RR.RESCID WHERE RR.ROLEID = ?

findRescByRoleID:46 - ==> Parameters: ST00004G(String)

findRescByRoleID:46 - <==      Total: 0

SqlSessionUtils:46 - Closing non transactional SqlSession [[email protected]]

DataSourceUtils:327 - Returning JDBC Connection to DataSource