Mybatis系列全解（一）：手写一套持久层框架

封面 ： 洛小汐
作者 ： 潘潘

自毕业以后，自己先创业后上班，浮沉了近8年，内心着实焦躁，虽一直是走科班路线，但在技术道路上却始终没静下心来研究、思考、梳理，机会来了，便抓牢。
希望自己记录下来的知识内容，对后来的学习之人，能有些许帮助。

第一个系列的文章主要围绕「架构师（Java）技术条线」展开聊，不定时更新。
第一篇我以《手写一套持久层框架》先来打个样，本篇文章我们先不介绍MyBatis，也不会分析源码，我们先聊一个 Java API：JDBC。
JDBC是Java的老朋友，我们再一次认识他吧，挑挑他的毛病，站在Java资老朋友的角度，给他提点优化意见，并送他一套《自定义持久层框架》。

温馨提示：

如果大家在阅读过程中，对某些解决思路存在疑问，我建议大家先带着疑问阅读完，消化理解，因为导师们确实是通过研究Mybatis等持久层框架源码之后，反过来剖析的。

简单来说 “ 大厂都这么写，我们且这么跟随吧 ”。

Mybaits系列全解 (持续更新)

• Mybatis系列全解（一）：手写一套持久层框架
• Mybatis系列全解（二）：Mybatis简介与环境搭建
• Mybatis系列全解（三）：Mybatis简单CRUD使用介绍
• Mybatis系列全解（四）：全网最全！Mybatis配置文件XML全貌详解
• Mybatis系列全解（五）：全网最全！详解Mybatis的Mapper映射文件
• Mybatis系列全解（六）：Mybatis最硬核的API你知道几个？
• Mybatis系列全解（七）：全息视角看Dao层两种实现方式之传统方式与代理方式
• Mybatis系列全解（八）：Mybatis的动态SQL
• Mybatis系列全解（九）：Mybatis的复杂映射
• Mybatis系列全解（十）：Mybatis注解开发
• Mybatis系列全解（十一）：Mybatis缓存全解
• Mybatis系列全解（十二）：Mybatis插件开发
• Mybatis系列全解（十三）：Mybatis代码生成器
• Mybatis系列全解（十四）：Spring集成Mybatis
• Mybatis系列全解（十五）：SpringBoot集成Mybatis
• Mybatis系列全解（十六）：Mybatis源码剖析

一、JDBC是谁？

JDBC是谁？干啥的？到底有多能打？看看网络上的朋友们怎么说。

Java数据库连接，（Java Database Connectivity，简称JDBC）是Java语言中用来规范客户端程序如何来访问数据库的应用程序接口，提供了诸如查询和更新数据库中数据的方法。

– 来自百度百科

JDBC(Java DataBase Connectivity,java数据库连接)是一种用于执行SQL语句的Java API，可以为多种关系数据库提供统一访问，它由一组用Java语言编写的类和接口组成。JDBC提供了一种基准，据此可以构建更高级的工具和接口，使数据库开发人员能够编写数据库应用程序。

– 来自360百科

… 无法访问此网站

– 来自维基百科

以上基本就是JDBC的大致介绍，官方且严谨的说辞，That’s It ， 我们往下看看，它曾经的高光时刻。

自从Java语言于1995年5月正式公布以来，Java风靡全球。出现大量的用java语言编写的程序，其中也包括数据库应用程序。由于没有一个Java语言的API，编程人员不得不在Java程序中加入C语言的ODBC函数调用。这就使很多Java的优秀特性无法充分发挥，比如平台无关性、面向对象特性等。随着越来越多的编程人员对Java语言的日益喜爱，越来越多的公司在Java程序开发上投入的精力日益增加，对java语言接口的访问数据库的API的要求越来越强烈。也由于ODBC的有其不足之处，比如它并不容易使用，没有面向对象的特性等等，SUN公司决定开发一Java语言为接口的数据库应用程序开发接口。在JDK1.x版本中，JDBC只是一个可选部件，到了JDK1.1公布时，SQL类包(也就是JDBCAPI)就成为Java语言的标准部件。

后面从JDBC1.0到JDBC4.0，一路发展。

– 来自网络

结合介绍说明加深我们对JDBC的了解。

不过，我想知道他平时是如何工作的？一张图 《 JDBC 基本架构 》 了解一下：

有了JDBC，向各种关系数据库发送SQL语句就是一件很容易的事。

换言之，有了JDBC API，就不必为访问Sybase数据库专门写一个程序，为访问Oracle数据库又专门写一个程序，或为访问Mysql数据库又编写另一个程序等等，程序员只需用JDBC API写一个程序就够了，它可向相应数据库发送SQL调用。

同时，将Java语言和JDBC结合起来使程序员不必为不同的平台编写不同的应用程序，只须写一遍程序就可以让它在任何平台上运行，这也是Java语言"编写一次，处处运行"的优势。

我们再来看看他工作的细节。

毕竟，曾有人说过：想了解一个人，就得先仔细了解Ta的工作。

二、JDBC如何工作？

JDBC API 允许应用程序访问任何形式的表格数据，特别是存储在关系数据库中的数据。

执行流程主要分三步：

• 连接数据源。
• 为数据库传递查询和更新指令。
• 处理数据库响应并返回的结果。

但实际上，每步流程都特别细节：

使用流程 （详细说明）

1.加载数据库驱动：

程序中使用Class.forName(‘驱动’)加载驱动，JVM会寻找并加载指定驱动类，同时执行驱动类的静态代码段，在JDK1.6之前JDBC规范中明确要求各家在实现Driver类时必须在静态代码段中向DriverManager注册实例，JDK1.6之后各家实现的Driver类则不再需要主动注册实例，因为DriverManager已经在初始化阶段对所有jar包中实现了java.sql.Driver的类进行扫描并进行初始化。

