栏目分类:
子分类:
返回
名师互学网用户登录
快速导航关闭
当前搜索
当前分类
子分类
实用工具
热门搜索
名师互学网 > IT > 软件开发 > 后端开发 > Java

Mybatis系列全解(一):手写一套持久层框架

Java 更新时间: 发布时间: IT归档 最新发布 模块sitemap 名妆网 法律咨询 聚返吧 英语巴士网 伯小乐 网商动力

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的类进行扫描并进行初始化。

  1. 创建数据库连接:

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

  1. 创建编译对象:

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

  1. 设置入参执行SQL:

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

  1. 封装返回结果集:

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

  1. 释放数据库连接资源:

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

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

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

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

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

mysqlmysql-connector-java5.1.25

  1. 创建java测试类
    
package com.panshenlian.jdbc;

import com.panshenlian.po.User;

import java.sql.*;


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();
}
    }
 }
    }
}

  1. 创建User类

package com.panshenlian.po;


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 + ''' +
  '}';
    }
}



  1. 创建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');

  1. 执行结果,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各个环节中存在的不足,现在,我们整理出对应的优化思路,统一汇总:

存在问题 优化思路
数据库配置信息存在硬编码问题 使用配置文件
频繁创建、释放数据库连接问题 使用数据连接池
SQL语句、设置参数、获取结果集参数均存在硬编码问题 使用配置文件
手动封装返回结果集,较为繁琐 使用Java反射、自省

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

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

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

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


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

来,我们一起看看使用JDBC和使用持久层框架有什么区别? 使用框架对于我们使用者(主要是研发人员),是有多舒爽呢?

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

  • 配置数据源(地址/数据名/用户名/密码)
  • 编写SQL与参数准备(SQL语句/参数类型/返回值类型)
框架,除了思考本身的工程设计,还需要考虑到实际项目端的使用场景,干系方涉及两端:
  • 使用端(实际项目)

  • 持久层框架本身

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

核心接口/类重点说明:
分工协作 角色定位 类名定义
负责读取配置文件 资源辅助类 Resources
负责存储数据库连接信息 数据库资源类 Configuration
负责存储SQL映射定义、存储结果集映射定义 SQL与结果集资源类 MappedStatement
负责解析配置文件,创建会话工厂SqlSessionFactory 会话工厂构建者 SqlSessionFactoryBuilder
负责创建会话SqlSession 会话工厂 SqlSessionFactory
指派执行器Executor 会话 SqlSession
负责执行SQL (配合指定资源Mapped Statement) 执行器 Executor

正常来说项目只对应一套数据库环境,一般对应一个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)

  1. 创建两个javaBean(容器对象):存放配置文件解析出来的内容
 
 Configuration(核心配置类):存放sqlMapConfig.xml解析出来的内容。
 MappedStatement(映射配置类):存放mapper.xml解析出来的内容。
 
  1. 解析配置文件(使用dom4j) ,并创建SqlSession会话对象
 
 创建类:SqlSessionFactoryBuilder 方法:build(InputStream in)
 > 使用dom4j解析配置文件,将解析出来的内容封装到容器对象中
 > 创建SqlSessionFactory对象,生产sqlSession会话对象(工厂模式)
 
  1. 创建SqlSessionFactory接口以及实现类DefaultSqlSessionFactory

  创建openSession()接口方法,生产sqlSession
 
  1. 创建SqlSession接口以及实现类DefaultSqlSession

  定义对数据库的CRUD操作:
  > selectList();
  > selectOne();
  > update();
  > delete();
 
  1. 创建Executor接口以及实现类SimpleExecutor

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

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

简约版

详细版

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

包接口类说明
  • config包
接口/类 作用
BoundSql 保存Sql语句的对象,替换sql#{}成为?号并且存储#{}对应的参数名
XMLConfigBuilder SqlMapConfig.xml配置文件解析工具类
XMLMapperBuilder Mapper.xml配置文件解析工具类
  • io包
接口/类 作用
Resource 读取SqlMapConfig.xml和Mapper.xml的工具类,转换为输入流inputStream
  • pojo包
接口/类 作用
Configuration 封装SqlMapConfig.xml配置参数
MappedStatement 封装Mapper.xml配置的sql参数
  • sqlSession包
接口/类 作用
SqlSessionFactoryBuilder SqlSessionFactory构建者类
SqlSessionFactory 生产SqlSession的工厂接口
DefaultSqlSessionFactory SqlSessionFactory的默认实现类
SqlSession SqlSession接口定义数据库基本的CRUD方法
DefaultSqlSession SqlSession的实现类
Executor Executor接口sql的真正执行者,使用JDBC操作数据库
SimpleExecutor Executor的实现类
  • utils
接口/类 作用
ParameterMapping 来源于Mybatis框架,SQL参数映射类,存储#{}、${}中的参数名
TokenHandler 来源于Mybatis框架,标记处理器接口
ParameterMappingTokenHandler 来源于Mybatis框架,标记处理器实现类,解析#{}、${}成为?
GenericTokenParser 来源于Mybatis框架,通用标记解析器,标记#{与}开始结束处理
五、自定义持久层框架:编码

结合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;


public class BoundSql {

    
    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;


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;


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;


public class Resource {

    
    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;


public class Configuration {

    private DataSource dataSource;

    
    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;


public class MappedStatement {

    
    private String id;

    
    private String resultType;

    
    private String parameterType;

    
    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;


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;


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;


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;


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;
    }

    
    private Class<?> getClassType(String parameterType) throws ClassNotFoundException {
 if (StringUtils.isNullOrEmpty(parameterType)) {
     return null;
 }
 Class<?> clazz = Class.forName(parameterType);
 return clazz;
    }

    
    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;


public interface SqlSession {

    
    public  List selectList(String statementId , Object ... params) throws Exception;

    
    public  T selectOne(String statementId , Object ... params) throws Exception;

    
    public int update(String statementId , Object ... params);

    
    public int delete(String statementId , Object ... params);

    
    public  T getMapper(Class<?> mapperClass);

}

sqlSession包下SqlSessionFactory

package com.panshenlian.sqlSession;


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;


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


package com.panshenlian.utils;


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;
  }

  
  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;


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


package com.panshenlian.utils;


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;


public interface IUserDao {

    
    public List findAll() throws Exception;

    
    public User findByCondition(User user) throws Exception;

}

5、用户dao的实体类

package com.panshenlian.pojo;


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;


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。

转载请注明:文章转载自 www.mshxw.com
我们一直用心在做
关于我们 文章归档 网站地图 联系我们

版权所有 (c)2021-2022 MSHXW.COM

ICP备案号:晋ICP备2021003244-6号