MyBatis官方中文文档

该作品是PDF文件格式请下载 福昕PDF阅读器

MyBatis 是支持普通 SQL 查询，存储过程和高级映射的优秀持久层框架。MyBatis 消除
了几乎所有的 JDBC 代码和参数的手工设置以及结果集的检索。MyBatis 使用简单的 XML
或注解用于配置和原始映射，将接口和 Java 的 POJOs（Plan Old Java Objects，普通的 Java
对象）映射成数据库中的记录。

入门

每一个 MyBatis 的应 用程序 都以一 个 SqlSessionFactory 对象的 实例为 核心。
SqlSessionFactory 对 象 的 实 例 可 以 通 过 SqlSessionFactoryBuilder
对 象 来 获 得 。
SqlSessionFactoryBuilder 对象可以从 XML 配置文件，或从 Configuration 类的习惯准备的实
例中构建 SqlSessionFactory 对象。

从 XML 中构建 SqlSessionFactory

从 XML 文件中构建 SqlSessionFactory 的实例非常简单。这里建议你使用类路径下的资
源文件来配置，但是你可以使用任意的 Reader 实例，这个实例包括由文字形式的文件路径
或 URL 形式的文件路径 file://来创建。MyBatis 包含了一些工具类，称作为资源，这些工具
类包含一些方法，这些方法使得从类路径或其他位置加载资源文件更加简单。
String resource = "org/mybatis/example/Configuration.xml";
Reader reader = Resources.getResourceAsReader(resource);
sqlMapper = new SqlSessionFactoryBuilder().build(reader);
XML 配置文件包含对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源和
决定事务范围和控制的事务管理器。关于 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>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="org/mybatis/example/BlogMapper.xml"/>
</mappers>
</configuration>
当然，在XML配置文件中还有很多可以配置的，上面的示例指出的则是最关键的部分。
要注意 XML 头部的声明，需要用来验证 XML 文档正确性。environment 元素体中包含对事
务管理和连接池的环境配置。mappers 元素是包含所有 mapper （映射器）的列表，这些 mapper
的 XML 文件包含 SQL 代码和映射定义信息。