mybatis源码解析 - 通过一个简单查询例子分析流程

mybatis源码解析 - 通过一个简单查询例子分析流程

1. 前言

mybatis的使用方式有两种，一种是通过statement id的方式访问sqlSession提供的接口，另一种方式是通过mapper接口访问。在本文中，为了简单粗暴地过一遍mybatis源码，直接使用了第一种方式使用mybatis。本文的配置如下所示。源码采用的mybatis版本是 3.3.x。

<configuration>
	<!-- 引入外部属性文件 -->
	<properties resource="jdbc.properties"></properties>

	<settings>
		<!-- 数据库表的字段名到java对象属性映射采用驼峰命名的方式，即表的字段user_name -> 对象的属性userName  -->
		<setting name="mapUnderscoreToCamelCase" value="true" />
		<setting name="cacheEnabled" value="false"/>
	</settings>

	<!-- 配置数据库 -->
	<environments default="development">
		<environment id="development">
			<transactionManager type="JDBC" />
			<dataSource type="POOLED">
				<property name="driver" value="${db.driver}" />
				<property name="url" value="${db.url}" />
				<property name="username" value="${db.username}" />
				<property name="password" value="${db.password}" />
			</dataSource>
		</environment>
	</environments>

	<mappers>
		<mapper resource="mapper/UserMapper.xml" />
	</mappers>
</configuration>

<mapper namespace="userMapper">

	<select id="getUserById" resultMap="user">
        select * from user where id = #{id}
    </select>
    
    <resultMap type="com.github.thinwonton.mybatis.sample.entity.User"
        id="user">
        <result column="user_name" property="userName" />
    </resultMap>
	
</mapper>

测试代码：

		// 建立sqlSessionFactory
		String resource = "mybatis-config.xml"; // mybatis全局配置文件
		InputStream inputStream = Resources.getResourceAsStream(resource);
		SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

		// 获取sqlSession
		SqlSession sqlSession = sqlSessionFactory.openSession();

		// 执行查询
		String statement = "userMapper.getUserById"; // statement的id
		Long parameter = 10L; // 参数
		User user = sqlSession.selectOne(statement, parameter);

2. 总体层次结构

我们先看一下mybatis的总体层次结构，大概了解一下mybatis中的一些重要的类，借用 http://blog.csdn.net/luanlouis/article/details/40422941 里的一张图

• SqlSession            作为MyBatis工作的主要顶层API，表示和数据库交互的会话，完成必要数据库增删改查功能
• Executor              MyBatis执行器，是MyBatis 调度的核心，负责SQL语句的生成和查询缓存的维护
• StatementHandler   封装了JDBC Statement操作，负责对JDBC statement 的操作，如设置参数、将Statement结果集转换成List集合。
• ParameterHandler   负责对用户传递的参数转换成JDBC Statement 所需要的参数，
• ResultSetHandler    负责将JDBC返回的ResultSet结果集对象转换成List类型的集合；
• TypeHandler          负责java数据类型和jdbc数据类型之间的映射和转换
• MappedStatement   MappedStatement维护了一条<select|update|delete|insert>节点的封装， 
• SqlSource            负责根据用户传递的parameterObject，动态地生成SQL语句，将信息封装到BoundSql对象中，并返回
• BoundSql             表示动态生成的SQL语句以及相应的参数信息
• Configuration        MyBatis所有的配置信息都维持在Configuration对象之中。

3. 详细流程

3.1 初始化

mybatis的初始化发生在 SqlSessionFactory 的构建阶段，它会解析配置文件，并把配置封装到 内部的Configuration 对象中。在configuration对象里，除了保存了全局配置文件mybatis-config.xml的配置，还保存了在statment映射文件中的配置，例如增删改查的statment，参数映射集合，结果映射集合等。

3.2 一个简单查询的流程

下图是一个简单流程selectOne()的流程图