2. 创建数据库连接：

DriverManager通过遍历所有已注册的驱动来尝试获取连接，第一个匹配上就会直接返回，并使用对应驱动建立起客户端与数据库服务器的网络连接（物理连接Socket了解一下）。

3. 创建编译对象：

数据库连接connection成功之后，我们会向数据库发送一次请求（statement），执行一条sql语句，一个连接可以执行多次statement，除非你关闭连接，其中还有一个概念就是事务transaction，事务和请求可以是一对一，也可以是一对多，这取决于你是想把多个请求statement作为同一个事务提交，还是一个请求提交一次事务，JDBC默认是事务是自动提交，即auto-commit是打开的，所以默认是一对一。

4. 设置入参执行SQL：

为了防止SQL注入，我们使用预处理在sql中使用?作为输入参数的占位符，sql在编译后成为安全的sql语句再进行查询（有缘我们可以聊聊为何预处理机制能防止SQL注入）。

5. 封装返回结果集：

SQL执行之后会把结果集封装到ResultSet类，ResultSet类本身的迭代器初始行数的位置是1，所以我们会发现与java.util.Iterator接口的迭代初始行数为0有差异，同时ResultSet类本身没有提供hasNext方法，所以我们会不断的while(rs.next())往后定位，再通过不同的类型的访问器读取数据（例如getString,getInteger等）。

6. 释放数据库连接资源：

考虑到数据库连接占用了数据库服务器的内存资源，所以不可能无限制建立连接，用完就释放，养成好习惯，目前很多成熟的数据连接池技术，很好的优化管理的数据连接问题。

我们通过一段简单的例子来演示一下使用流程，本例子使用JDBC操作mysql数据库，先看看我们最终的项目结构与JDBC API在JDK中rt.jar的结构：

• 项目结构：

• JDBC API在JDK中rt.jar的结构：

默认已具备java开发环境、mysql数据库

1. 创建mave工程，并且引入mysql驱动依赖

mysqlmysql-connector-java5.1.25

2. 创建java测试类

    
package com.panshenlian.jdbc;

import com.panshenlian.po.User;

import java.sql.*;

/**
 * @Author: panshenlian
 * @Description: 演示通过JDBC连接mysql数据库
 * @Date: Create in 20:11 2020/11/10
 */
public class Test01 {

    public static void main(String[] args) {
        User user = new User();
        Connection connection = null;
        PreparedStatement preparedStatement = null;
        ResultSet resultSet = null;
        try {
            // 加载数据库驱动
            Class.forName("com.mysql.jdbc.Driver");
            // 通过驱动管理类获取数据库连接
            connection = 
               DriverManager.getConnection(
                  "jdbc:mysql://localhost:3306/mybatis"+
                  "?characterEncoding=utf-8",
                  "root","123456");
            // 定义SQL语句 ？ 表示占位符
            String sql = " select * from user where username = ? ";
            // 获取预处理statement对象
            preparedStatement = connection.prepareStatement(sql);
            // 设置参数
            //   第一个参数sql语句中参数的序号（从1开始）
            //   第二个参数为设置的参数值
            preparedStatement.setString(1,"panshenlian");
            // 向数据库发出sql执行查询，查询出结果集
            resultSet = preparedStatement.executeQuery();
            // 遍历查询结果集
            while(resultSet.next()){
                int id = resultSet.getInt("id");
                String name = resultSet.getString("username");
                // 封装User
                user.setId(id);
                user.setUserName(name);
                System.out.println(user);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // 释放资源
           if(resultSet!=null){
               try {
                   resultSet.close();
               } catch (SQLException e) {
                   e.printStackTrace();
               }
           }
          if(preparedStatement!=null){
              try {
                  preparedStatement.close();
              } catch (SQLException e) {
                  e.printStackTrace();
              }
          }
          if(connection!=null){
              try {
                  connection.close();
              } catch (SQLException e) {
                  e.printStackTrace();
              }
           }
        }
    }
}

3. 创建User类

package com.panshenlian.po;

/**
 * @Author: panshenlian
 * @Description: 用户实体
 * @Date: Create in 20:10 2020/11/10
 */
public class User {

    private  Integer id;
    private String userName;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", userName='" + userName + '\'' +
                '}';
    }
}

4. 创建sql语句

-- ----------------------------
-- Table structure for user
-- ----------------------------
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(50) DEFAULT NULL,
  `password` varchar(50) DEFAULT NULL,
  `birthday` varchar(50) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;

-- ----------------------------
-- Records of user
-- ----------------------------
INSERT INTO `user` VALUES ('1', 'senly', '123', '2020-11-10');
INSERT INTO `user` VALUES ('2', 'panshenlian', '123456', '2020-11-10');

5. 执行结果，nice , 成功。

User{id=2, userName='panshenlian'}

看完这段演示，大家是否发现一个问题？就是整个JDBC操作数据库的使用过程繁琐而尴尬，就如这场对话：

额… JDBC你确实挺烦的。

我懂你需要和数据库建立连接、执行SQL语句、处理查询结果集…

但是，这整个过程，能不能优化一下呢？

三、JDBC存在哪些待优化的地方？

我们平时瘦身增肌，工作更得提质增效，来，我们剖开代码，逐个分析：

			
// 加载数据库驱动
Class.forName("com.mysql.jdbc.Driver");
// 通过驱动管理类获取数据库链接
connection = DriverManager.getConnection(
    "jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8",
    "root","123456");
                    

