MyBatis3.2.2中文官方文档：用户指南

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使你更好地将精力集中在你的业务逻辑上，而不是数据持久层的实现细节上。 MyBatis 提供了简单易用的 API，使得开发者能够方便地将 SQL 语句与 Java 代码集成，从而实现对数据库的操作。在 MyBatis 中，SQL 语句通常是在 XML 映射文件或注解中定义，这样可以将 SQL 语句与 Java 代码分离，提高代码的可维护性。 **Helpmakethisdocumentationbetter** MyBatis 的中文文档是社区志愿者的贡献成果，鼓励用户参与翻译和完善，共同推动文档的更新和质量提升。 **关于翻译** 此文档为 MyBatis 3.2.2 版本的中文用户指南，由 Esin.z 在 2013 年 04 月 10 日使用 PDFCreator 创建。 **入门** 在 MyBatis 中，`SqlSessionFactory` 是核心组件，用于创建 `SqlSession` 对象，它是执行 SQL 命令的入口。可以通过以下两种方式构建 `SqlSessionFactory`： 1. **从XML中构建SqlSessionFactory**: 使用 MyBatis 的配置文件（通常为 mybatis-config.xml），其中包含了数据库连接信息、映射文件位置等配置。 2. **不使用XML构建SqlSessionFactory**: 直接通过 Java API 配置 `SqlSessionFactoryBuilder`，然后调用 `build()` 方法来创建 `SqlSessionFactory`。 **SqlSession** 是执行 SQL 查询和操作的主要接口，从 `SqlSessionFactory` 获取。使用 `SqlSession` 执行 SQL 后，需要关闭它以释放资源。 **范围和生命周期** `SqlSession` 的生命周期很短，通常只在一次数据库操作的范围内存在。每次数据库交互都应该在同一个 `SqlSession` 内完成，结束后关闭。 **XML映射配置文件** XML 映射文件用于定义 SQL 语句、参数映射和结果映射。包括： - **properties**: 属性配置，可以引用外部属性文件中的值。 - **settings**: 全局设置，如缓存、日志等的配置。 - **typeAliases**: 类型别名，简化类全名的书写。 - **typeHandlers**: 类型处理器，用于处理 Java 类型到 JDBC 类型的转换。 - **objectFactory**: 对象工厂，自定义对象创建方式。 - **plugins**: 插件，可扩展 MyBatis 功能，如性能监控、拦截器等。 - **environments**: 数据库环境配置，包括默认环境和多个数据库环境。 - **databaseIdProvider**: 数据库供应商识别，用于在不同数据库之间切换。 - **mappers**: 映射器配置，关联 Mapper XML 文件或注解的 Java 类。 **MapperXML文件** Mapper XML 文件包含 SQL 语句、参数映射和结果映射。主要有以下标签： - **select**: 定义查询语句。 - **insert, update, delete**: 分别对应插入、更新和删除操作。 - **sql**: 可复用的 SQL 片段。 - **parameters**: 参数映射。 - **resultMaps**: 结果映射，定义如何将数据库结果映射到 Java 对象。 - **auto-mapping**: 自动映射机制，MyBatis 自动将结果列与 Java 属性匹配。 - **cache**: 缓存配置，可以设置缓存级别和行为。 - **dynamic SQL**: 动态 SQL 功能，如 if、choose、when、otherwise、trim、where、set、foreach、bind 等，用于条件拼接和循环操作。 - **multi-db vendors support**: 多数据库供应商支持，适应不同数据库方言。 - **pluggable scripting languages for dynamic SQL**: 支持自定义动态 SQL 脚本语言。 **Java API** MyBatis 还提供了 Java API，包括 `SqlSession`、`SqlSessionFactory` 和各种 `Builder` 类，便于在 Java 代码中操作数据库。 **应用目录结构** 典型的 MyBatis 应用结构包括配置文件、映射文件和实体类等，合理的目录结构有助于项目的管理和维护。 **Logging** MyBatis 支持多种日志实现，如 Log4j、Logback 和 JDK 自带的日志，可以通过配置文件设置日志级别和实现。 **Logging Configuration** 在 MyBatis 配置文件中，可以指定日志实现，并配置相应的日志级别。 MyBatis 是一个强大的 ORM（对象关系映射）框架，通过灵活的 XML 或注解配置，实现了 SQL 语句与 Java 代码的分离，简化了数据库操作。其动态 SQL 功能使得 SQL 语句的编写更为便捷，同时提供了缓存机制以提高性能。通过 MyBatis，开发者可以更专注于业务逻辑的实现，而无需关心底层数据库的交互细节。