Mybatis系列原理剖析之:项目实战:自定义持久层框架
持久层是JAVA EE三层体系架构中,与数据库进行交互的一层,持久层往往被称为dao层。需要说明的是,持久层的技术选型有很多,绝不仅仅只有mybatis一种。像早期可能会直接使用jdbc来与数据库进行交互,那么这里就需要思考一个问题,既然已经有jdbc实现与数据库的交互,为什么还需要使用mybatis这类持久层框架呢?
虽然jdbc提供了与数据库交互的基本功能,但它需要手动编写大量的SQL语句和处理代码,使代码显得冗长和难以维护。而MyBatis可以通过配置文件和注解来映射Java对象和SQL语句,使得开发者可以更加专注于业务逻辑的实现,而不必过多关注SQL语句的编写和维护。此外,MyBatis还提供了缓存功能、动态SQL语句、多数据源支持等特性,使得开发者可以更加灵活地处理数据访问地需求。因此,使用Mybatis等持久层框架可以提高开发效率和代码可维护性
在自定义持久层框架开始之前,我们首先回顾一下jdbc实现与数据库交互时的配置代码,并以此分析存在的问题。然后设计方案,解决这些问题,进而自定义持久层框架。
JDBC配置回顾
public static void main(String[] args)
{
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 ", "
root ");
// 定义sql语句?表示占位符
String sql = "select * from user where username = ?";
// 获取预处理statement
preparedStatement = connection.prepareStatement(sql);
// 设置参数,第一个参数为sql语句中参数的序号(从1开始),第二个参数为设置的参数值
preparedStatement.setString(1, "tom");
// 向数据库发出sql执行查询,查询出结果集
resultSet = preparedStatement.executeQuery();
// 遍历查询结果集
while(resultSet.next())
{
int id = resultSet.getInt("id");
String username = resultSet.getString("username");
// 封装User
user.setId(id);
user.setUsername(username);
}
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();
}
}
}
}
上面是一段非常常见的采用jdbc的方式连接mysql数据库的配置。简单分析下上述代码中存在的一些问题:
JDBC问题分析:
-
硬编码问题
直观能够看到的首先就是一个硬编码问题,在上述加载数据库驱动和链接时,我们都显式的将配置写在了代码中。如果后续配置发生了变化,比如将驱动由
com.mysql.jdbc.Driver
升级为com.mysql.cj.jdbc.Driver
,或者驱动由Mysql变为Oracle。此时,都需要对原始代码进行变更,然后重新编译源文件,再次重新打包部署 -
数据库连接频繁创建/释放
上述查询数据库的代码可能会被调用多次,而上面的代码每次被调用,都会尝试创建一个新的数据连接,并在使用完成后释放。而我们知道,数据库链接是一个非常宝贵的资源(在获取数据库连接时,底层需要首先建立TCP连接,完成三次握手,这一过程是比较消耗资源,影响性能的)。
-
SQL语句与查询/操作耦合
可以看到sql语句与数据库查询、结果集操作耦合在一起,同时也存在硬编码问题。而且这样也导致sql语句散落在各个业务代码操作中,非常不便于后续的管理和代码优化。
-
手动封装返回结果集,较为繁琐
上面代码对结果集进行遍历,并将数据库中的每个列赋值给实体类的相应属性。此时,如果实力类的个数较多,会存在手动封装较为繁琐的问题,这些都是可以优化的点。
针对上述的几个问题,我们来设计一下相应的解决方案:
- 针对硬编码问题,相应的解决方案比较普遍的就是采用配置文件的方式。将数据库连接等配置信息,写在配置文件中,然后在代码里读取配置文件。
- 针对数据库连接频繁创建/释放问题,可以采用连接池的方式来进行解决。目前市面上常见的连接池有很多,诸如:C3P0、DBCP、Druid等。
- 针对SQL语句与查询/操作耦合在一起的问题,同样也可以采用配置文件的方式来解决,尝试将sql语句单独存放在某个配置文件中,从而实现对SQL的统一集中管理和硬编码问题。
- 针对手动封装返回结果集的问题,可以采用反射的方式进行解决。直接将查询结果与相应的实体类利用反射进行映射,从而节省了手动封装过程的繁琐。
自定义持久层框架设计思路
在设计之前,需要明确的是,我们当前自定义的持久层框架本质仍然是对JDBC代码的封装,只不过在封装的过程中,要把JDBC中存在的问题进行规避和解决。
整体的设计思路包括两部分:
-
使用端
-
使用端指上层的一些项目,会来使用我们设计的持久层框架。使用时,需要引入框架的jar包。
-
由于不同项目的数据库连接信息、sql语句等都是不相同的,因此使用端需要提供包括数据库配置,sql配置,sql语句,参数类型,返回值类型等信息,并将它们写在配置文件中:
(1)sqlMapConfig.xml:存放数据库配置信息。
(2)Mapper.xml:存放sql配置信息。
-
-
自定义持久层框架本身
本身也是一个工程,本质是对JDBC代码进行了封装,因此需要读取项目提供的上述两个配置文件,并解析出配置信息,来构建JDBC连接。
-
加载配置文件。
- 功能:根据配置文件的路径,加载配置文件成字节输入流,并以流的方式加载到内存中。
- 实现:创建Resources类,定义方法:getResourceAsStream(String path)
-
创建两个JavaBean:容器对象,存放的就是对配置文件解析出来的内容
- Configuration:核心配置类:存放sqlMapConfig.xml解析出来的内容
- MappedStatement:映射配置类: 存放mapper.xml解析出来的内容
-
解析配置文件:dom4j
-
创建类:SqlSessionFactoryBuilder 方法:build(InputStream in)
-
使用dom4j解析配置文件,将解析出来的内容封装到容器对象中
-
创建SqlSessionFactory对象:生成SqlSession(会话对象,包含了增删改查等一系列操作)(工厂模式)
- 创建SqlSessionFactory接口及实现类DefaultSqlSessionFactory
- openSession:生成sqlSession对象
- 创建SqlSessionFactory接口及实现类DefaultSqlSessionFactory
- 创建SqlSession接口及实现类DefaultSession
- 定义对数据库的crud操作:selectList()、selectOne()、update()、delete()
- 创建Executor接口及实现类SimpleExecutor实现类,用来封装CRUD操作。
- query(Configuration, MapedStatement, Object… params):执行的就是JDBC代码。可变长参数params即sql执行时所需要的占位符参数,因为无法确认参数个数,所以采用可变参的形式。
-
-
-
总结一下上面的设计思路,由于我们自定义的持久层框架本质上是对JDBC代码进行了封装,所以它底层执行的还是JDBC代码。JDBC代码想要执行两部分信息必不可少:数据库配置信息、sql配置信息,而这两部分信息此时已经由使用端采用配置文件的方式进行提供。因此,持久层框架需要完成的功能实际上就是采用dom4j技术对上述的配置文件进行解析,并把解析出来的内容封装到两个JavaBean(Configuration、MappedStatement)中。这两个参数经过层层传递,传递到SimpleExecutor的query方法中,最终在query方法中执行JDBC代码操作。
自定义持久层框架代码实现
使用端代码实现
根据上面的分析,使用端需要提供数据库连接配置、sql查询语句等信息,并使用配置文件的方式。因此接下来我们就在使用端创建的Maven项目的resources目录下,创建两个配置文件:sqlMapConfig.xml
和UserMapper.xml
,前者保存mysql数据库的配置信息,后者保存sql查询语句的相关信息。
sqlMapConfig.xml
<!-- 配置mysql的连接信息-->
<configuration>
<datasource>
<properties name="driverClass" value="com.mysql.jdbc.Driver"></properties>
<properties name="jdbcUrl" value="jdbc:mysql://127.0.0.1:3306/CustomPersistent"></properties>
<properties name="username" value="root"></properties>
<properties name="password" value="root"></properties>
</datasource>
<!-- 存放mapper.xml的全路径-->
<mapper resource="UserMapper.xml"></mapper>
</configuration>
上述配置文件利用<datasource>
标签标识数据库连接信息,并将配置使用<properties>
来指定。最后,利用<mapper>
标签指明mapper.xml文件所在的位置,方便后续文件的读取。
UserMapper.xml
<mapper name="user">
<!-- sql的唯一标识由namespace.id来组成: statementId-->
<!-- resultType需要保存全限定类名,后续持久层框架才能借助反射来自动封装结果集-->
<select id="selectList" resultType="com.lagou.pojo.User">
select * from user
</select>
<!-- 使用#{}替换? 作为新的框架进行识别的占位符,与parameterType对象的属性相对应-->
<select id="selectOne" resultType="com.lagou.pojo.User" parameterType="com.lagou.pojo.User">
select * from user where id = #{id} and username = #{username}
</select>
</mapper>
不同业务/数据表 相应的sql语句应该用不同的Mapper来保存,这里假设查询用户表相关数据,则定义UserMapper.xml
的配置文件。对于CRUD的不同查询方式,使用标签<select>
、<insert>
等来区分。为了能够唯一标识一条sql语句,采用namespace.id的方式,将每个namespace.id的值封装成一条statementId。同时,设置了一些属性值来提供sql语句查询时的额外信息,比如用resultType
来标识结果集对对应的实体类,用paramType
标识sql查询时需要的参数对应的实体类。
上述我们简单的在使用端定义好了我们最初设计思路中的两个配置文件,由于我们底层的持久层框架还没定义好,所以无法演示使用的代码,因此接下来,我们先介绍自定义持久层框架的相关代码。
自定义持久层框架代码实现
同样的,按照上面的设计思路,来一步步的实现。
创建Resources类
public class Resources {
// 根据配置文件的路径,将配置文件加载成字节输入流,存储在内存中
public static InputStream getResourceAsStream(String path){
InputStream inputStream = Resources.class.getClassLoader().getResourceAsStream(path);
return inputStream;
}
}
有了上面这个类之后,我们就可以在之前的使用端代码里,编写测试代码,尝试来读取两个配置文件。
public class CustomPersistenceTest {
public static void main(String[] args) throws IOException {
InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
byte[] bytes = new byte[1024];
int length;
StringBuilder builder = new StringBuilder();
while((length = resourceAsStream.read(bytes)) != -1){
String str = new String(bytes, 0, length);
builder.append(str);
}
System.out.println(resourceAsStream);
System.out.println(builder.toString());
}
}
打印结果:
java.io.BufferedInputStream@6d6f6e28
<!-- 配置mysql的连接信息-->
<configuration>
<datasource>
<properties name="driverClass" value="com.mysql.jdbc.Driver"></properties>
<properties name="jdbcUrl" value="jdbc:mysql://127.0.0.1:3306/CustomPersistent"></properties>
<properties name="username" value="root"></properties>
<properties name="password" value="root"></properties>
</datasource>
<!-- 存放mapper.xml的全路径-->
<mapper resource="UserMapper.xml"></mapper>
</configuration>
可以看到,定义的getResourceAsStream方法成功以流的方式读取到了定义的sqlConfigMapper.xml
的配置信息,接下来,就是利用dom4j来对其进行解析了。在此之前,先定义两个JavaBean容器对象,来存储解析好的配置类。
容器对象定义
MappedStatement核心配置类:存放mapper.xml解析出来的内容
public class MappedStatement {
//id标识
private String id;
//返回值类型
private String resultType;
//参数值类型
private String paramterType;
//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 getParamterType() {
return paramterType;
}
public void setParamterType(String paramterType) {
this.paramterType = paramterType;
}
public String getSql() {
return sql;
}
public void setSql(String sql) {
this.sql = sql;
}
}
MappedStatement类封装了上面介绍的在使用端的配置文件中包含的一些配置参数,比如id,resultType,pa rameterType。
Configuration核心配置类:存放sqlMapConfig.xml解析出来的内容
public class Configuration {
// 数据库配置信息
private DataSource dataSource;
/**
* sql配置信息
*
* key: StatementId
* value: 封装好的MappedStatement对象
*/
Map<String, MappedStatement> mappedStatementMap = new HashMap<>();
public DataSource getDataSource() {
return dataSource;
}
public void setDataSource(DataSource dataSource) {
this.dataSource = dataSource;
}
public Map<String, MappedStatement> getMappedStatementMap() {
return mappedStatementMap;
}
public void setMappedStatementMap(Map<String, MappedStatement> mappedStatementMap) {
this.mappedStatementMap = mappedStatementMap;
}
}
dataSource
对象封装了在使用端sqlMapConfig.xml
中的Datasource属性,同时有一个Map<String, MappedStatement>
的对象,用于封装上面的MappedStatement
对象,这样的好处在于:将每个MappedStatement
对象用唯一id映射保存在内存中,便于后续框架根据使用端传入的id来快速获取相应sql配置来执行。
使用dom4j解析配置文件
下面给出使用dom4j来解析配置文件的核心流程代码:
public class XMLConfigBuilder {
private Configuration configuration;
public XMLConfigBuilder() {
this.configuration = new Configuration();
}
/**
* 该方法就是使用dom4j对配置文件进行解析,封装Configuration
*/
public Configuration parseConfig(InputStream inputStream) throws DocumentException, PropertyVetoException {
Document document = new SAXReader().read(inputStream);
//<configuration>
Element rootElement = document.getRootElement();
List<Element> list = rootElement.selectNodes("//property");
Properties properties = new Properties();
for (Element element : list) {
String name = element.attributeValue("name");
String value = element.attributeValue("value");
properties.setProperty(name,value);
}
// 使用c3p0连接池作为数据库连接对象,减少数据库的频繁连接/释放
ComboPooledDataSource comboPooledDataSource = new ComboPooledDataSource();
comboPooledDataSource.setDriverClass(properties.getProperty("driverClass"));
comboPooledDataSource.setJdbcUrl(properties.getProperty("jdbcUrl"));
comboPooledDataSource.setUser(properties.getProperty("username"));
comboPooledDataSource.setPassword(properties.getProperty("password"));
configuration.setDataSource(comboPooledDataSource);
//mapper.xml解析: 拿到路径--字节输入流---dom4j进行解析
List<Element> mapperList = rootElement.selectNodes("//mapper");
for (Element element : mapperList) {
String mapperPath = element.attributeValue("resource");
InputStream resourceAsSteam = Resources.getResourceAsSteam(mapperPath);
XMLMapperBuilder xmlMapperBuilder = new XMLMapperBuilder(configuration);
xmlMapperBuilder.parse(resourceAsSteam);
}
return configuration;
}
}
上述代码使用dom4j来对一个xml文件进行解析。
首先利用new SAXReader().read(inputStream)
方法,将字节输入流解析成一个Document对象,然后就可以根据标签来对xml文件进行遍历和检索。首先调用document.getRootElement();
获取到根标签,然后,找到property
标签进行遍历,从中获取到配置文件中对于数据库连接的配置,并以此来生成一个C3P0的连接池对象赋值给datasource
。
在解析完数据库连接配置后,接着根据配置的maaper
路径,再次调用Resources.getResourceAsSteam
方法获取到mapper.xml
的sql配置信息,使用XMLMapperBuilder
对象的parse
方法封装到configuration
对象中。
XMLMapperBuilder类代码如下所示:
public class XMLMapperBuilder {
private Configuration configuration;
public XMLMapperBuilder(Configuration configuration) {
this.configuration =configuration;
}
public void parse(InputStream inputStream) throws DocumentException {
// 将xml文件解析成Documen对象
Document document = new SAXReader().read(inputStream);
Element rootElement = document.getRootElement();
// 获取根标签的namespace属性
String namespace = rootElement.attributeValue("namespace");
// 遍历所有的<select>标签
List<Element> list = rootElement.selectNodes("//select");
for (Element element : list) {
// 获取select标签中的各个属性
String id = element.attributeValue("id");
String resultType = element.attributeValue("resultType");
String paramterType = element.attributeValue("paramterType");
String sqlText = element.getTextTrim();
MappedStatement mappedStatement = new MappedStatement();
mappedStatement.setId(id);
mappedStatement.setResultType(resultType);
mappedStatement.setParamterType(paramterType);
mappedStatement.setSql(sqlText);
String key = namespace+"."+id;
configuration.getMappedStatementMap().put(key,mappedStatement);
}
}
}
至此,我们完成了对使用端传入的配置文件的解析,并封装到了Configuration
对象中。有了该对象后,后面我们着手考虑的就是根据获取到的Datasource
连接池,创建数据库连接,然后执行使用端传入的指定SQL语句。
生成接口代理类对象
我们思考另一个问题:使用端该如何与框架交互,来传入指定要执行的SQL语句和参数
上面介绍过,mapper.xml
配置文件中,<namespace>
标签以及每个<select>
标签的参数类型、返回值类型**采用全限定类名的原因在于框架可以借助反射来匹配dao层的接口类与定义的mapper.xml
sql配置文件,以及与相应实体类属性进行绑定。**同时,Configuration核心配置类中封装的Map<String, MappedStatement>
属性,其键值就是由<mapper>
标签的namespace
属性与<select>
标签的id
属性拼接而成的。
由于dao层是接口类,没有具体的实现逻辑。因为,为了在方法执行时实现具体的处理逻辑,我们就可以借助于代理类来实现。利用反射根据使用端传入的dao层接口类,拼接上该类相应的调用方法,以此值为键(statementId)
来从Configuration
配置类的mappedStatementMap
属性中获取相应的sql语句。
@Override
public <T> 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代码 //根据不同情况,来调用selctList或者selectOne
// 准备参数 1:statmentid :sql语句的唯一标识:namespace.id= 接口全限定名.方法名
// 方法名:findAll
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<Object> objects = selectList(statementId, args);
return objects;
}
return selectOne(statementId,args);
}
});
return (T) proxyInstance;
}
上面代码使用JDK动态代理来为Dao层接口生成代理对象,这样后续在使用端调用dao层接口时,就会进入到代理类的InvocationHandler
参数的invoke
方法中执行,实现dao层接口与mapper.xml
中的sql绑定。
接下来,我们将该方法封装到sqlSession
方法中,借助sqlSession
接口类来实现获取dao层接口的代理类实例。
创建sqlSession封装CRUD操作
在上面封装好了配置文件信息后,接下来我们需要思考的就是该如何运行配置文件中的Sql了。这里我们再做一层封装,将可能执行的CRUD操作封装在sqlSession
中。这里基于开发的依赖倒置原则,我们还是先将CRUD操作封装在sqlSession
接口中,再创建一个DefaultSqlSession
的实现类来编写具体的处理逻辑
public interface SqlSession {
//查询所有
public <E> List<E> selectList(String statementid,Object... params) throws Exception;
//根据条件查询单个
public <T> T selectOne(String statementid,Object... params) throws Exception;
//为Dao接口生成代理实现类
public <T> T getMapper(Class<?> mapperClass);
}
这里新添加了一个getMapper
方法,目的是为了创建dao层接口的代理类。
SqlSession对象是一个轻量级的、非线程安全的对象,它和数据库连接相关联,一般需要在每个数据库操作中创建一个新的SqlSession对象。 因此,我们利用工厂类设计模式,定义一个SqlSessionFactory
类来生产sqlSession
对象
public interface SqlSessionFactory {
public SqlSession openSession();
}
创建DefaultSqlSession实现类类生成代理对象
sqlSession
接口中定义了操作数据库的多种操作(CRUD等)。接下来,我们定义一个DefaultSqlSession
类,来具体实现上述功能,根据dao层调用的不同接口,执行相应的SQL处理逻辑。
public class DefaultSqlSession implements SqlSession {
private Configuration configuration;
public DefaultSqlSession(Configuration configuration) {
this.configuration = configuration;
}
@Override
public <E> List<E> selectList(String statementid, Object... params) throws Exception {
//将要去完成对simpleExecutor里的query方法的调用
simpleExecutor simpleExecutor = new simpleExecutor();
MappedStatement mappedStatement = configuration.getMappedStatementMap().get(statementid);
// 把具体的sql执行封装到SimpleExecutor中
List<Object> list = simpleExecutor.query(configuration, mappedStatement, params);
return (List<E>) list;
}
@Override
public <T> T selectOne(String statementid, Object... params) throws Exception {
List<Object> objects = selectList(statementid, params);
if(objects.size()==1){
return (T) objects.get(0);
}else {
throw new RuntimeException("查询结果为空或者返回结果过多");
}
}
@Override
public <T> T getMapper(Class<?> mapperClass) {
...
}
}
在创建了DefaultSqlSession
类后,我们采用工厂类的设计模式,定义一个DefaultSqlSessionFactory
工厂类来生产sqlSession
对象。在DefaultSqlSessionFactory
中,包含了数据库连接配置(此外还有一些缓存、事务)等一系列配置信息,并根据这些配置信息创建SqlSession对象。
SqlSessionFactory工厂类的作用是封装了SqlSession对象的创建过程,并且对SqlSession对象进行了统一的管理,使得我们可以更加方便地获取SqlSession对象,并进行数据库操作。同时,SqlSessionFactory也保证了SqlSession对象的线程安全性和可重用性,从而提高了系统的性能和可维护性。
这样,我们就可以通过DefaultSqlSessionFactory
获取SqlSession
对象,然后使用SqlSession
对象进行数据库操作。
public class DefaultSqlSessionFactory implements SqlSessionFactory {
private Configuration configuration;
public DefaultSqlSessionFactory(Configuration configuration) {
this.configuration = configuration;
}
@Override
public SqlSession openSession() {
return new DefaultSqlSession(configuration);
}
}
封装SqlSessionFactoryBuilder
最后,我们将上面的dom4j
解析配置文件,以及sqlSessionFactory
的创建逻辑统一封装在SqlSessionFactoryBuilder
类中,从而便于使用端更快捷地获取到sqlSessionFactory
对象,来生产sqlSession
对象。SqlSessionFactoryBuilder
类的存在主要是为了解耦SqlSessionFactory对象的创建过程和应用程序的代码。
SqlSessionFactory对象的创建过程通常需要读取配置文件、解析配置信息、创建数据源对象等一系列操作,这些操作通常比较复杂,而且需要依赖于具体的持久层框架。为了避免将这些复杂的操作和具体的持久层框架耦合在一起,我们通常会将SqlSessionFactory对象的创建过程封装在SqlSessionFactoryBuilder类中,并将SqlSessionFactoryBuilder类作为一个独立的类提供给应用程序使用。这样,应用程序就可以通过SqlSessionFactoryBuilder类来获取SqlSessionFactory对象,而不需要关心SqlSessionFactory对象的创建细节。
public class SqlSessionFactoryBuilder {
public SqlSessionFactory build(InputStream in) throws DocumentException, PropertyVetoException {
// 第一:使用dom4j解析配置文件,将解析出来的内容封装到Configuration中
XMLConfigBuilder xmlConfigBuilder = new XMLConfigBuilder();
Configuration configuration = xmlConfigBuilder.parseConfig(in);
// 第二:创建sqlSessionFactory对象:工厂类:生产sqlSession:会话对象
DefaultSqlSessionFactory defaultSqlSessionFactory = new DefaultSqlSessionFactory(configuration);
return defaultSqlSessionFactory;
}
}
至此,目前我们的dao层接口代理类和操作数据库的CRUD等功能也已经实现了,解决了使用端与持久层框架的交互问题。并且在sqlSession
类中封装了CURD操作,以及具体的实现逻辑。即现在我们已经能拿到具体的待执行sql,只剩下最后的执行步骤了。
使用连接池执行sql
最初提到,持久层框架底层sql执行实际上使用的也仍然是JDBC,因此,我们将JDBC操作仍然封装到类中,创建Executor
类和simpleExecutor
类。
public interface Executor {
public <E> List<E> query(Configuration configuration,MappedStatement mappedStatement,Object... params) throws Exception;
}
public class simpleExecutor implements Executor {
@Override //user
public <E> List<E> query(Configuration configuration, MappedStatement mappedStatement, Object... params) throws Exception {
// 1. 注册驱动,获取连接
Connection connection = configuration.getDataSource().getConnection();
// 2. 获取sql语句 : select * from user where id = #{id} and username = #{username}
//转换sql语句: select * from user where id = ? and username = ? ,转换的过程中,还需要对#{}里面的值进行解析存储
String sql = mappedStatement.getSql();
BoundSql boundSql = getBoundSql(sql);
// 3.获取预处理对象:preparedStatement
PreparedStatement preparedStatement = connection.prepareStatement(boundSql.getSqlText());
// 4. 设置参数
//获取到了参数的全路径
String paramterType = mappedStatement.getParamterType();
Class<?> paramtertypeClass = getClassType(paramterType);
List<ParameterMapping> parameterMappingList = boundSql.getParameterMappingList();
for (int i = 0; i < parameterMappingList.size(); i++) {
ParameterMapping parameterMapping = parameterMappingList.get(i);
String content = parameterMapping.getContent();
//反射
Field declaredField = paramtertypeClass.getDeclaredField(content);
//暴力访问
declaredField.setAccessible(true);
Object o = declaredField.get(params[0]);
preparedStatement.setObject(i+1,o);
}
// 5. 执行sql
ResultSet resultSet = preparedStatement.executeQuery();
String resultType = mappedStatement.getResultType();
Class<?> resultTypeClass = getClassType(resultType);
ArrayList<Object> 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 value = resultSet.getObject(columnName);
//使用反射或者内省,根据数据库表和实体的对应关系,完成封装
PropertyDescriptor propertyDescriptor = new PropertyDescriptor(columnName, resultTypeClass);
Method writeMethod = propertyDescriptor.getWriteMethod();
writeMethod.invoke(o,value);
}
objects.add(o);
}
return (List<E>) objects;
}
private Class<?> getClassType(String paramterType) throws ClassNotFoundException {
if(paramterType!=null){
Class<?> aClass = Class.forName(paramterType);
return aClass;
}
return null;
}
/**
* 完成对#{}的解析工作: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<ParameterMapping> parameterMappings = parameterMappingTokenHandler.getParameterMappings();
BoundSql boundSql = new BoundSql(parseSql,parameterMappings);
return boundSql;
}
}
上面的代理就是采用JDBC方式访问数据库的尝试书写逻辑了。
- 对于传入的MappedStatement对象,获取其sql值,并对其解析,将#{}使用?进行代替,同时解析出#{}里面的值进行存储。目的是为了后续根据原先#{}中指定的属性,来从传入的参数属性中获取值进行替换。
- 解析完sql后,利用反射根据参数的全限定类名,获取到相应的Class类
- 遍历第一步中的所有占位符参数,利用反射获取到传入的实体类中相应属性的值,并传入
preparedStatement
对象中。 - 利用
preparedStatement.executeQuery()
执行sql,并利用反射获取结果封装实体类。 - 对结果集进行遍历,获取每一个列的值,封装到结果实体类对象的相应属性中
- 最后,返回结果实体类对象的List集合。
上面的代码频繁用了Java反射技术来根据传入的参数类路径和结果类路径,获取sql占位符的参数值以及封装结果集。免去了我们手动封装结果集的繁琐,实现了动态地sql参数绑定。
总结
至此,我们已经完成了自定义持久层框架中的解析xml配置文件 -> 封装实体类 -> 生成接口代理类对象 -> 实现sqlSession封装CRUD操作 -> 封装 JDBC执行sql。实现了我们最初在设计自定义持久层框架中的思路流程。再次归纳总结一下我们的设计流程和思路:
- 创建
Resources
工具类,根据配置文件的路径,将配置文件加载成字节输入流,存储在内存中 - 创建
XMLConfigBuilder
和XMLMapperBuilder
类,利用dom4j
技术对字节输入流根据标签层层进行解析,取出数据库配置和sql配置信息 - 将取出的数据库配置和sql配置信息封装到
Configuration
配置类中 - 创建dao层接口的代理类,从而实现dao层接口方法与
mapper.xml
中指定配置SQL的映射,实现使用端dao层接口调用能够执行mapper.xml
中相应sql的处理逻辑。 - 封装
sqlSession
接口,定义一系列数据库操作方法,进行诸如CRUD操作 - 创建
sqlSessionFactory
,封装我们之前创建的数据库连接配置等信息,用来生产sqlSession
对象,进而可以使用SqlSession对象进行数据库操作。 - 创建
sqlSession
接口和sqlSessionFactory
接口的实现类DefaultSqlSession
和DefaultSqlSessionFactory
。DefaultSqlSession
用来实现实现一系列数据库操作方法,即根据dao层接口的不同方法,执行相应的处理逻辑。DefaultSqlSessionFactory
用来实现根据数据库连接等配置信息生产sqlSession
对象。 - 使用建造者设计模式,将上面的
dom4j
解析配置文件逻辑,以及sqlSessionFactory
的创建逻辑统一封装在SqlSessionFactoryBuilder
类中,从而实现根据数据库配置等信息,创建sqlSessionFactory
的操作。SqlSessionFactoryBuilder
类的存在主要是为了解耦SqlSessionFactory对象的创建过程和应用程序的代码。 - 最后,封装JDBC执行类,替换
mapper.xml
中的sql占位符。并根据传入参数对象的属性值赋值,以及返回参数类型封装结果集。
使用端测试
最后,我们编写使用端来引入我们自定义的持久层框架,并根据该持久层框架编写测试类进行测试。
创建IPersistence_test
MAVEN模块,在pom.xml文件中引入:
<!--引入自定义持久层框架的依赖-->
<dependencies>
<dependency>
<groupId>com.lagou</groupId>
<artifactId>IPersistence</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
</dependencies>
接着定义测试类:
public class IPersistenceTest {
@Test
public void test() throws Exception {
InputStream resourceAsSteam = Resources.getResourceAsSteam("sqlMapConfig.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsSteam);
SqlSession sqlSession = sqlSessionFactory.openSession();
//调用
User user = new User();
user.setId(1);
user.setUsername("张三");
/* User user2 = sqlSession.selectOne("user.selectOne", user);
System.out.println(user2);*/
/* List<User> users = sqlSession.selectList("user.selectList");
for (User user1 : users) {
System.out.println(user1);
}*/
IUserDao userDao = sqlSession.getMapper(IUserDao.class);
List<User> all = userDao.findAll();
for (User user1 : all) {
System.out.println(user1);
}
}
}
输出结果:
User{id=1, username='lisi'}
User{id=2, username='zhangsan'}
当我们在使用端的dao层接口调用finalAll
方法后,持久层框架执行了UserMapper.xml
文件中定义的sql方法和参数,并将返回值封装在了User
对象中返回。验证了我们自定义持久层框架的设计思路和实现是正确的。
总体来说,上述自定义持久层框架的设计没有特别复杂,但是仍然包含了持久层框架中比较核心的几个模块和技术。上面的讲述过程可能比较繁琐,很多东西没有讲得很清,有兴趣的可以跟着代码写一遍,从而加深自己的理解。
完整的项目代码,我放在下面的github上了,有兴趣的大家可以download下来学习:
https://github.com/TAM-Lab/BlogCodeRepository/tree/main/mybatis