• 存在问题1：数据库配置信息存在硬编码问题。

  优化思路：使用配置文件！

• 存在问题2：频繁创建、释放数据库连接问题。

  优化思路：使用数据连接池！

			
 // 定义SQL语句 ？ 表示占位符
 String sql = " select * from user where username = ? ";
 // 获取预处理statement对象
 preparedStatement = connection.prepareStatement(sql);
 // 设置参数，第一个参数sql语句中参数的序号（从1开始），第二个参数为设置的参数值
 preparedStatement.setString(1,"tom");
 // 向数据库发出sql执行查询，查询出结果集
 resultSet = preparedStatement.executeQuery();
                    

• 存在问题3：SQL语句、设置参数、获取结果集参数均存在硬编码问题 。

  优化思路：使用配置文件！

// 遍历查询结果集
while(resultSet.next()){
   int id = resultSet.getInt("id");
   String userName = resultSet.getString("username");
   // 封装User
   user.setId(id);
   user.setUserName(userName);
   System.out.println(user);
}
                    

• 存在问题4：手动封装返回结果集，较为繁琐。

  优化思路：使用Java反射、自省！

针对JDBC各个环节中存在的不足，现在，我们整理出对应的优化思路，统一汇总：

假如让你来优化，你会根据这些优化思路如何设计一套持久层框架呢？

四、自定义持久层框架：思路分析

JDBC是个人作战，凡事亲力亲为，低效而高险，自己加载驱动，自己建连接，自己 …

而持久层框架好比是多工种协作，分工明确，执行高效，有专门负责解析注册驱动建立连接的，有专门管理数据连接池的，有专门执行sql语句的，有专门做预处理参数的，有专门装配结果集的 …

 框架的作用，就是为了帮助我们减去繁重开发细节与冗余代码，使我们能更加专注于业务应用开发。 

来，我们一起看看使用JDBC和使用持久层框架有什么区别？

使用框架对于我们使用者（主要是研发人员），是有多舒爽呢？

是不是发现，拥有这么一套持久层框架是如此舒适，我们仅仅需要干两件事：

• 配置数据源（地址/数据名/用户名/密码）
• 编写SQL与参数准备（SQL语句/参数类型/返回值类型）

框架，除了思考本身的工程设计，还需要考虑到实际项目端的使用场景，干系方涉及两端：

• 使用端（实际项目）

• 持久层框架本身

以上两步，我们通过一张架构图《 手写持久层框架基本思路 》来梳理清楚：

核心接口/类重点说明：

正常来说项目只对应一套数据库环境，一般对应一个SqlSessionFactory实例对象，我们使用单例模式只创建一个SqlSessionFactory实例。

如果需要配置多套数据库环境，那需要做一些拓展，例如Mybatis中通过environments等配置就可以支持多套测试/生产数据库环境进行切换。

梳理完持久层框架的基本思路，明确了框架各角色分工，我们开始梳理详细方案：

A、项目使用端，调用框架API，除了引入持久层框架的jar包之外，还需额外提供两部分配置信息：

​

 1. sqlMapConfig.xml : 数据库配置信息（地址/数据名/用户名/密码），以及mapper.xml的全路径。
 2. mapper.xml : SQL配置信息，存放SQL语句、参数类型、返回值类型相关信息。

B、框架本身，实质上就是对JDBC代码进行封装，基本6步：

1. 加载配置文件：根据配置文件的路径，加载配置文件成字节输入流，存储在内存中。

创建Resource类，提供加载流方法：InputStream getResourceAsStream(String path)

2. 创建两个javaBean（容器对象）：存放配置文件解析出来的内容

 
 Configuration（核心配置类）：存放sqlMapConfig.xml解析出来的内容。
 MappedStatement（映射配置类）：存放mapper.xml解析出来的内容。
 

3. 解析配置文件（使用dom4j） ，并创建SqlSession会话对象

 
 创建类：SqlSessionFactoryBuilder 方法：build(InputStream in)
 > 使用dom4j解析配置文件，将解析出来的内容封装到容器对象中
 > 创建SqlSessionFactory对象，生产sqlSession会话对象（工厂模式）
 

4. 创建SqlSessionFactory接口以及实现类DefaultSqlSessionFactory

  创建openSession()接口方法，生产sqlSession
 

5. 创建SqlSession接口以及实现类DefaultSqlSession

  定义对数据库的CRUD操作：
  > selectList();
  > selectOne();
  > update();
  > delete();
 

6. 创建Executor接口以及实现类SimpleExecutor

  创建query(Configuration conf,MappedStatement ms,Object... params)
  实际执行的就是JDBC代码。
 

基本过程我们已经清晰，我们再细化一下类图，更好的助于我们实际编码：

简约版

详细版

最终手写的持久层框架结构参考：

包接口类说明

• config包

• io包

• pojo包

• sqlSession包

• utils

五、自定义持久层框架：编码

结合UML图和项目结构图，脑海里开始有点东西了，烧脑且枯燥的编码过程，我们开始吧。

框架依赖 pom.xml

<?xml version="1.0" encoding="UTF-8"?>
4.0.0com.panshenlianMyPersistence1.0-SNAPSHOTUTF-8UTF-81.81.81.8mysqlmysql-connector-java5.1.17c3p0c3p00.9.1.2log4jlog4j1.2.12junitjunit4.10dom4jdom4j1.6.1jaxenjaxen1.1.6

config包下BoundSql类

package com.panshenlian.config;

import com.panshenlian.utils.ParameterMapping;

