MyBatis3 教程 中文版

MyBatis 3 用户指南

从文档中复制代码的警告

是的，这不是一个法律上的警告，但是它可以帮助你保持清醒的认识。从美学上来讲，现代的文字处理工具在制作可读性强和格式良好的文本上做了大量的工作。然而，它们也往往会由于插入特殊字符而完全破坏代码示例，有时看起来和你想要的是一模一样的。“引号"和连字符就是一个很好的例子-在IDE环境或文本编辑器中，左边的那个符号就不会正常起作用，至少不会是你想要的那个效果。

阅读本文档，就要享受它，希望它能对你有帮助。当遇到代码段示例的时候，可以寻找示例和下载（包括单元测试等），或是来自网站和邮件列表的示例。

帮助我们把文档做得更好…

如果你发现了本文档的遗漏之处，或者丢失MyBatis特性的说明时，那么最好的方法就是了解一下这个遗漏之处然后把它记录下来。

我们在wiki接收公共的文档贡献：

/confluence/oss/display/IBATIS/Contribute+ Documentation

你也是本文档的最佳作者，其他用户也会来阅读它的。

关于翻译

MyBatis 3的用户指南翻译由南磊完成，若对翻译质量有任何意见和建议，请联系nanlei1987@或/nanlei1987，愿和大家共同提高，共同进步。

本文档免费发布和使用，但不可用于任何商业途径，版权归译者南磊所有，源文档版权归MyBatis社区所有。

目录

什么是MyBatis？ (5)

入门 (5)

从XML中构建SqlSessionFactory (5)

不使用XML构建SqlSessionFactory (6)

从SqlSessionFactory中获取SqlSession (6)

探究已映射的SQL语句 (7)

命名空间的一点注释 (8)

范围和生命周期 (8)

SqlSessionFactoryBuilder (8)

SqlSessionFactory (9)

SqlSession (9)

映射器实例 (9)

XML映射配置文件 (10)

properties (10)

Settings (11)

typeAliases (12)

typeHandlers (13)

objectFactory (14)

plugins (15)

environments (16)

transactionManager (17)

dataSsource (17)

mappers (19)

SQL映射的XML文件 (19)

select (20)

insert，update，delete (21)

sql (23)

Parameters (24)

resultMap (25)

高级结果映射 (27)

id，result (29)

支持的JDBC类型 (30)

构造方法 (30)

关联 (31)

集合 (34)

鉴别器 (36)

缓存 (38)

使用自定义缓存 (38)

参照缓存 (39)

动态SQL (39)

if (40)

choose, when, otherwise (40)

trim, where, set (41)

foreach (43)

Java API (44)

应用目录结构 (44)

SqlSessions (45)

SqlSessionFactoryBuilder (45)

SqlSessionFactory (47)

SqlSession (48)

SelectBuilder (53)

SqlBuilder (56)

什么是MyBatis？

MyBatis是支持普通SQL查询，存储过程和高级映射的优秀持久层框架。MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及对结果集的检索。MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain 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配置文件的详细内容可以在文档后面找到，这里给出一个简单的示例：

"/dtd/mybatis-3-config.dtd">