深入浅出mybatis之启动详解

深入浅出mybatis之启动详解

MyBatis功能丰富,但使用起来非常简单明了,今天我们来追踪一下它的启动过程。

目录

  • 如何启动MyBatis
  • 如何使用MyBatis
  • MyBatis启动过程

如何启动MyBatis

我们知道,SqlSessionFactory是MyBatis中最为核心的组件,每个基于MyBatis的应用都是以一个SqlSessionFactory实例为中心的。SqlSessionFactory的实例可以通过SqlSessionFactoryBuilder获得,而SqlSessionFactoryBuilder则可以从XML配置文件或一个预先定制的Configuration实例构建出SqlSessionFactory的实例。

1. 从XML配置文件中构建SqlSessionFactory实例

从XML文件中构建SqlSessionFactory实例非常简单,建议使用类路径下的资源文件进行配置。也可以使用任意的输入流(InputStream)实例,包括字符串形式的文件路径或者“file://”形式的URL文件路径来配置。通常,我们使用MyBatis包含一个名叫Resources的工具类,从classpath路径下加载资源文件。

  • 从类路径下的xml配置文件中构建SqlSessionFactory
public static void main(String[] args) throws IOException {
    // 使用Resources工具从类路径下的xml配置中构建SqlSessionFactory
    String resource = "mybatis-config.xml";
    InputStream is = Resources.getResourceAsStream(resource);
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
}
  • 从字符串形式路径下的xml配置文件中构建SqlSessionFactory
public static void main(String[] args) throws IOException {
    // 从文件系统绝对路径下的xml配置文件中构建SqlSessionFactory
    FileInputStream is = new FileInputStream("D:/mybatis-config.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
}
  • 从"file://"形式的URL路径xml配置文件中构建SqlSessionFactory
public static void main(String[] args) throws IOException {
    // 从URL路径下的xml配置文件中构建SqlSessionFactory
    URL url = new URL("file:///D:/mybatis-config.xml");
    InputStream is = url.openStream();
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
}

如上所示,我们从指定路径下加载MyBatis的配置文件:mybatis-config.xml。当然,正如前面所说,我们也可以通过Java API的方式通过定制Configuration类实例来构建SqlSessionFactory实例。

2. 通过Java API构建SqlSessionFactory实例

public static void main(String[] args) throws IOException {
    // 通过Java API构建SqlSessionFactory
    // 数据源
    PooledDataSource dataSource = new PooledDataSource();
    dataSource.setDriver("com.mysql.cj.jdbc.Driver");
    dataSource.setUrl("jdbc:mysql://127.0.0.1:3306/test_mybatis?characterEncoding=utf8&serverTimezone=UTC");
    dataSource.setUsername("root");
    dataSource.setPassword("");
    // 事务管理器
    TransactionFactory transactionFactory = new JdbcTransactionFactory();
    Environment environment = new Environment("dev", transactionFactory, dataSource);
    Configuration configuration = new Configuration(environment);

    // 注册指定映射器
    configuration.addMapper(TestMapper.class);
    // 注册映射器类所在包名下的所有映射器
    //configuration.addMappers("org.chench.test.mybatis.mapper.impl");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration);
}

如何使用MyBatis

在构建好SqlSessionFactory实例之后,我们就可以获取SqlSession实例,用于与数据库进行交互。

SqlSession sqlSession = sqlSessionFactory.openSession();

SqlSession是一个与数据库交互的接口,在MyBatis中存在3个实现类,分别是:DefaultSqlSession,SqlSessionManager和SqlSessionTemplate。

其中,DefaultSqlSession是常用的SqlSession实现,而SqlSessionManager和SqlSessionTemplate都是SqlSession的代理类,用于实现事务提交和回滚。DefaultSqlSession和SqlSessionManager可用于在普通应用中集成MyBatis,而SqlSessionTemplate则用于MyBatis与Spring框架集成。注意:SqlSessionTemplate自己不实现事务回滚,而是交给Spring框架进行处理,我们可以从SqlSessionTemplate的源码中证实这一点:

/**
 * {@inheritDoc}
 */
@Override
public void rollback() {
  throw new UnsupportedOperationException("Manual rollback is not allowed over a Spring managed SqlSession");
}

/**
 * {@inheritDoc}
 */
@Override
public void rollback(boolean force) {
  throw new UnsupportedOperationException("Manual rollback is not allowed over a Spring managed SqlSession");
}

获取到SqlSession实例之后,就可以执行CRUD操作了。具体来讲,对于不用的映射器配置,使用方式略有不同。

1. 使用xml映射器

所谓的xml映射器是指,将SQL语句及相关ORM映射的配置都写在xml文件中:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="org.chench.test.mybatis.mapper">
    <!-- 查询一条数据 -->
    <select id="selectOneTest" resultType="org.chench.test.mybatis.model.Test">
        select * from test where id = #{id}
    </select>
</mapper>
// 从xml映射配置中执行指定id的语句,并传递参数
Test test = sqlSession.selectOne("org.chench.test.mybatis.mapper.selectOneTest", 1);
if(logger.isDebugEnabled()) {
    logger.debug((test == null) ? "test is NULL!" : test.toString());
}

2. 使用注解映射器

使用注解方式映射SQL语句是指:直接将SQL编写在映射器接口方法的注解中。

// 定义映射器接口
public interface TestMapper {
    // 直接将SQL语句以注解的方式编写
    @Select("select * from test where id = #{id}")
    public Test selectOneTest(long id);
}

// 直接调用映射器接口方法,并传递参数
Test test = sqlSession.getMapper(TestMapper.class).selectOneTest(1);
if(logger.isDebugEnabled()) {
    logger.debug((test == null) ? "test is NULL!" : test.toString());
}

如上两种映射器方式分别需要在MyBatis的xml配置文件进行相应的配置,或者在通过Java API方式构建SqlSessionFactory实例时明确进行配置。 mybatis-config.xml:

<mappers>
    <!-- xml映射器:将SQL语句写在xml文件中 -->
    <mapper resource="org/chench/test/mybatis/mapper/xml/TestMapper.xml" />

    <!-- 注解映射器:将SQL语句写在Java代码中, 这里有2种方式:  -->
    <!-- 方式一: 注册每一个映射器接口,需要明确注册每一个接口 -->
    <!-- 方式二: 指定映射器接口所在包,则该包下的所有映射器接口都会被注册 -->
    <!-- <mapper class="TestMapper" /> -->
    <package name="org.chench.test.mybatis.mapper.impl"/>
</mappers>

注意: 在使用xml配置文件方式构建SqlSessionFactory实例时,既可以配置xml映射器,也可以配置注解映射器;但是直接通过Configuration对象构建SqlSessionFactory实例时,只能配置注解映射器。

// 注册指定注解映射器
configuration.addMapper(TestMapper.class);
// 通过映射器类所在包名批量注册注解映射器
configuration.addMappers("org.chench.test.mybatis.mapper.impl");

差别在于:xml映射器最终会通过XMLConfigBuilder工具类解析为对应的Configuration配置参数。

MyBatis启动过程

SqlSessionFactory既可以通过xml配置文件构建,也可以通过Java API构建,那么它们有什么区别呢?下面,我们来一一剖析一下MyBatis的启动过程。 以从classpath路径下加载配置文件构建SqlSessionFactory实例的方式说起。

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

首先,我们先看一下MyBatis启动的时序图:

从上图我们可以很清晰地看到,在MyBatis的启动过程中涉及到三个非常核心的类,分别是:SqlSessionFactoryBuilder,XMLConfigBuilder和Configuration,我们再来进一步追踪其源码实现。 SqlSessionFactoryBuilder.java:

// 传递配置文件的输入流对象
public SqlSessionFactory build(InputStream inputStream) {
    return build(inputStream, null, null);
}

// 通过XMLConfigBuilder工具类解析xml配置
public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {
    try {
        XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);
        return build(parser.parse());
    } catch (Exception e) {
        throw ExceptionFactory.wrapException("Error building SqlSession.", e);
    } finally {
        ErrorContext.instance().reset();
        try {
            inputStream.close();
        } catch (IOException e) {
            // Intentionally ignore. Prefer previous error.
        }
    }
}