import java.util.ArrayList;
import java.util.List;

/**
 * @Author: panshenlian
 * @Description: SQL通配类
 * @Date: Create in 16:12 2020/11/12
 */
public class BoundSql {

    /**
     * 解析过的sql语句
     */
    private String sqlText;

    private List parameterMappingList =
            new ArrayList();

    public BoundSql(String sqlText, List parameterMappingList) {
        this.sqlText = sqlText;
        this.parameterMappingList = parameterMappingList;
    }

    public String getSqlText() {
        return sqlText;
    }

    public void setSqlText(String sqlText) {
        this.sqlText = sqlText;
    }

    public List getParameterMappingList() {
        return parameterMappingList;
    }

    public void setParameterMappingList(List parameterMappingList) {
        this.parameterMappingList = parameterMappingList;
    }
}

config包下XMLConfigBuilder类

package com.panshenlian.config;

import com.mchange.v2.c3p0.ComboPooledDataSource;
import com.panshenlian.io.Resource;
import com.panshenlian.pojo.Configuration;
import com.sun.javafx.scene.control.skin.EmbeddedTextContextMenuContent;
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.Element;
import org.dom4j.io.SAXReader;

import java.io.InputStream;
import java.util.List;
import java.util.Properties;

/**
 * @Author: panshenlian
 * @Description: 数据库配置信息解析类
 * @Date: Create in 13:56 2020/11/12
 */
public class XMLConfigBuilder {

    private Configuration configuration;

    public XMLConfigBuilder() {
        this.configuration = new Configuration();
    }

    public Configuration parseConfig(InputStream inputStream) throws Exception {

        Document document = new SAXReader().read(inputStream);
        Element configurationRootElement = document.getRootElement();

        // 解析数据源配置dataSource下的参数信息
        List elementList = configurationRootElement.selectNodes("//property");
        Properties properties = new Properties();
        for (Element element : elementList){
            String name = element.attributeValue("name");
            String value = element.attributeValue("value");
            properties.put(name,value);
        }

        // 使用c3p0数据源
        ComboPooledDataSource dataSource = new ComboPooledDataSource();
        dataSource.setDriverClass(properties.getProperty("driverClass"));
        dataSource.setJdbcUrl(properties.getProperty("jdbcUrl"));
        dataSource.setUser(properties.getProperty("userName"));
        dataSource.setPassword(properties.getProperty("password"));

        // 设置数据源
        configuration.setDataSource(dataSource);

        // 解析mapper.xml，根据路径读取字节输入流，使用dom4j进行解析
        List mapperElementList = configurationRootElement.selectNodes("//mapper");
        for (Element element : mapperElementList) {
            String mapperPath = element.attributeValue("resource");
            InputStream resourceAsStream = Resource.getResourceAsStream(mapperPath);
            XMLMapperBuilder xmlMapperBuilder = new XMLMapperBuilder(configuration);
            xmlMapperBuilder.parseMapper(resourceAsStream);
        }

        return configuration;
    }
}

config包下XMLMapperBuilder类

package com.panshenlian.config;

import com.panshenlian.pojo.Configuration;
import com.panshenlian.pojo.MappedStatement;
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.Element;
import org.dom4j.io.SAXReader;

import java.io.InputStream;
import java.util.List;

/**
 * @Author: panshenlian
 * @Description: SQL配置信息解析类
 * @Date: Create in 14:28 2020/11/12
 */
public class XMLMapperBuilder {

    private Configuration configuration;

    public XMLMapperBuilder(Configuration configuration) {
        this.configuration = configuration;
    }

    public void parseMapper(InputStream inputStream) throws DocumentException {

        Document mapperDocument = new SAXReader().read(inputStream);
        Element rootElement = mapperDocument.getRootElement();
        String namespace = rootElement.attributeValue("namespace");

        // 解析每一个select节点
        List selectNodes = mapperDocument.selectNodes("//select");
        for (Element element : selectNodes) {
            String id = element.attributeValue("id");
            String resultType = element.attributeValue("resultType");
            String parameterType = element.attributeValue("parameterType");
            String sql = element.getTextTrim();

            // 解析封装进入MapperdStatement对象
            MappedStatement mappedStatement = new MappedStatement();
            mappedStatement.setId(id);
            mappedStatement.setResultType(resultType);
            mappedStatement.setParameterType(parameterType);
            mappedStatement.setSql(sql);
            String statementId = namespace + "." + id;
            configuration.getMappedStatementMap().put(statementId,mappedStatement);
        }

    }
}

io包下Resource工具类

package com.panshenlian.io;

import java.io.InputStream;

/**
 * @Author: panshenlian
 * @Description: 资源类
 * @Date: Create in 9:22 2020/11/12
 */
public class Resource {

    /**
     * 根据配置文件路径，将配置文件加载成字节输入流，存储在内存中
     * @param path
     * @return
     */
    public static InputStream getResourceAsStream(String path){
        InputStream inputStream = Resource.class.getClassLoader().getResourceAsStream(path);
        return inputStream;
    }

}

pojo包下Configuration

package com.panshenlian.pojo;

import javax.sql.DataSource;
import java.util.HashMap;
import java.util.Map;

/**
 * @Author: panshenlian
 * @Description: 数据库配置类
 * @Date: Create in 13:58 2020/11/12
 */
public class Configuration {

    private DataSource dataSource;

    /**
     * key:statementId
     * value:封装好的mappedStatement对象
     */
    private Map mappedStatementMap = new HashMap();

    public DataSource getDataSource() {
        return dataSource;
    }

    public void setDataSource(DataSource dataSource) {
        this.dataSource = dataSource;
    }

