MyBatis3用户指南：中文精简版

"MyBatis-3-User-Guide-Simplified - MyBatis中文帮助文档" MyBatis 是一个优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects，普通的 Java 对象)映射成数据库中的记录。 在用户指南中，重点介绍了如何有效地使用 MyBatis。文档鼓励读者在发现文档不足或缺失对 MyBatis 特性的解释时，参与到文档的更新和贡献中，以提升文档的质量。用户可以通过官方的 wiki 页面进行贡献。 文档还提醒用户，从文档中复制代码时需谨慎，因为文字处理工具可能会引入特殊字符，导致代码无法正常运行。建议在遇到代码示例时，直接从官方网站或邮件列表中获取原始示例，以确保代码的正确性。 文档结构清晰，主要章节包括： 1. **什么是 MyBatis**：这部分介绍 MyBatis 的核心概念和功能，阐述其在数据库操作中的作用。 2. **入门**：引导用户了解如何开始使用 MyBatis，包括构建 `SqlSessionFactory` 的两种方式——使用 XML 和不使用 XML。 3. **从XML中构建SqlSessionFactory**：详细解释如何通过 XML 配置文件创建 SqlSessionFactory，这是 MyBatis 中的主要工厂类，用于生成 SqlSession 实例。 4. **不使用XML构建SqlSessionFactory**：介绍了使用 Java API 创建 SqlSessionFactory 的方法，这提供了一种更动态的配置方式。 5. **从SqlSessionFactory中获取SqlSession**：SqlSession 是执行 SQL 语句并管理事务的核心接口。 6. **探究已映射的SQL语句**：讲解如何在 MyBatis 中映射 SQL 语句，包括命名空间的使用，这是区分不同 SQL 映射文件的关键。 7. **范围和生命周期**：讨论 SqlSessionFactory 和 SqlSession 的生命周期及其使用范围，强调正确的使用和关闭策略。 8. **SqlSessionFactoryBuilder**：解释 SqlSessionFactoryBuilder 的角色，它是构建 SqlSessionFactory 的工具类。 9. **SqlSessionFactory**：详述 SqlSessionFactory 的职责，包括如何创建和管理 SqlSession。 10. **SqlSession**：介绍 SqlSession 的功能，如执行 SQL、处理结果集、提交和回滚事务等。 11. **映射器实例**：讨论如何定义和使用映射器，这是映射 SQL 与 Java 方法的桥梁。 12. **XML映射配置文件**：涵盖 XML 映射文件的结构和元素，如 properties、settings、typeAliases、typeHandlers、objectFactory、plugins、environments、transactionManager 等，这些都是 MyBatis 配置的重要组成部分。 13. **properties**：说明如何配置外部属性文件，如数据库连接信息。 14. **settings**：介绍全局配置选项，可以调整 MyBatis 的行为。 15. **typeAliases**：简化类型引用，创建类型别名以减少代码冗余。 16. **typeHandlers**：描述如何处理 Java 类型到数据库类型的转换。 17. **objectFactory**：自定义对象工厂，允许用户控制对象的创建。 18. **plugins**：允许用户创建拦截器，增强 MyBatis 的功能。 19. **environments**：定义多种运行环境，如开发、测试和生产环境。 20. **transactionManager**：管理事务的组件，可以选择 JDBC 或 JTA。 这份 MyBatis-3 用户指南简化版为中文，方便中国开发者阅读和学习。对于翻译质量的反馈，可以直接联系译者南磊。该文档免费提供，但禁止用于商业用途，翻译版权归属译者，原文档版权则归 MyBatis 社区所有。