MyBatis3用户指南：官方中文版

"MyBatis 官方中文文档" MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使你更好地将注意力集中在使用 SQL 来构建你的数据访问层。 用户指南是为了帮助开发者更深入地理解和使用 MyBatis 框架。如果你在阅读文档时发现任何遗漏或对 MyBatis 特性有疑问，官方鼓励你参与文档的贡献，可以在指定的 wiki 页面上进行编辑和更新，以提升整个社区的文档质量。 该文档的中文翻译由南磊完成，旨在方便中文用户阅读和学习。文档免费提供，但禁止用于商业用途，翻译权归译者所有，源文档版权归属 MyBatis 社区。 文档中特别提醒，在复制代码示例时要注意，因为现代文字处理工具可能会因特殊字符的插入导致代码失效。例如，引号和连字符在不同的环境下可能表现不同，因此建议在遇到代码示例时，最好直接从原文档中复制或参考官方网站和邮件列表中的示例。 文档结构如下： 1. **什么是MyBatis？** 这部分会介绍 MyBatis 的基本概念和核心功能，包括它如何简化数据库操作，以及其与传统 JDBC 的区别。 2. **入门** 提供了快速入门教程，引导开发者如何构建 `SqlSessionFactory`，这是使用 MyBatis 的第一步。 3. **从XML中构建SqlSessionFactory** 和 **不使用XML构建SqlSessionFactory** 两部分分别介绍了通过 XML 配置文件和基于 Java API 的方式来创建 SqlSessionFactory。 4. **从SqlSessionFactory中获取SqlSession** 解释了如何从 SqlSessionFactory 获取执行 SQL 的 SqlSession 对象。 5. **探究已映射的SQL语句** 详细说明了如何定义和使用 SQL 映射，包括命名空间的使用和理解。 6. **范围和生命周期** 描述了 SqlSessionFactory、SqlSession 和其他对象的生命周期和作用范围，这对于理解它们何时创建、何时关闭以及如何管理非常重要。 7. **SqlSessionFactoryBuilder**、**SqlSessionFactory**、**SqlSession**、**映射器实例** 这些章节深入讲解了这些核心组件的工作原理和使用方法。 8. **XML映射配置文件** 部分详细介绍了 XML 配置文件的各个元素，如 `properties`、`settings`、`typeAliases`、`typeHandlers`、`objectFactory`、`plugins` 和 `environments`，这些都是 MyBatis 配置的关键部分。 9. **transactionManager** 讲述了事务管理器的配置和使用，包括如何控制事务的开始、提交和回滚。 以上是 MyBatis 官方中文文档的主要内容概览，通过这份文档，开发者可以全面了解 MyBatis 的各项特性，并学会如何在实际项目中有效地应用 MyBatis。