从 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(); } } }