MyBatis
3
用户指南
从文档中复制代码的警告
对，这不是一个法律上的警告，但是它可以帮助你保持清醒的认识。从
美 学上来讲，现代的文字处理工具在制作可读性强和格式良好的文本上做了
大 量的工作。然而，它们也往往会由于插入特殊字符而完全破坏代码示例，
有 时看起来和你想要的是一模一样的。
“
引号
"
和连字符就是一个很好的例子-
在 IDE 环境或文本编辑器中，左边的那个符号就不会正常起作用，至少不会
是你 想要的那个效果。
阅读本文档，就要享受它，希望它能对你有帮助。当遇到代码段示例的
时 候，可以寻找示例和下载（包括单元测试等），或是来自网站和邮件列表
的 示例。
帮助我们把文档做得更好…
如果你发现了本文档的遗漏之处，或者丢失 My Bat is 特性的说明时，那么最好的方法
就 是了解一下这个遗漏之处然后把它记录下来。
我们在
w iki
接收公共的文档贡献：
h tt
p ://
c
ode .
go o
g
l
e
.
c
o
m
/
p
/
m
y
ba
t
i
s
/
w
i
k
i
/
W
e
l
c
o
m
e
你也是本文档的最佳作者，其他用户也会来阅读它的。
关于翻译
My Bat is 3 的用户指南翻译由南磊完成，若对翻译质量有任何意见和建议，请联系
nanle i1987@
gm
a i
l.
c om
，愿和大家共同提高，共同进步。
目录
什么是 MyBatis？.............................................................................................................
5 入门................................................................................................................................
5 从 XML 中构建 SqlSessionFactory .............................................................................. 5
不使用 XML 构建 SqlSessionFactory........................................................................... 6
从 SqlSessionFactory 中获取 SqlSession.......................................................................
6 探究已映射的 SQL 语句 ...........................................................................................
7 命名空间的一点注释 .......................................................................................... 8
范围和生命周期 ........................................................................................................
8
SqlSessionFactoryBu ild er ..................................................................................... 8
SqlSessionFactory................................................................................................ 9
SqlSession .......................................................................................................... 9
Mapper
实例
....................................................................................................... 9
XML 映射配置文件 ........................................................................................................
10
properties.................................................................................................................
10
Settings ....................................................................................................................1
1 typeAliases ..............................................................................................................
12 typeHand lers
............................................................................................................ 13
objectFactory ...........................................................................................................
14 plug ins
.................................................................................................................... 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, w hen, otherw ise
..................................................................................... 40
trim, w here, set..................................................................................................
41 foreach
............................................................................................................. 43
Java API ......................................................................................................................... 43
应用目录结构
.......................................................................................................... 43
SqlSessions .............................................................................................................. 44
SqlSessionFactoryBu ild er ...................................................................................
44
SqlSessionFactory.............................................................................................. 46
SqlSession ........................................................................................................ 47
Select Build er.....................................................................................................
53
SqlBu ilder ........................................................................................................ 56
