小傅哥，docs：《手撸 Mybatis》第2章：实现映射器的注册和使用

MisteryLiuCode · Apr 5, 2022 · e11ca94 · e11ca94
1 parent 659e42c
commit e11ca94
Show file tree

Hide file tree

Showing 5 changed files with 303 additions and 1 deletion.
diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js
@@ -589,7 +589,7 @@ function genBarSpringDevelopMybatis() {
             children: [
                 "2022-03-20-第1章：开篇介绍，手写Mybatis能给你带来什么？.md",
                 "2022-03-27-第2章：创建简单的映射器代理工厂.md",
-                // "2022-04-04-第3章：实现映射器的注册和使用.md",
+                "2022-04-04-第3章：实现映射器的注册和使用.md",
             ]
         }
     ]

diff --git a/docs/.vuepress/public/images/article/spring/mybatis-220404-01.png b/docs/.vuepress/public/images/article/spring/mybatis-220404-01.png
diff --git a/docs/.vuepress/public/images/article/spring/mybatis-220404-02.png b/docs/.vuepress/public/images/article/spring/mybatis-220404-02.png
diff --git a/...op-mybatis/2202-03-27-第2章：创建简单的映射器代理工厂.md → ...op-mybatis/2022-03-27-第2章：创建简单的映射器代理工厂.md b/...op-mybatis/2202-03-27-第2章：创建简单的映射器代理工厂.md → ...op-mybatis/2022-03-27-第2章：创建简单的映射器代理工厂.md
diff --git a/docs/md/spring/develop-mybatis/2022-04-04-第3章：实现映射器的注册和使用.md b/docs/md/spring/develop-mybatis/2022-04-04-第3章：实现映射器的注册和使用.md
@@ -0,0 +1,302 @@
+---
+title: 第3章：实现映射器的注册和使用
+lock: need
+---
+
+# 《Mybatis 手撸专栏》第3章：实现映射器的注册和使用
+
+作者：小傅哥
+<br/>博客：[https://bugstack.cn](https://bugstack.cn)
+
+> 沉淀、分享、成长，让自己和他人都能有所收获！😄
+
+## 一、前言
+
+`如何面对复杂系统的设计？`
+
+我们可以把 Spring、Mybatis、Dubbo 这样的大型框架或者一些公司内部的较核心项目，都可以称为复杂的系统。这样的工程也不在是初学编程手里的玩具项目，没有所谓的CRUD，更多时候要面对的都是对系统分层的结构设计和聚合逻辑功能的实现，再通过层层转换进行实现和调用。
+
+这对于很多刚上道的小码农来说，会感觉非常难受，不知道要从哪下手，但又想着可以一口吃个胖子。其实这是不现实的，因为这些复杂系统中的框架中有太多的内容你还没用了解和熟悉，越是硬搞越难受，信心越受打击。
+
+其实对于解决这类复杂的项目问题，核心在于要将主干问题点缩小，具体的手段包括：分治、抽象和知识。运用设计模式和设计原则等相关知识，把问题空间合理切割为若干子问题，问题越小也就越容易理解和处理。就像你可以把很多内容做成单个独立的案例一样，最终在进行聚合使用。
+
+## 二、目标
+
+在上一章节我们初步的了解了怎么给一个接口类生成对应的映射器代理，并在代理中完成一些用户对接口方法的调用处理。虽然我们已经看到了一个核心逻辑的处理方式，但在使用上还是有些刀耕火种的，包括：需要编码告知 MapperProxyFactory 要对哪个接口进行代理，以及自己编写一个假的 SqlSession 处理实际调用接口时的返回结果。
+
+那么结合这两块问题点，我们本章节要对映射器的注册提供注册机处理，满足用户可以在使用的时候提供一个包的路径即可完成扫描和注册。与此同时需要对 SqlSession 进行规范化处理，让它可以把我们的映射器代理和方法调用进行包装，建立一个生命周期模型结构，便于后续的内容的添加。
+
+## 三、设计
+
+鉴于我们希望把整个工程包下关于数据库操作的 DAO 接口与 Mapper 映射器关联起来，那么就需要包装一个可以扫描包路径的完成映射的注册器类。
+
+当然我们还要把上一章节中简化的 SqlSession 进行完善，由 SqlSession 定义数据库处理接口和获取 Mapper 对象的操作，并把它交给映射器代理类进行使用。*这一部分是对上一章节内容的完善*
+
+有了 SqlSession 以后，你可以把它理解成一种功能服务，有了功能服务以后还需要给这个功能服务提供一个工厂，来对外统一提供这类服务。比如我们在 Mybatis 中非常常见的操作，开启一个 SqlSession。整个设计可以如图 3-1
+
+![图 3-1 映射器的注册和使用](https://bugstack.cn/images/article/spring/mybatis-220404-01.png)
+
+- 以包装接口提供映射器代理类为目标，补全映射器注册机 `MapperRegistry`，自动扫描包下接口并把每个接口类映射的代理类全部存入映射器代理的 HashMap 缓存中。
+- 而 SqlSession、SqlSessionFactory 是在此注册映射器代理的上次层使用标准定义和对外服务提供的封装，便于用户使用。*我们把使用方当成用户* 经过这样的封装就就可以更加方便我们后续在框架上功能的继续扩展了，也希望大家可以在学习的过程中对这样的设计结构有一些思考，它可以帮助你解决一些业务功能开发过程中的领域服务包装。
+
+## 四、实现
+
+### 1. 工程结构
+
+```java
+mybatis-step-02
+└── src
+    ├── main
+    │   └── java
+    │       └── cn.bugstack.mybatis
+    │           ├── binding
+    │           │   ├── MapperProxy.java
+    │           │   ├── MapperProxyFactory.java
+    │           │   └── MapperRegistry.java
+    │           └── session
+    │               ├── defaults
+    │               │   ├── DefaultSqlSession.java
+    │               │   └── DefaultSqlSessionFactory.java
+    │               ├── SqlSession.java
+    │               └── SqlSessionFactory.java
+    └── test
+        └── java
+            └── cn.bugstack.mybatis.test.dao
+                ├── dao
+                │   ├── ISchoolDao.java
+                │   └── IUserDao.java
+                └── ApiTest.java
+```
+
+工程源码：[https://t.zsxq.com/bmqNFQ7](https://t.zsxq.com/bmqNFQ7)
+
+映射器标准定义实现关系，如图 3-2
+
+![图 3-2 映射器标准定义实现关系](https://bugstack.cn/images/article/spring/mybatis-220404-02.png)
+
+- MapperRegistry 提供包路径的扫描和映射器代理类注册机服务，完成接口对象的代理类注册处理。
+- SqlSession、DefaultSqlSession 用于定义执行 SQL 标准、获取映射器以及将来管理事务等方面的操作。基本我们平常使用 Mybatis 的 API 接口也都是从这个接口类定义的方法进行使用的。
+- SqlSessionFactory 是一个简单工厂模式，用于提供 SqlSession 服务，屏蔽创建细节，延迟创建过程。
+
+### 2. 映射器注册机
+
+**源码详见**：`cn.bugstack.mybatis.binding.MapperRegistry`
+
+```java
+public class MapperRegistry {
+
+    /**
+     * 将已添加的映射器代理加入到 HashMap
+     */
+    private final Map<Class<?>, MapperProxyFactory<?>> knownMappers = new HashMap<>();
+
+    public <T> T getMapper(Class<T> type, SqlSession sqlSession) {
+        final MapperProxyFactory<T> mapperProxyFactory = (MapperProxyFactory<T>) knownMappers.get(type);
+        if (mapperProxyFactory == null) {
+            throw new RuntimeException("Type " + type + " is not known to the MapperRegistry.");
+        }
+        try {
+            return mapperProxyFactory.newInstance(sqlSession);
+        } catch (Exception e) {
+            throw new RuntimeException("Error getting mapper instance. Cause: " + e, e);
+        }
+    }
+
+    public <T> void addMapper(Class<T> type) {
+        /* Mapper 必须是接口才会注册 */
+        if (type.isInterface()) {
+            if (hasMapper(type)) {
+                // 如果重复添加了，报错
+                throw new RuntimeException("Type " + type + " is already known to the MapperRegistry.");
+            }
+            // 注册映射器代理工厂
+            knownMappers.put(type, new MapperProxyFactory<>(type));
+        }
+    }
+
+    public void addMappers(String packageName) {
+        Set<Class<?>> mapperSet = ClassScanner.scanPackage(packageName);
+        for (Class<?> mapperClass : mapperSet) {
+            addMapper(mapperClass);
+        }
+    }
+
+}
+```
+
+- MapperRegistry 映射器注册类的核心主要在于提供了 `ClassScanner.scanPackage` 扫描包路径，调用 `addMapper` 方法，给接口类创建 `MapperProxyFactory` 映射器代理类，并写入到 knownMappers 的 HashMap 缓存中。
+- 另外就是这个类也提供了对应的 getMapper 获取映射器代理类的方法，其实这步就包装了我们上一章节手动操作实例化的过程，更加方便在 DefaultSqlSession 中获取 Mapper 时进行使用。
+
+### 3. SqlSession 标准定义和实现
+
+**源码详见**：`cn.bugstack.mybatis.session.SqlSession`
+
+```java
+public interface SqlSession {
+
+    /**
+     * Retrieve a single row mapped from the statement key
+     * 根据指定的SqlID获取一条记录的封装对象
+     *
+     * @param <T>       the returned object type 封装之后的对象类型
+     * @param statement sqlID
+     * @return Mapped object 封装之后的对象
+     */
+    <T> T selectOne(String statement);
+
+    /**
+     * Retrieve a single row mapped from the statement key and parameter.
+     * 根据指定的SqlID获取一条记录的封装对象，只不过这个方法容许我们可以给sql传递一些参数
+     * 一般在实际使用中，这个参数传递的是pojo，或者Map或者ImmutableMap
+     *
+     * @param <T>       the returned object type
+     * @param statement Unique identifier matching the statement to use.
+     * @param parameter A parameter object to pass to the statement.
+     * @return Mapped object
+     */
+    <T> T selectOne(String statement, Object parameter);
+
+    /**
+     * Retrieves a mapper.
+     * 得到映射器，这个巧妙的使用了泛型，使得类型安全
+     *
+     * @param <T>  the mapper type
+     * @param type Mapper interface class
+     * @return a mapper bound to this SqlSession
+     */
+    <T> T getMapper(Class<T> type);
+
+}
+```
+
+- 在 SqlSession 中定义用来执行 SQL、获取映射器对象以及后续管理事务操作的标准接口。
+- 目前这个接口中对于数据库的操作仅仅只提供了 selectOne，后续还会有相应其他方法的定义。
+
+**源码详见**：`cn.bugstack.mybatis.session.defaults`
+
+```java
+public class DefaultSqlSession implements SqlSession {
+
+    /**
+     * 映射器注册机
+     */
+    private MapperRegistry mapperRegistry;
+
+    @Override
+    public <T> T selectOne(String statement, Object parameter) {
+        return (T) ("你被代理了！" + "方法：" + statement + " 入参：" + parameter);
+    }
+
+    @Override
+    public <T> T getMapper(Class<T> type) {
+        return mapperRegistry.getMapper(type, this);
+    }
+
+}
+```
+
+- 通过 DefaultSqlSession 实现类对 SqlSession 接口进行实现。
+- getMapper 方法中获取映射器对象是通过 MapperRegistry 类进行获取的，后续这部分会被配置类进行替换。
+- 在 selectOne 中是一段简单的内容返回，目前还没有与数据库进行关联，这部分在我们渐进式的开发过程中逐步实现。
+
+### 4. SqlSessionFactory 工厂定义和实现
+
+**源码详见**：`cn.bugstack.mybatis.session.SqlSessionFactory`
+
+```java
+public interface SqlSessionFactory {
+
+    /**
+     * 打开一个 session
+     * @return SqlSession
+     */
+   SqlSession openSession();
+
+}
+```
+
+- 这其实就是一个简单工厂的定义，在工厂中提供接口实现类的能力，也就是 SqlSessionFactory 工厂中提供的开启 SqlSession 的能力。
+
+**源码详见**：`cn.bugstack.mybatis.session.defaults.DefaultSqlSessionFactory`
+
+```java
+public class DefaultSqlSessionFactory implements SqlSessionFactory {
+
+    private final MapperRegistry mapperRegistry;
+
+    public DefaultSqlSessionFactory(MapperRegistry mapperRegistry) {
+        this.mapperRegistry = mapperRegistry;
+    }
+
+    @Override
+    public SqlSession openSession() {
+        return new DefaultSqlSession(mapperRegistry);
+    }
+
+}
+```
+
+- 默认的简单工厂实现，处理开启 SqlSession 时，对 DefaultSqlSession 的创建以及传递 mapperRegistry，这样就可以在使用 SqlSession 时获取每个代理类的映射器对象了。
+
+## 五、测试
+
+### 1. 事先准备
+
+在同一个包路径下，提供2个以上的 Dao 接口：
+
+```java
+public interface ISchoolDao {
+
+    String querySchoolName(String uId);
+
+}
+
+public interface IUserDao {
+
+    String queryUserName(String uId);
+
+    Integer queryUserAge(String uId);
+
+}
+```
+
+### 2. 单元测试
+
+```java
+@Test
+public void test_MapperProxyFactory() {
+    // 1. 注册 Mapper
+    MapperRegistry registry = new MapperRegistry();
+    registry.addMappers("cn.bugstack.mybatis.test.dao");
+
+    // 2. 从 SqlSession 工厂获取 Session
+    SqlSessionFactory sqlSessionFactory = new DefaultSqlSessionFactory(registry);
+    SqlSession sqlSession = sqlSessionFactory.openSession();
+
+    // 3. 获取映射器对象
+    IUserDao userDao = sqlSession.getMapper(IUserDao.class);
+
+    // 4. 测试验证
+    String res = userDao.queryUserName("10001");
+    logger.info("测试结果：{}", res);
+}
+```
+
+- 在单元测试中通过注册机扫描包路径注册映射器代理对象，并把注册机传递给 SqlSessionFactory 工厂，这样完成一个链接过程。
+- 之后通过 SqlSession 获取对应 DAO 类型的实现类，并进行方法验证。
+
+**测试结果**
+
+```java
+22:43:23.254 [main] INFO  cn.bugstack.mybatis.test.ApiTest - 测试结果：你被代理了！方法：queryUserName 入参：[Ljava.lang.Object;@50cbc42f
+
+Process finished with exit code 0
+```
+
+- 通过测试大家可以看到，目前我们已经在一个有 Mybatis 影子的手写 ORM 框架中，完成了代理类的注册和使用过程。
+
+## 六、总结
+
+- 首先要从设计结构上了解工厂模式对具体功能结构的封装，屏蔽过程细节，限定上下文关系，把对外的使用减少耦合。
+- 从这个过程上读者伙伴也能发现，使用 SqlSessionFactory 的工厂实现类包装了 SqlSession 的标准定义实现类，并由 SqlSession 完成对映射器对象的注册和使用。
+- 本章学习要注意几个重要的知识点，包括：映射器、代理类、注册机、接口标准、工厂模式、上下文。这些工程开发的技巧都是在手写 Mybatis 的过程中非常重要的部分，了解和熟悉才能更好的在自己的业务中进行使用。