    public Map getMappedStatementMap() {
        return mappedStatementMap;
    }

    public void setMappedStatementMap(Map mappedStatementMap) {
        this.mappedStatementMap = mappedStatementMap;
    }
}

pojo包下MappedStatement

package com.panshenlian.pojo;

/**
 * @Author: panshenlian
 * @Description: SQL与结果集资源类 （负责存储SQL映射定义、存储结果集映射定义）
 * @Date: Create in 14:17 2020/11/12
 */
public class MappedStatement {

    /**
     * id标识
     */
    private String id;

    /**
     * 返回值类型
     */
    private String resultType;

    /**
     * 参数值类型
     */
    private String parameterType;

    /**
     * sql语句
     */
    private String sql;

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getResultType() {
        return resultType;
    }

    public void setResultType(String resultType) {
        this.resultType = resultType;
    }

    public String getParameterType() {
        return parameterType;
    }

    public void setParameterType(String parameterType) {
        this.parameterType = parameterType;
    }

    public String getSql() {
        return sql;
    }

    public void setSql(String sql) {
        this.sql = sql;
    }
}

sqlSession包下DefaultSqlSession

package com.panshenlian.sqlSession;

import com.panshenlian.pojo.Configuration;
import com.panshenlian.pojo.MappedStatement;

import java.lang.reflect.*;
import java.util.List;

/**
 * @Author: panshenlian
 * @Description: sql会话实现类
 * @Date: Create in 14:43 2020/11/12
 */
public class DefaultSqlSession implements SqlSession{

    private Configuration configuration;

    public DefaultSqlSession(Configuration configuration) {
        this.configuration = configuration;
    }

    @Override
    public  List selectList(String statementId, Object... params) throws Exception {

        // 1、构建sql执行器
        SimpleExecutor simpleExecutor = new SimpleExecutor();

        // 2、获取最终执行sql对象
        MappedStatement mappedStatement = configuration.getMappedStatementMap().get(statementId);

        // 3、执行sql，返回结果集
        List queryResultList = simpleExecutor.query(configuration, mappedStatement, params);
        return (List)queryResultList;
    }

    @Override
    public  T selectOne(String statementId, Object... params) throws Exception {
        List objects = selectList(statementId, params);
        if (null != objects && objects.size() == 1){
            return (T)objects.get(0);
        } else {
           throw  new RuntimeException("查询结果为空或者返回结果多于1条");
        }
    }

    @Override
    public int update(String statementId, Object... params) {
        return 0;
    }

    @Override
    public int delete(String statementId, Object... params) {
        return 0;
    }

    @Override
    public  T getMapper(Class<?> mapperClass) {

        //使用JDK动态代理来为Dao接口生成代理对象，并返回调用结果
        Object proxyInstance =  Proxy.newProxyInstance(DefaultSqlSession.class.getClassLoader(), new Class[]{mapperClass}, new InvocationHandler(){
            @Override
            public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {

                // 底层都还是去执行JDBC
                // 根据不同情况，来调用selectList或selectOne
                // 1.准备参数statementId = sql 语句的唯一标识： namespace.id =接口全限定名.方法名
                String methodName = method.getName();
                String className = method.getDeclaringClass().getName();
                String statementId = className + "." + methodName;

                // 2.准备参数 params 即args
                // 获取被调用方法的返回值类型
                Type genericReturnType = method.getGenericReturnType();
                // 判断是否进行了 泛型类型参数化
                if ( genericReturnType instanceof ParameterizedType){
                    List objects = selectList(statementId, args);
                    return objects;
                }

                return selectOne(statementId,args);
            }
        });
        return (T)proxyInstance;

    }
}

sqlSession包下DefaultSqlSessionFactory

package com.panshenlian.sqlSession;

import com.panshenlian.pojo.Configuration;

/**
 * @Author: panshenlian
 * @Description: 默认SqlSession工厂实现类
 * @Date: Create in 14:41 2020/11/12
 */
public class DefaultSqlSessionFactory implements  SqlSessionFactory{

    private Configuration configuration;

    public DefaultSqlSessionFactory(Configuration configuration) {
        this.configuration = configuration;
    }

    @Override
    public SqlSession openSession() {
        return new DefaultSqlSession(configuration);
    }
}

sqlSession包下Executor

package com.panshenlian.sqlSession;

import com.panshenlian.pojo.Configuration;
import com.panshenlian.pojo.MappedStatement;

import java.beans.IntrospectionException;
import java.lang.reflect.InvocationTargetException;
import java.sql.SQLException;
import java.util.List;

/**
 * @Author: panshenlian
 * @Description: sql执行器接口
 * @Date: Create in 15:02 2020/11/12
 */
public interface Executor {

    public  List query(Configuration configuration,
                             MappedStatement mappedStatement,
                             Object... params) throws Exception;

}

sqlSession包下SimpleExecutor

package com.panshenlian.sqlSession;

import com.mysql.jdbc.StringUtils;
import com.panshenlian.config.BoundSql;
import com.panshenlian.pojo.Configuration;
import com.panshenlian.pojo.MappedStatement;
import com.panshenlian.utils.GenericTokenParser;
import com.panshenlian.utils.ParameterMapping;
import com.panshenlian.utils.ParameterMappingTokenHandler;

import java.beans.ExceptionListener;
import java.beans.IntrospectionException;
import java.beans.PropertyDescriptor;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.sql.*;
import java.util.ArrayList;
import java.util.List;

/**
 * @Author: panshenlian
 * @Description: sql执行器接口简单实现类
 * @Date: Create in 15:55 2020/11/12
 */
