MyBatis 3 中文文档.pdf

MyBatis 3 用户指南 从文档中复制代码的警告 对，这不是一个法律上的警告，但是它可以帮助你保持清醒的认识。从美 学上来讲，现代的文字处理工具在制作可读性强和格式良好的文本上做了大 量的工作。然而，它们也往往会由于插入特殊字符而完全破坏代码示例，有 时看起来和你想要的是一模一样的。“引号和连字符就是一个很好的例子-在 IDE 环境或文本编辑器中，左边的那个符号就不会正常起作用，至少不会是你 想要的那个效果。 阅读本文档，就要享受它，希望它能对你有帮助。当遇到代码段示例的时 候，可以寻找示例和下载（包括单元测试等），或是来自网站和邮件列表的 示例。 帮助我们把文档做得更好… 如果你发现了本文档的遗漏之处，或者丢失MyBatis 特性的说明时，那么最好的方法就 是了解一下这个遗漏之处然后把它记录下来。 我们在wiki 接收公共的文档贡献： /p/mybatis/wiki/Welcome 你也是本文档的最佳作者，其他用户也会来阅读它的。 关于翻译 MyBatis 3 的用户指南翻译由南磊完成，若对翻译质量有任何意见和建议，请联系 nanlei1987@ ，愿和大家共同提高，共同进步。 目录 什么是MyBatis ？ 5 入门 5 从XML 中构建SqlSessionFactory 5 不使用XML 构建SqlSessionFactory 6 从SqlSessionFactory 中获取SqlSession 6 探究已映射的SQL 语句 7 命名空间的一点注释 8 范围和生命周期 8 SqlSessionFactoryBuilder 8 SqlSessionFactory 9 SqlSession 9 Mapper 实例 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 43 应用目录结构 43 SqlSessions 44 SqlSessionFactoryBuilder 44 SqlSessionFactory 46 SqlSession 47 SelectBuilder 53 SqlBuilder 56 什么是MyBatis ？ MyBatis 是支持普通SQL 查询，存储过程和高级映射的优秀持久层框架。MyBatis 消除 了几乎所有的JDBC 代码和参数的手工设置以及