MyBatis框架核心JAR包详解与配置指南

MyBatis 是一款优秀的持久层框架，它支持定制化SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的JDBC代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJOs(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录。MyBatis提供了两种缓存机制：一级缓存和二级缓存。两者的目的

浮华ya

1141人浏览 · 2025-05-08 09:19:07

浮华ya · 2025-05-08 09:19:07 发布

本文还有配套的精品资源，点击获取

简介：MyBatis是一个高性能的Java持久层框架，它通过XML或注解方式简化了JDBC编程的复杂性。本简介介绍了MyBatis的主要组件，如SqlSessionFactoryBuilder、SqlSessionFactory、Mapper接口、Executor、映射机制、动态SQL、事务管理、缓存机制和插件扩展等关键特性。MyBatis的灵活性允许开发人员自定义SQL执行过程，实现了与多种数据库的高效交互。 MyBatis各个jar包

1. MyBatis框架概述

1.1 MyBatis简介

1.2 MyBatis的核心优势

与传统的JDBC相比，MyBatis提供了如下优势： - 面向接口编程 ：开发者只需要关注接口定义，无需编写SQL语句。 - 动态SQL ：MyBatis提供了完整的动态SQL支持，可以根据不同的条件拼接不同的SQL语句。 - SQL优化 ：MyBatis允许开发者完全自定义SQL，这使得进行SQL优化变得非常容易。 - 高级映射 ：MyBatis提供了广泛的映射类型支持，包括一对一、一对多、多对多等复杂关系的映射。 - 使用方便 ：MyBatis的配置文件易于理解和修改，可适应不同的数据库和环境。

1.3 MyBatis的适用场景

MyBatis特别适合于以下场景： - 复杂的SQL语句操作 ：当你的业务逻辑需要编写复杂SQL时，MyBatis提供了强大的动态SQL支持。 - 应用层面的性能要求高 ：MyBatis只做了基本的SQL解析，因此执行效率较高。 - 需要与遗留数据库交互 ：MyBatis 提供了灵活的SQL编写能力，可与遗留数据库系统良好配合。

总的来说，MyBatis是一个灵活、高效且易于使用的持久层框架，适合于需要对SQL语句进行精确控制的应用开发。

2. SqlSessionFactoryBuilder的作用和使用

2.1 SqlSessionFactoryBuilder的构建过程

2.1.1 通过XML配置文件创建SqlSessionFactory

SqlSessionFactoryBuilder是MyBatis中用于构建SqlSessionFactory的一个关键类。SqlSessionFactory是一个线程安全的对象，负责创建SqlSession实例。SqlSessionFactory通过SqlSessionFactoryBuilder来构建，通常采用XML配置文件的形式。

String resource = "org/mybatis/example/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

以上代码展示了使用SqlSessionFactoryBuilder通过XML配置文件创建SqlSessionFactory的流程。这里， Resources 类用于读取配置文件，它实际上是对 InputStream 进行了封装。然后，通过 SqlSessionFactoryBuilder 的 build 方法，利用输入流创建了 SqlSessionFactory 。

2.1.2 通过配置对象创建SqlSessionFactory

除了使用XML文件，还可以通过Java的配置对象来创建 SqlSessionFactory 。这种方式提供了更多的灵活性，不需要XML文件。

DataSource dataSource = BlogDataSourceFactory.getBlogDataSource();
EnvironmentalConfiguration configuration = new EnvironmentalConfiguration();
configuration.setDataSource(dataSource);
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = builder.build(configuration);

在这段代码中，首先创建了 DataSource ，它配置了数据库连接的相关信息。然后，创建了一个 EnvironmentalConfiguration 实例，并将其作为参数传递给了 SqlSessionFactoryBuilder 的 build 方法。最终生成的 SqlSessionFactory 是根据Java配置对象中定义的各种参数来创建的。

2.2 SqlSessionFactoryBuilder的最佳实践

2.2.1 理解构建过程中的异常处理

在使用 SqlSessionFactoryBuilder 时，如果XML配置文件存在错误或者Java配置对象的设置不当，构建过程可能会抛出异常。因此，理解和处理这些异常对于应用程序的稳定运行至关重要。

try {
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (Exception e) {
    System.err.println("Error building SqlSessionFactory. Cause: " + e);
    // Handle exception here
}

在构建过程中，应该使用try-catch块来捕获可能出现的异常。这样，在构建失败时，可以输出错误信息或者执行其他的错误处理逻辑。

2.2.2 构建过程中的性能考虑

性能是构建 SqlSessionFactory 时必须考虑的因素。对于大型应用而言，频繁地进行构建操作会消耗大量资源。因此，最佳实践是在应用启动时只构建一次 SqlSessionFactory ，然后通过单例模式或者其他方式来重用。

public class MyBatisUtil {
    private static SqlSessionFactory sqlSessionFactory;

    public static SqlSessionFactory getSqlSessionFactory() throws IOException {
        if (sqlSessionFactory == null) {
            String resource = "org/mybatis/example/mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        }
        return sqlSessionFactory;
    }
}

在上述代码中，使用了一个工具类 MyBatisUtil ，其中 getSqlSessionFactory 方法使用了懒汉式单例模式，确保了 SqlSessionFactory 只在首次调用时创建，之后每次调用都返回同一个实例。这样既保证了性能，也保证了线程安全。

在下一章中，我们将继续深入了解 SqlSessionFactory 的核心地位和功能。

3. SqlSessionFactory的核心地位和功能

SqlSessionFactory是MyBatis中的一个核心组件，它在MyBatis框架中扮演了至关重要的角色。理解SqlSessionFactory的工作原理和它的功能，对于掌握MyBatis框架的工作机制，以及优化和扩展MyBatis应用有着举足轻重的作用。本章将深入探讨SqlSessionFactory的生命周期管理、如何创建和配置SqlSessionFactory，以及SqlSessionFactory的事务控制机制等关键内容。

3.1 SqlSessionFactory的生命周期管理

3.1.1 如何创建和配置SqlSessionFactory

SqlSessionFactory对象是通过SqlSessionFactoryBuilder来构建的，它是线程安全的，并且通常在应用启动时创建，然后在应用的整个生命周期内使用。创建SqlSessionFactory通常使用以下步骤：

String resource = "org/mybatis/example/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

在这个示例中，首先通过 Resources.getResourceAsStream 方法加载MyBatis的配置文件。然后，将输入流传递给SqlSessionFactoryBuilder的 build 方法创建SqlSessionFactory实例。

MyBatis的配置文件通常包含数据库连接信息、事务管理器配置、映射文件路径等。例如：

<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/my_database"/>
                <property name="username" value="my_user"/>
                <property name="password" value="my_password"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="org/mybatis/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

SqlSessionFactory一旦创建，就可以通过它创建SqlSession实例，用于数据库交互。

3.1.2 SqlSessionFactory的单例模式与线程安全

SqlSessionFactory是基于单例模式设计的，这意味着在一个应用中，通常只需要一个SqlSessionFactory实例。由于SqlSessionFactory在创建时会加载全部配置信息，并且其生命周期贯穿整个应用的运行周期，因此它能够保证资源的合理使用和重用。

在多线程环境下，SqlSessionFactory是线程安全的。原因在于它不维护任何状态，即它不存储任何资源状态或数据。线程安全的关键在于SqlSessionFactory不共享任何可变状态。但是，使用SqlSessionFactory创建的SqlSession实例并不是线程安全的，每个线程应当使用它自己的SqlSession实例。

3.2 SqlSessionFactory的功能详解

3.2.1 SqlSession的创建和生命周期

SqlSession是MyBatis中用于与数据库交互的接口，是MyBatis执行SQL语句、提交和回滚事务的基本对象。SqlSession不是线程安全的，通常应该在方法级别创建和使用SqlSession。

在MyBatis中，SqlSession通常通过SqlSessionFactory的 openSession() 方法创建。可以在需要的时候打开SqlSession，用完后调用 close() 方法关闭SqlSession。SqlSession的生命周期应该限制在方法内部，以保证数据库资源的正确释放。

try (SqlSession session = sqlSessionFactory.openSession()) {
    // 使用session进行数据库操作
    session.insert("com.example.mapper.UserMapper.insertUser", user);
    session.commit();
}

在上述代码中，使用了try-with-resources语句来确保SqlSession在使用完毕后能够被正确关闭。如果发生异常，SqlSession也会自动关闭。

3.2.2 SqlSessionFactory的事务控制机制

MyBatis对事务的支持是通过SqlSession来实现的。SqlSession接口定义了事务控制相关的方法，如 commit() 和 rollback() 。SqlSessionFactory在创建SqlSession时，会根据配置文件中的事务管理器配置来设置事务控制的行为。

MyBatis提供了两种事务管理方式： JDBC 和 MANAGED 。 JDBC 事务意味着MyBatis不会管理连接和事务，而是让JDBC API控制它们。 MANAGED 事务则是由容器管理事务，比如在应用服务器中。

在代码层面上，事务控制通常这样实现：

try (SqlSession session = sqlSessionFactory.openSession()) {
    // 开启事务
    session.getConnection().setAutoCommit(false);
    // 执行数据库操作
    session.update("com.example.mapper.UserMapper.updateUser", user);
    // 提交事务
    session.commit();
} catch (Exception e) {
    // 回滚事务
    session.rollback();
} finally {
    // 关闭SqlSession
    session.close();
}

在这个示例中，首先关闭了自动提交，以便手动控制事务的边界。随后，根据操作结果决定提交或回滚事务。这样可以确保数据库的一致性和完整性。

SqlSessionFactory作为MyBatis的核心组件，其线程安全性和生命周期管理是保证高效且可靠数据库操作的关键。通过对其创建和配置的理解，以及对其事务控制机制的掌握，开发者能够更加游刃有余地运用MyBatis框架解决实际问题。

4. Mapper接口与SQL语句的映射

4.1 Mapper接口的工作原理

4.1.1 映射接口与命名空间的关联

Mapper接口是MyBatis中的一个核心概念，它为用户提供了一个简单的方法来操作数据库，而无需编写复杂的SQL语句。每个Mapper接口都与一个特定的命名空间相关联，该命名空间通常通过接口的全限定名来定义。这种方式可以确保每个Mapper接口在MyBatis中的唯一性。

public interface UserMapper {
    User selectUserById(int id);
}

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectUserById" resultType="com.example.domain.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

在上面的例子中， UserMapper 接口和XML映射文件中的命名空间完全一致。通过这种方式，MyBatis能够将接口方法和XML中的SQL语句关联起来。当调用 UserMapper 接口的 selectUserById 方法时，MyBatis将根据命名空间和方法名找到对应的SQL语句，并执行它。

4.1.2 动态代理机制在Mapper接口中的应用

MyBatis使用动态代理机制来生成Mapper接口的代理对象。当调用Mapper接口的方法时，MyBatis会拦截这个调用，并将它转换为对应的SQL语句去执行。动态代理是在运行时通过Java的 Proxy 类和 InvocationHandler 接口实现的。开发者无需手动编写代理类，MyBatis在启动时会根据配置自动创建。

// 创建SqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
// 获取Mapper接口的代理对象
UserMapper mapper = sqlSessionFactory.openSession().getMapper(UserMapper.class);
// 调用代理对象方法
User user = mapper.selectUserById(1);

在上述代码中， getMapper(UserMapper.class) 方法会返回一个代理对象。当调用 selectUserById 方法时，MyBatis会通过动态代理机制拦截调用，并生成相应的SQL语句来查询数据库。

4.2 SQL语句与Mapper接口的映射策略

4.2.1 XML与注解两种映射方式的对比

MyBatis支持两种映射策略：XML映射文件和注解。XML映射文件提供了更强的灵活性和可读性，适合复杂SQL语句的映射。注解则更加轻量和简洁，可以将SQL语句直接写在接口方法上，适合简单的操作。

@Select("SELECT * FROM users WHERE id = #{id}")
User selectUserById(int id);

在上面的例子中，使用了 @Select 注解直接在接口方法上定义了SQL语句。这种方式使得代码更加紧凑，但是当SQL语句较为复杂时，使用注解可能会降低代码的可读性。

另一方面，使用XML映射文件可以将SQL语句与接口分离，保持代码的清晰和组织性：

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectUserById" resultType="com.example.domain.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

XML文件中的SQL语句可以包含多个参数，支持更复杂的动态SQL，同时也可以被多个方法共享。

4.2.2 高级映射技巧与常见问题

MyBatis映射机制的灵活性非常高，支持很多高级映射技巧，如：

结果映射：可以映射复杂的数据结构，如一对一、一对多关系。
参数映射：可以支持参数的动态传递和处理。
自动映射：可以自动匹配列名和Java属性名。

高级映射技巧可能会引入一些常见问题，如：

自动映射可能与数据库列名和Java属性名不一致时产生问题。
结果映射如果不正确配置，可能会导致数据转换错误或查询结果不符合预期。
参数映射如果使用不当，可能会导致SQL注入等安全问题。

在实际开发中，需要根据具体的应用场景和性能要求选择合适的映射策略，并注意避免上述问题。同时，合理配置映射文件和使用注解可以提高开发效率和代码的可维护性。

5. MyBatis的高级特性与优化

MyBatis作为一款优秀的持久层框架，其不仅仅是提供了简单的SQL语句映射，还包含许多高级特性，如动态SQL、高级映射机制、事务管理、缓存机制和插件扩展能力等。这些特性为开发者提供了极大的灵活性，优化了数据库操作性能。在本章中，我们将深入探讨这些高级特性的具体应用和优化策略。

5.1 MyBatis映射机制详解

MyBatis的核心优势之一是对SQL语句的灵活映射，可以将复杂的SQL语句逻辑转化为更加清晰的Java代码。了解其映射机制，对于理解和运用MyBatis至关重要。

5.1.1 结果映射和参数映射的原理

在MyBatis中，结果映射（resultMap）允许开发者自定义如何将查询结果集映射到Java对象上，参数映射（parameterMap）则允许定义如何将Java对象作为参数传递给SQL语句。MyBatis通过这种方式提供了高度的灵活性。

结果映射

结果映射通过定义一系列的规则来指定如何将数据库中的列映射到Java对象的属性上。例如：

<resultMap id="userResultMap" type="User">
  <id property="id" column="id" />
  <result property="username" column="username" />
  <result property="password" column="password" />
  <!-- 更多的映射规则 -->
</resultMap>

<resultMap> 标签内定义了从数据库字段到对象属性的映射关系。

参数映射

参数映射同样可以自定义，MyBatis支持简单的传值和复杂的映射，例如使用 #{} 来引用参数对象的属性值：

<select id="getUser" resultMap="userResultMap">
  SELECT * FROM users WHERE username = #{username}
</select>

在上述例子中， #{username} 将会自动匹配到参数对象的 username 属性。

5.1.2 集合与复杂类型的处理

MyBatis能够映射对象的集合以及复杂类型，这对于处理多对一、一对多等关系映射非常有用。

集合映射

处理一对多关系时，可以使用 <collection> 标签映射集合类型的属性：

<resultMap id="orderMap" type="Order">
  <id property="id" column="id" />
  <result property="orderNo" column="order_no" />
  <collection property="items" ofType="Item">
    <id property="id" column="item_id" />
    <result property="itemName" column="item_name" />
  </collection>
</resultMap>

<collection> 标签用于映射对象集合。

复杂类型映射

处理多对一关系时，可以使用 <association> 标签映射复杂类型的属性：

<resultMap id="userMap" type="User">
  <id property="id" column="id" />
  <result property="username" column="username" />
  <association property="address" column="address_id" select="getAddress" />
</resultMap>

<select id="getAddress" resultType="Address">
  SELECT * FROM addresses WHERE id = #{id}
</select>

<association> 标签用于映射对象类型，这里使用了延迟加载，通过 select 属性指定获取关联对象的方法。

5.2 动态SQL的编写与优势

MyBatis的动态SQL能力非常强大，可以根据不同的条件动态拼接SQL语句，极大提高了SQL的复用性。

5.2.1 根据条件动态拼接SQL

动态SQL使用 <if> 、 <choose> 、 <when> 、 <otherwise> 等标签来实现条件判断， <foreach> 标签来遍历集合。

例如：

<select id="findActiveBlogLike" resultType="Blog">
  SELECT * FROM BLOG WHERE state = 'active'
  <if test="title != null">
    AND title like #{title}
  </if>
  <if test="author != null and author.name != null">
    AND author_name like #{author.name}
  </if>
</select>

通过 <if> 标签根据传入的参数动态地添加条件。

5.2.2 动态SQL的效率优化

虽然动态SQL非常灵活，但拼接SQL可能会导致性能下降，尤其是当参数非常多时。为了优化性能，可以采取如下策略：

减少SQL拼接次数。
使用预编译的 PreparedStatement ，减少SQL注入的风险，提高执行效率。
对于复杂的动态SQL，可以考虑使用存储过程来执行。

5.3 事务管理在MyBatis中的实现

MyBatis提供了对JDBC事务的抽象，能够方便地管理事务的提交与回滚。

5.3.1 事务的级别和隔离级别

事务的四个基本特性是ACID，即原子性（Atomicity）、一致性（Consistency）、隔离性（Isolation）、持久性（Durability）。MyBatis支持的事务隔离级别如下：

READ_UNCOMMITTED ：读未提交。
READ_COMMITTED ：读已提交（SQL Server默认级别）。
REPEATABLE_READ ：可重复读（MySQL默认级别）。
SERIALIZABLE ：串行化。

开发者可以在数据源配置中指定隔离级别。

5.3.2 MyBatis中的事务控制方法

在MyBatis中控制事务，主要是通过 SqlSession 实例。 SqlSession 提供了如下事务控制方法：

commit() ：提交事务。
rollback() ：回滚事务。
close() ：关闭会话，会话结束时自动提交或回滚事务。

例如，一个典型的事务控制示例为：

SqlSession session = sqlSessionFactory.openSession();
try {
    session.insert("com.example.mapper.exampleMapper.insertExample", example);
    session.commit();
} catch (Exception e) {
    session.rollback();
} finally {
    session.close();
}

在上述代码中，通过 SqlSession 管理事务，确保了操作的一致性和完整性。

5.4 MyBatis的缓存机制介绍

MyBatis提供了两种缓存机制：一级缓存和二级缓存。两者的目的都是为了减少数据库的访问次数，提高性能。

5.4.1 一级缓存和二级缓存的区别与配置

一级缓存是 SqlSession 级别的缓存，也称为本地缓存，它的生命周期与 SqlSession 相同。二级缓存是 SqlSessionFactory 级别的缓存，可以跨多个 SqlSession 共享。

一级缓存配置

一级缓存默认开启，如果需要配置，可以在 SqlSessionFactory 的配置文件中添加如下配置：

<settings>
  <setting name="localCacheScope" value="SESSION"/>
</settings>

二级缓存配置

二级缓存默认关闭，配置方法如下：

<settings>
  <setting name="cacheEnabled" value="true"/>
  <!-- 其他Mapper配置中开启二级缓存 -->
</settings>

每个 Mapper 配置中需要开启二级缓存：

<cache eviction="LRU" flushInterval="60000" size="512" readOnly="true"/>

5.4.2 缓存策略的定制和应用

缓存策略可以通过 <cache> 元素在MyBatis的映射文件中进行定制。开发者可以设置不同的缓存回收策略（如LRU、FIFO），缓存大小，缓存刷新间隔等。

例如，我们可以将特定的Mapper配置为只读，提高缓存的命中率：

<cache readOnly="true"/>

此外，MyBatis还提供了自定义缓存接口，允许开发者实现自己的缓存策略。

5.5 插件扩展与自定义拦截器

MyBatis的插件系统是其扩展性的一个重要体现。插件可以拦截四大对象中的方法调用，四大对象包括Executor、StatementHandler、ParameterHandler、ResultSetHandler。

5.5.1 MyBatis插件的架构与原理

插件通过Java的动态代理实现。开发者可以通过编写一个拦截器（Interceptor）类，并使用 @Intercepts 注解来指定要拦截的方法。

例如：

@Intercepts({
  @Signature(method = "prepare", type = StatementHandler.class, args = {Connection.class}),
})
public class MyPlugin implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 自定义逻辑
        return invocation.proceed();
    }
}

该插件拦截了 StatementHandler 的 prepare 方法。

5.5.2 自定义拦截器的编写与应用实例

插件开发完成后，需要在MyBatis的配置文件中注册：

<plugins>
  <plugin interceptor="com.example.plugin.MyPlugin"/>
</plugins>

之后，每当被拦截的方法被调用时，MyBatis都会先调用插件。这样，开发者就可以在方法调用前后添加自己的逻辑，例如日志记录、性能监控、SQL优化等。

通过这种方式，MyBatis极大地增强了框架的灵活性和扩展性，使得开发者可以根据实际需要定制自己的持久层框架行为。

本文还有配套的精品资源，点击获取

DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

企业微信如何使用deepseek-最简单的方法

DeepSeek技术社区

deepseek 关闭思考，在ollama中，在代码中

DeepSeek技术社区

第38次CCF-CSP认证——月票发行（chatgpt5 vs deepseekv3.1）

DeepSeek技术社区

所有评论(0)

查看更多评论

浮华ya

@weixin_36178216

已为社区贡献1条内容