public class SimpleExecutor implements Executor {

    @Override
    public  List query(Configuration configuration,
                             MappedStatement mappedStatement,
                             Object... params) throws Exception {

        // 1、注册驱动 , 获取数据库连接
        Connection connection = configuration.getDataSource().getConnection();

        // 2、获取sql语句： select * from user where id = #{id}
        //    转换sql语句： select * from user where id = ?
        //    转换的过程，还需要对#{}里面的值进行解析存储
        String sql = mappedStatement.getSql();
        BoundSql bounSql = getBoundSql(sql);

        // 3、获取预处理对象: preparedStatement
        PreparedStatement preparedStatement =
                connection.prepareStatement(bounSql.getSqlText());

        // 4、设置参数，通过反射机制获取到参数
        String parameterType = mappedStatement.getParameterType();
        Class<?> parameterTypeClass = getClassType(parameterType);

        List parameterMappingList =
                bounSql.getParameterMappingList();
        for (int i = 0; i < parameterMappingList.size(); i++) {
            ParameterMapping parameterMapping = parameterMappingList.get(i);
            String filedName = parameterMapping.getContent();

            // 反射
            Field declaredField = parameterTypeClass.getDeclaredField(filedName);
            // 暴力访问
            declaredField.setAccessible(true);
            Object declaredFieldValue = declaredField.get(params[0]); // params[0] 是对象
            preparedStatement.setObject(i+1,declaredFieldValue);
        }

        // 5、执行SQL
        ResultSet resultSet = preparedStatement.executeQuery();
        String resultType = mappedStatement.getResultType();
        Class<?> resultTypeClass = getClassType(resultType);
        List objects = new ArrayList();

        // 6、封装返回结果集
        while (resultSet.next()){
            Object o = resultTypeClass.newInstance();
            // 元数据
            ResultSetMetaData metaData = resultSet.getMetaData();
            for (int i = 1; i <= metaData.getColumnCount(); i++) {
                // 字段名
                String columnName = metaData.getColumnName(i);
                // 字段值
                Object columnValue = resultSet.getObject(columnName);

                // 使用内省（反射），根据数据库表和实体的对应关系，完成封装
                PropertyDescriptor propertyDescriptor =
                        new PropertyDescriptor(columnName, resultTypeClass);
                Method writeMethod = propertyDescriptor.getWriteMethod();
                writeMethod.invoke(o,columnValue);
            }
            objects.add(o);
        }
        return (List)objects;
    }

    /**
     * 根据参数的全路径反射获取类
     * @param parameterType
     * @return
     */
    private Class<?> getClassType(String parameterType) throws ClassNotFoundException {
        if (StringUtils.isNullOrEmpty(parameterType)) {
            return null;
        }
        Class<?> clazz = Class.forName(parameterType);
        return clazz;
    }

    /**
     * 完成对#{}的解析工作：1、将#{}使用？进行代替，2、解析出#{}里面的值并存储
     * @param sql
     * @return
     */
    private BoundSql getBoundSql(String sql) {

        // 标记处理类，配置标记解析器来完成对占位符的解析处理工作
        ParameterMappingTokenHandler parameterMappingTokenHandler
                = new ParameterMappingTokenHandler();
        GenericTokenParser genericTokenParser =
                new GenericTokenParser("#{","}",
                        parameterMappingTokenHandler);

        // 解析出来的sql
        String parseSql = genericTokenParser.parse(sql);
        // 解析出来的参数名称
        List parameterMappings =
                parameterMappingTokenHandler.getParameterMappings();

        // 封装成为通配sql返回结果
        BoundSql boundSql = new BoundSql(parseSql, parameterMappings);
        return boundSql;
    }
}

sqlSession包下SqlSession

package com.panshenlian.sqlSession;

import java.util.List;

/**
 * @Author: panshenlian
 * @Description: Sql会话接口
 * @Date: Create in 14:40 2020/11/12
 */
public interface SqlSession {

    /**
     * 查询所有
     * @param statementId
     * @param params
     * @param 
     * @return
     */
    public  List selectList(String statementId , Object ... params) throws Exception;

    /**
     * 根据条件查询单个
     * @param statementId
     * @param params
     * @param 
     * @return
     */
    public  T selectOne(String statementId , Object ... params) throws Exception;

    /**
     * 根据条件更新
     * @param statementId
     * @param params
     * @return
     */
    public int update(String statementId , Object ... params);

    /**
     * 根据条件删除
     * @param statementId
     * @param params
     * @return
     */
    public int delete(String statementId , Object ... params);

    /**
     * 为Dao接口生成代理实现类
     * @param mapperClass
     * @param 
     * @return
     */
    public  T getMapper(Class<?> mapperClass);

}

sqlSession包下SqlSessionFactory

package com.panshenlian.sqlSession;

/**
 * @Author: panshenlian
 * @Description: SqlSession工厂接口
 * @Date: Create in 13:51 2020/11/12
 */
public interface SqlSessionFactory {

    public SqlSession openSession();
}

sqlSession包下SqlSessionFactoryBuilder

package com.panshenlian.sqlSession;

import com.panshenlian.config.XMLConfigBuilder;
import com.panshenlian.pojo.Configuration;

import java.io.InputStream;

/**
 * @Author: panshenlian
 * @Description: SqlSession会话工厂构建类
 * @Date: Create in 13:48 2020/11/12
 */
public class SqlSessionFactoryBuilder {