// 通过Configuration实例构建SqlSessionFactory对象
public SqlSessionFactory build(Configuration config) {
    return new DefaultSqlSessionFactory(config);
}

XMLConfigBuilder.java:

// 调用XMLConfigBuilder工具实例的解析方法,解析xml配置信息,并组装在Configuration实例属性中
public Configuration parse() {
    if (parsed) {
        throw new BuilderException("Each XMLConfigBuilder can only be used once.");
    }
    parsed = true;
    parseConfiguration(parser.evalNode("/configuration"));
    return configuration;
}

// 解析MyBatis配置文件,在这里我们可以很清楚的看到MyBatis的配置文件结构
private void parseConfiguration(XNode root) {
    try {
        //issue #117 read properties first
        propertiesElement(root.evalNode("properties"));
        Properties settings = settingsAsProperties(root.evalNode("settings"));
        loadCustomVfs(settings);
        typeAliasesElement(root.evalNode("typeAliases"));
        pluginElement(root.evalNode("plugins"));
        objectFactoryElement(root.evalNode("objectFactory"));
        objectWrapperFactoryElement(root.evalNode("objectWrapperFactory"));
        reflectorFactoryElement(root.evalNode("reflectorFactory"));
        settingsElement(settings);
        // read it after objectFactory and objectWrapperFactory issue #631
        environmentsElement(root.evalNode("environments"));
        databaseIdProviderElement(root.evalNode("databaseIdProvider"));
        typeHandlerElement(root.evalNode("typeHandlers"));
        mapperElement(root.evalNode("mappers"));
    } catch (Exception e) {
        throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e);
    }
}

通过上述源码阅读我们不难发现,不论以哪种方式(xml配置文件或API)构建SqlSessionFactory实例,最终都是通过Configuration实例构建SqlSessionFactory实例。只不过以xml方式配置时,是一种阅读性更好的方式,但是最终需要通过XMLConfigBuilder工具类对xml配置文件进行解析,然后再构建为一个Configuration实例。

【参考】 [1]. http://www.mybatis.org/mybatis-3/zh/getting-started.html

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

扫码关注云+社区

领取腾讯云代金券