Mybatis笔记五：Mybatis的全局配置文件Configuration.xml讲解

从 XML 中构建 SqlSessionFactory

每个基于Mybatis应用都是以一个SqlSessionFactory实例为中心。SqlSessionFactory实例可以由SqlSessionFactoryBuild获得，而SqlSessionFactoryBuild可以以一个xml配置文件(Configuration.xml)构建出SqlSessionFactory实例。

Mybatis全局配置文件(Configuration.xml):

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!-- 配置数据源信息 -->
    <properties resource="jdbc.properties"/>
    <!--
        类型别名只是Java类型的别名，它可以有效减少Xml配置文件中映射查询语句里
        返回类型(resultType)为自定义实体类的完全限定名冗余
    -->
    <typeAliases>
        <typeAlias alias="narCode" type="com.test.model.NarCode" />
    </typeAliases>
    <!--
         获取数据库连接实例的数据源（DataSource）和决定事务作用域和控制方式的事务管理器（TransactionManager）
     -->
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${datasource.driverClassName}" />
                <property name="url" value="${datasource.url}" />
                <property name="username" value="${datasource.username}" />
                <property name="password" value="${datasource.password}" />
            </dataSource>
        </environment>
    </environments>

    <!-- 程序中所用到sql映射文件都在这里列出，这些映射sql都被Mybatis管理 -->
    <mappers>
        <mapper resource="com/test/xml/NarCodeMapper.xml" />
    </mappers>
</configuration>

xml映射文件[已映射的 SQL 语句](NarCodeMapper.xml)：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- 在sql映射文件中，Mybatis中namespace终于派上用场，它使得映射文件和接口之间的绑定变的非常自然。
     在iBatis中namespace不是必须的
 -->
<mapper namespace="com.test.dao.NarCodeMapper">

    <resultMap id="BaseResultMap" type="narCode">
        <id column="id" property="id" jdbcType="VARCHAR" />
        <result column="cnt" property="cnt" jdbcType="VARCHAR" />
        <result column="parentid" property="parentid" jdbcType="VARCHAR" />
        <result column="dlevel" property="dlevel" jdbcType="VARCHAR" />
    </resultMap>
    <!-- 根据id来查询 -->
    <select id="getNarCode" parameterType="java.lang.String"
        resultType="narCode">
        select a.id,a.cnt,a.parentid,a.dlevel,a.rowid from nar_code a
        where a.id = #{id,jdbcType=VARCHAR}
    </select>
</mapper>

映射器类：

package com.test.dao;

import com.test.model.NarCode;

public interface NarCodeMapper {
    public NarCode getNarCode(String id);
}

测试示例一:

import java.io.IOException;
import java.io.InputStream;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Before;
import org.junit.Test;

import com.test.model.NarCode;

public class Demo {

    SqlSessionFactory sqlSessionFactory;

    @Before
    public void testBefore() {
        String resource = "Mybatis-Configuration.xml";
        InputStream inputStream;
        try {
            //MyBatis 包含一个名叫 Resources 的工具类，它包含一些实用方法，可使从 classpath 或其他位置加载资源文件
            inputStream = Resources.getResourceAsStream(resource);
           //SqlSessionFactoryBuild来创建一个SqlSessionFactory实例
            sqlSessionFactory = new SqlSessionFactoryBuilder()
                    .build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    @Test
    public void tes1() {
        /**
          从SqlSessionFactory实例获得 SqlSession 实例。SqlSession 完全包含了面向数据库执行 SQL 命令所需的所有方法。
          你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句
        **/
        SqlSession sqlSession = sqlSessionFactory.openSession();
        try {
            NarCode narCode = sqlSession.selectOne(
                    "com.test.dao.NarCodeMapper.getNarCode", "110000");
            System.out.println(narCode);
        } finally {
            sqlSession.close();
        }

    }

}

这种方式能够正常工作，并且对于使用旧版本 MyBatis 的用户来说也比较熟悉，不过现在有了一种更直白的方式。使用对于给定语句能够合理描述参数和返回值的接口（比如说NarCodeMapper.class），你现在不但可以执行更清晰和类型安全的代码，而且还不用担心易错的字符串字面值以及强制类型转换。

测试示例二：

import java.io.IOException;
import java.io.InputStream;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Before;
import org.junit.Test;

import com.test.dao.NarCodeMapper;
import com.test.model.NarCode;

public class Demo {

    SqlSessionFactory sqlSessionFactory;

    @Before
    public void testBefore() {
        String resource = "Mybatis-Configuration.xml";
        InputStream inputStream;
        try {
            inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder()
                    .build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    @Test
    public void tes1() {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        try {
            NarCodeMapper narCodeMapper=sqlSession.getMapper(NarCodeMapper.class);
            NarCode narCode1=narCodeMapper.getNarCode("110000");
            System.out.println(narCode1);
        } finally {
            sqlSession.close();
        }

    }

}