    public SqlSessionFactory build(InputStream inputStream) throws Exception {

        // 第一步：用dom4j解析配置文件，将解析出来的内容封装到Configuration中
        XMLConfigBuilder xmlConfigBuilder = new XMLConfigBuilder();
        Configuration configuration = xmlConfigBuilder.parseConfig(inputStream);

        // 第二步：创建SqlSessionFactory对象，生产sqlSession会话对象（工厂模式）
        DefaultSqlSessionFactory defaultSqlSessionFactory =
                new DefaultSqlSessionFactory(configuration);

        return defaultSqlSessionFactory;
    }
}

utils包下GenericTokenParser

/**
 *    Copyright 2009-2017 the original author or authors.
 *
 *    Licensed under the Apache License, Version 2.0 (the "License");
 *    you may not use this file except in compliance with the License.
 *    You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 *    Unless required by applicable law or agreed to in writing, software
 *    distributed under the License is distributed on an "AS IS" BASIS,
 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *    See the License for the specific language governing permissions and
 *    limitations under the License.
 */
package com.panshenlian.utils;

/**
 * 通用标记解析器，标记#{与}开始结束处理
 * @author Clinton Begin
 */
public class GenericTokenParser {

  private final String openToken; //开始标记
  private final String closeToken; //结束标记
  private final TokenHandler handler; //标记处理器

  public GenericTokenParser(String openToken, String closeToken, TokenHandler handler) {
    this.openToken = openToken;
    this.closeToken = closeToken;
    this.handler = handler;
  }

  /**
   * 解析${}和#{}
   * @param text
   * @return
   * 该方法主要实现了配置文件、脚本等片段中占位符的解析、处理工作，并返回最终需要的数据。
   * 其中，解析工作由该方法完成，处理工作是由处理器handler的handleToken()方法来实现
   */
  public String parse(String text) {
    // 验证参数问题，如果是null，就返回空字符串。
    if (text == null || text.isEmpty()) {
      return "";
    }

    // 下面继续验证是否包含开始标签，如果不包含，默认不是占位符，直接原样返回即可，否则继续执行。
    int start = text.indexOf(openToken, 0);
    if (start == -1) {
      return text;
    }

   // 把text转成字符数组src，并且定义默认偏移量offset=0、存储最终需要返回字符串的变量builder，
    // text变量中占位符对应的变量名expression。判断start是否大于-1(即text中是否存在openToken)，如果存在就执行下面代码
    char[] src = text.toCharArray();
    int offset = 0;
    final StringBuilder builder = new StringBuilder();
    StringBuilder expression = null;
    while (start > -1) {
     // 判断如果开始标记前如果有转义字符，就不作为openToken进行处理，否则继续处理
      if (start > 0 && src[start - 1] == '\\') {
        builder.append(src, offset, start - offset - 1).append(openToken);
        offset = start + openToken.length();
      } else {
        //重置expression变量，避免空指针或者老数据干扰。
        if (expression == null) {
          expression = new StringBuilder();
        } else {
          expression.setLength(0);
        }
        builder.append(src, offset, start - offset);
        offset = start + openToken.length();
        int end = text.indexOf(closeToken, offset);
        while (end > -1) {////存在结束标记时
          if (end > offset && src[end - 1] == '\\') {//如果结束标记前面有转义字符时
            // this close token is escaped. remove the backslash and continue.
            expression.append(src, offset, end - offset - 1).append(closeToken);
            offset = end + closeToken.length();
            end = text.indexOf(closeToken, offset);
          } else {//不存在转义字符，即需要作为参数进行处理
            expression.append(src, offset, end - offset);
            offset = end + closeToken.length();
            break;
          }
        }
        if (end == -1) {
          // close token was not found.
          builder.append(src, start, src.length - start);
          offset = src.length;
        } else {
          //首先根据参数的key（即expression）进行参数处理，返回?作为占位符
          builder.append(handler.handleToken(expression.toString()));
          offset = end + closeToken.length();
        }
      }
      start = text.indexOf(openToken, offset);
    }
    if (offset < src.length) {
      builder.append(src, offset, src.length - offset);
    }
    return builder.toString();
  }
}

utils包下ParameterMapping

package com.panshenlian.utils;

/**
 * @Author: panshenlian
 * @Description: 参数映射类（SQL参数映射类，存储#{}、${}中的参数名）
 * @Date: Create in 16:14 2020/11/12
 */
public class ParameterMapping {

    private String content;

    public ParameterMapping(String content) {
        this.content = content;
    }

    public String getContent() {
        return content;
    }

    public void setContent(String content) {
        this.content = content;
    }
}

utils包下ParameterMappingTokenHandler

package com.panshenlian.utils;

import java.util.ArrayList;
import java.util.List;

/**
 * 标记处理器实现类，解析#{}、${}成为?
 */
public class ParameterMappingTokenHandler implements TokenHandler {
	private List parameterMappings = new ArrayList();

	// context是参数名称 #{id} #{username}

	public String handleToken(String content) {
		parameterMappings.add(buildParameterMapping(content));
		return "?";
	}

	private ParameterMapping buildParameterMapping(String content) {
		ParameterMapping parameterMapping = new ParameterMapping(content);
		return parameterMapping;
	}

	public List getParameterMappings() {
		return parameterMappings;
	}

	public void setParameterMappings(List parameterMappings) {
		this.parameterMappings = parameterMappings;
	}

}

utils包下TokenHandler

/**
 *    Copyright 2009-2015 the original author or authors.
 *
 *    Licensed under the Apache License, Version 2.0 (the "License");
 *    you may not use this file except in compliance with the License.
 *    You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 *    Unless required by applicable law or agreed to in writing, software
 *    distributed under the License is distributed on an "AS IS" BASIS,
 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *    See the License for the specific language governing permissions and
 *    limitations under the License.
 */
