当前位置：首页 > news >正文

Mybatis框架之建造者模式 (Builder Pattern)

news 2026/2/8 23:48:40

MyBatis 框架中大量使用了 建造者模式 (Builder Pattern) 来构建复杂的对象，尤其是在 SQL 语句的解析、配置对象的创建以及动态 SQL 的生成 等方面。建造者模式使得 MyBatis 能够更灵活、清晰地构建对象，尤其是那些需要多步创建和配置的复杂对象。

1. 什么是建造者模式 (Builder Pattern)？

建造者模式 是一种创建型设计模式，用于将一个复杂对象的构建与其表示分离，使得同样的构建过程可以创建不同的表示。

特点：

分步构建：将对象的构建过程分为多个步骤，每一步负责配置对象的某一部分。
解耦构建和表示：建造者模式将对象的构建过程与对象的表示分离，使得我们可以通过不同的建造者创建不同的对象表示。
易于扩展：通过定义新的建造者类，可以轻松扩展对象的创建方式。

2. MyBatis 中建造者模式的应用场景

在 MyBatis 中，建造者模式被广泛应用于以下几个场景：

SqlSessionFactoryBuilder：用于创建 SqlSessionFactory 对象。
XMLConfigBuilder 和 XMLMapperBuilder：用于解析 XML 配置文件和映射文件。
动态 SQL 语句构建：通过 SQL 类来动态生成 SQL 语句。

3. MyBatis 建造者模式的实现

3.1 `SqlSessionFactoryBuilder`

SqlSessionFactoryBuilder 是 MyBatis 中最典型的建造者模式的实现，它用于构建 SqlSessionFactory 对象。SqlSessionFactory 是 MyBatis 的核心接口，用于创建 SqlSession，而 SqlSession 则是用于执行 SQL 语句、获取 Mapper 实例的接口。

构建流程：

加载 MyBatis 配置文件。
解析配置文件，构建 Configuration 对象。
使用 Configuration 对象创建 SqlSessionFactory 实例。

代码示例：

Step 1: 使用 `SqlSessionFactoryBuilder` 创建 `SqlSessionFactory`

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

Step 2: 解析配置文件 (`SqlSessionFactoryBuilder` 源码示例)

public class SqlSessionFactoryBuilder {public SqlSessionFactory build(InputStream inputStream) {// 1. 创建 XML 配置解析器XMLConfigBuilder parser = new XMLConfigBuilder(inputStream);// 2. 解析配置文件并构建 Configuration 对象Configuration configuration = parser.parse();// 3. 使用 Configuration 对象创建 SqlSessionFactoryreturn new DefaultSqlSessionFactory(configuration);}
}

Step 3: 解析 XML 配置文件 (`XMLConfigBuilder` 源码示例)

public class XMLConfigBuilder {private Configuration configuration;public XMLConfigBuilder(InputStream inputStream) {this.configuration = new Configuration();this.parser = new XPathParser(inputStream);}public Configuration parse() {// 解析 <environments>、<mappers> 等标签parseConfiguration(parser.evalNode("/configuration"));return configuration;}private void parseConfiguration(XNode root) {// 解析不同的配置节点environmentsElement(root.evalNode("environments"));mappersElement(root.evalNode("mappers"));}
}

4. MyBatis 中的动态 SQL 构建

MyBatis 还使用建造者模式来构建动态 SQL 语句。通过 SQL 类 提供一种灵活的方式来动态构建复杂的 SQL 语句。

示例代码：

import org.apache.ibatis.jdbc.SQL;public String buildSelectUserSql() {return new SQL().SELECT("id, name, email").FROM("users").WHERE("status = 'active'").ORDER_BY("created_at DESC").toString();
}

生成的 SQL 语句为：

SELECT id, name, email FROM users WHERE status = 'active' ORDER BY created_at DESC;

解析：

SQL 类是 MyBatis 提供的一个内置的建造者工具，用于动态拼接 SQL 语句。
每个方法（如 SELECT()、FROM()、WHERE() 等）都会返回当前对象 (this)，从而支持链式调用。

5. MyBatis 中 `MapperBuilderAssistant`

MyBatis 还使用了 MapperBuilderAssistant 类来帮助构建 Mapper 的映射配置。

代码片段示例：

public class XMLMapperBuilder {private final MapperBuilderAssistant builderAssistant;public XMLMapperBuilder(InputStream inputStream, Configuration configuration, String resource) {this.builderAssistant = new MapperBuilderAssistant(configuration, resource);}public void parse() {// 解析 SQL 语句builderAssistant.addMappedStatement(id, sqlSource, ...);}
}

6. MyBatis 建造者模式的优势

降低复杂度：将复杂对象的构建逻辑封装在建造者类中，简化了调用者的使用。
提高可维护性：建造者模式使得 MyBatis 的配置和对象创建更具结构化，便于后续的维护和扩展。
灵活性：支持通过多步骤构建对象，并允许在构建过程中动态调整配置。
链式调用：动态 SQL 生成器支持链式调用，代码更简洁直观。

7. 建造者模式的不足

增加类的数量：使用建造者模式会增加类的数量，尤其在大规模项目中，可能导致类层次复杂化。
学习成本：对于不熟悉设计模式的开发者，理解 MyBatis 的建造者模式可能会有一定的学习曲线。

8. 总结

MyBatis 通过建造者模式，在多个核心组件的创建过程中有效地降低了复杂度。无论是 SqlSessionFactory 的构建、Mapper 配置的解析，还是动态 SQL 语句的生成，建造者模式都扮演了重要角色。它不仅提高了代码的复用性和灵活性，还使得整个框架的设计更加模块化和可维护。因此，MyBatis 的建造者模式是其高效、简洁的核心之一。