package com.panshenlian.utils;

/**
 * 标记处理器接口
 * @author Clinton Begin
 */
public interface TokenHandler {
  String handleToken(String content);
}

框架书写好了，我们写一个测试工程验证一下框架，我们在现有框架下新加一个测试项目（以module模块的方式创建）保证测试工程和框架项目在一个工作组下面：

由于我已经写好了测试工程，我直接引入即可，效果都一样，创建和引入都以module方式就可以：

测试工程基本流程也说明一下：

1、引入依赖pom.xml

<?xml version="1.0" encoding="UTF-8"?>
4.0.0com.panshenlianMyPersistenceTest1.0-SNAPSHOTUTF-8UTF-81.81.81.8com.panshenlianMyPersistence1.0-SNAPSHOT

2、配置数据源sqlMapConfig.xml

3、我们以用户表为例子，建立用户sql配置userMapper.xml

        select * from user
    
        select * from user
        where id= #{id} and username = #{username}
        and password= #{password} and birthday = #{birthday}
    

4、用户dao接口

package com.panshenlian.dao;

import com.panshenlian.pojo.User;

import java.util.List;

/**
 * @Author: panshenlian
 * @Description:
 * @Date: Create in 21:35 2020/11/12
 */
public interface IUserDao {

    /**
     * 查询所有用户
     * @return
     * @throws Exception
     */
    public List findAll() throws Exception;

    /**
     * 根据条件进行用户查询
     * @return
     * @throws Exception
     */
    public User findByCondition(User user) throws Exception;

}

5、用户dao的实体类

package com.panshenlian.pojo;

/**
 * @Author: panshenlian
 * @Description: 用户实体
 * @Date: Create in 9:20 2020/11/12
 */
public class User {

    private Integer id;
    private String username;
    private String password;
    private String birthday;

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public String getBirthday() {
        return birthday;
    }

    public void setBirthday(String birthday) {
        this.birthday = birthday;
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                ", birthday='" + birthday + '\'' +
                '}';
    }
}

注意：用户sql配置文件userMapper.xml中的namespace需要和用户dao的全限定名一致，这是我们框架默认规则：namespace=“com.panshenlian.dao.IUserDao” 同时select标签的id和用户dao接口的方法名保持一致，也是框架默认的规则，例如id=“findAll”

6、最终我们创建测试类：MyPersistenceTest

package com.panshenlian.test;

import com.panshenlian.dao.IUserDao;
import com.panshenlian.io.Resource;
import com.panshenlian.pojo.User;
import com.panshenlian.sqlSession.SqlSession;
import com.panshenlian.sqlSession.SqlSessionFactory;
import com.panshenlian.sqlSession.SqlSessionFactoryBuilder;
import org.junit.Test;

import java.io.InputStream;
import java.util.List;

/**
 * @Author: panshenlian
 * @Description: 持久层框架测试类
 * @Date: Create in 9:24 2020/11/12
 */
public class MyPersistenceTest {

    @Test
    public void test() throws Exception {
        InputStream resourceAsStream =
                Resource.getResourceAsStream("sqlMapConfig.xml");
        SqlSessionFactory sqlSessionFactory =
                new SqlSessionFactoryBuilder().build(resourceAsStream);
        SqlSession sqlSession = sqlSessionFactory.openSession();

        // 一、传统DAO方式调用
        User user = new User();
        user.setId(3);
        user.setUsername("panshenlian");
        user.setBirthday("2020-11-12");
        user.setPassword("123456");
        User dbUser = sqlSession.selectOne("com.panshenlian.dao.IUserDao.findByCondition",user);
        System.out.println(dbUser);
        List userList = sqlSession.selectList("com.panshenlian.dao.IUserDao.findAll", user);
        for (User db : userList) {
            System.out.println(db);
        }

        // 二、代理模式调用
        IUserDao userDao = sqlSession.getMapper(IUserDao.class);
        List users = userDao.findAll();
        for (User db : users) {
            System.out.println("代理调用=" + db);
        }

    }
}

7、运行测试类，结果符合预期

框架和测试验证我们基本完成，其实以上主要是对于持久层框架的一个简单框架介绍，方面我们以后学习分析Mybatis框架，基本我们做到了一个模拟雏形，流程大致是这样。

编码实现过程中涉及到几个有意思的知识点，我们后续找时间聊聊，包括：

• 内省机制
• 反射机制
• JDK动态代理
• 设计模式
• 泛型

总结

如今大型项目一般都不会直接使用JDBC，要么采用市面上成熟的持久层方案，要么自研持久层框架，说到底，还是单纯的JDBC无法保证高效高稳定性能的数据层访问与应用，而越来越多持久层框架方案，不仅消除了大量的JDBC冗余代码，还提供极低的学习曲线，既能保证协同传统的数据库还接受SQL语句，也为其他框架提供了拓展集成支持，包括连接池、缓存、性能等都做了极大的优化与提升，所以框架大行其道是必然趋势。

JDBC在90年代诞生之初也是高光而伟大，只不过随着技术水平的跃迁和业务场景的迭代更新，旧技术满足不了现有的诉求，所有事物都会轮换更新，我们仅仅是站在伟人的肩膀上，顺势变迁。

好，本篇完，晚安。

下一篇，我们或许会聊聊 Mybatis基础和架构 。

/ End.

BIU ~ 文章持续更新，本文会在 GitHub github.com/JavaWorld 收录，热腾腾的技术、框架、面经、解决方案，我们都会以最美的姿势第一时间送达，欢迎 Star。