導(dǎo)讀：閱讀源碼是提升自己代碼能力的一個非常重要的手段徊哑，但是源碼閱讀有時候也非常麻煩硼啤，一定要找到入口點艰猬，然后動態(tài)地去看代碼横堡，一步步調(diào)試然后畫圖做筆記記錄，才能在一團(tuán)亂中清理出一個道路來冠桃。這篇文章介紹了我在閱讀Mybatis源碼的準(zhǔn)備過程命贴。
Mybatis簡介
mybatis是一個流行的半自動映射框架，之所以稱為半自動框架是因為它需要手工匹配Java類食听，SQL和映射關(guān)系胸蛛，而全表映射的Hibernate只需要提供POJO和映射關(guān)系就可以了。區(qū)別如下表：
| MyBatis | Hibernate |
|---|---|
| java類 | java類 |
| 映射規(guī)則 | 映射規(guī)則 |
| SQL | 無 |
通過上表也可以看出樱报，Hibenate無需編寫SQL葬项，所以開發(fā)效率優(yōu)于Mybatis.此外，它提供緩存迹蛤、日志民珍、級聯(lián)等功能。但是缺點也是十分明顯盗飒，多表關(guān)聯(lián)復(fù)雜的SQL嚷量，根據(jù)條件變化的SQL。存儲過程等場景使用Hibenate非常不便逆趣，而性能又難以通過SQL優(yōu)化蝶溶。所以注定Hibernate只適用于場景不太復(fù)雜，要求性能不太苛刻的時候使用宣渗。如果你需要一個靈活的抖所、可以動態(tài)生成映射關(guān)系的框架，那么MyBatis是一個最好的選擇落包。
MyBatis組件以及執(zhí)行基本流程
- SqlSessionFactoryBuilder（構(gòu)造器）:它會根據(jù)配置信息或者代碼生成SqlSessionFactory（工廠接口）
- SqlSessionFactory：依靠工廠來生成SqlSession部蛇。
- SqlSession：是一個既可以發(fā)送SQL去執(zhí)行并返回結(jié)果的，也可以獲取Mapper接口咐蝇，通過Mapper接口查詢并封裝數(shù)據(jù)。
- SQL Mapper:它是MyBatis新設(shè)計的組件，它是由一個Java接口和XML文件（或者注解)構(gòu)成的有序，需要給出對應(yīng)的SQL和映射規(guī)則抹腿。它負(fù)責(zé)發(fā)送SQL去執(zhí)行，并返回結(jié)果旭寿。
用下圖表達(dá)上述組件之間的關(guān)聯(lián)
Mybatis 的構(gòu)成
mybatis源碼閱讀準(zhǔn)備
- github上有一個中文注釋版的MyBatis源碼警绩。MyBatis中文鏈接
- Mybatis是以maven管理的，依賴于Mybatis-parent模塊盅称。將mybatis導(dǎo)入到eclipse中時候肩祥，也需要將mybatis-parent模塊導(dǎo)入。mybatis-parent模塊鏈接
- 將模塊mybatis缩膝，mybatis-parent模塊導(dǎo)入到Eclipse中混狠，接下來就通過mybatis的最基本的代碼來調(diào)試并閱讀mybatis源碼。整個結(jié)構(gòu)如下圖疾层。
image
通過《深入淺出MyBatis技術(shù)原理與實戰(zhàn)》一書的代碼來實現(xiàn)基本調(diào)試将饺。代碼的目錄請看上圖，代碼的內(nèi)容下面一一列出痛黎。
- 數(shù)據(jù)庫表role
-- ----------------------------
-- Table structure for role
-- ----------------------------
DROP TABLE IF EXISTS `role`;
CREATE TABLE `role` (
`id` int(11) DEFAULT NULL,
`role_name` varchar(255) DEFAULT NULL,
`note` varchar(255) DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
-- ----------------------------
-- Records of role
-- ----------------------------
INSERT INTO `role` VALUES ('1', '張三', '張三的備注');
- 數(shù)據(jù)庫表role對應(yīng)的java類
/*
* @author gethin
* 角色的實體類
*/
public class Role {
private long id;
private String roleName;
private String note;
...
getter setter省略
}
- java RoleMapper接口
/*
* @author gethin
*/
public interface RoleMapper {
public Role getRole(Long id);
public Role findRole(String roleName);
public int deleteRole(Long id);
public int insertRole(Role role);
}
- RoleMapper
<?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="com.gethin.mapper.RoleMapper">
<resultMap type="role" id="roleMap">
<id column="id" property="id" javaType="long" jdbcType="BIGINT" />
<result column="role_name" property="roleName" javaType="string"
jdbcType="VARCHAR" />
<result column="note" property="note"
typeHandler="com.gethin.handler.MyStringHandler" />
</resultMap>
<select id="getRole" parameterType="long" resultMap="roleMap">
select
id,role_name as roleName,note from role where id=#{id}
</select>
<select id="findRole" parameterType="long" resultMap="roleMap">
select
id,role_name,note from role where role_name like CONCAT('%',#{roleName
javaType=string,
jdbcType=VARCHAR,typeHandler=com.gethin.handler.MyStringHandler},'%')
</select>
<insert id="insertRole" parameterType="role">
insert into
role(role_name,note) value(#{roleName},#{note})
</insert>
<delete id="deleteRole" parameterType="long">
delete from role where
id=#{id}
</delete>
</mapper>
- MyStringHandler
@MappedTypes({String.class})
@MappedJdbcTypes(JdbcType.VARCHAR)
public class MyStringHandler implements TypeHandler<String> {
private Logger log=Logger.getLogger(MyStringHandler.class);
@Override
public String getResult(ResultSet rs, String colName) throws SQLException {
log.info("使用我的TypeHandler,ResultSet列名獲取字符串");
return rs.getString(colName);
}
@Override
public String getResult(ResultSet rs, int index) throws SQLException {
log.info("使用我的TypeHandler,ResultSet下標(biāo)獲取字符串");
return rs.getString(index);
}
@Override
public String getResult(CallableStatement cs, int index) throws SQLException {
log.info("使用我的TypeHandler,CallableStatement下標(biāo)獲取字符串");
return cs.getString(index);
}
@Override
public void setParameter(PreparedStatement ps, int index, String value, JdbcType arg3) throws SQLException {
log.info("使用我的TypeHandler");
ps.setString(index, value);
}
}
- log4j.properties 配置文件
log4j.rootLogger=DEBUG,stdout
log4j.logger.org.mybatis=DUBUG
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.logDailyFile.layout.ConversionPattern = %5p %d %C:%m%n
- mybatis-config.xml 配置文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<settings>
<setting name="lazyLoadingEnabled" value="true"/>
<!-- <setting name="aggressiveLazyLoading" value="false"/> -->
</settings>
<typeAliases>
<typeAlias alias="role" type="com.gethin.po.Role"/>
</typeAliases>
<typeHandlers>
<typeHandler jdbcType="VARCHAR" javaType="string" handler="com.gethin.handler.MyStringHandler"/>
</typeHandlers>
<!-- 定義數(shù)據(jù)庫的信息予弧，默認(rèn)使用development數(shù)據(jù)庫構(gòu)建環(huán)境 -->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC" />
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver" />
<property name="url" value="jdbc:mysql://localhost:3306/mybatis" />
<property name="username" value="dbuser" />
<property name="password" value="123456" />
</dataSource>
</environment>
</environments>
<!-- 定義映射器 -->
<mappers>
<package name="com.gethin.mapper"/>
</mappers>
</configuration>
- 閱讀以及debug入口 （Main）
public class Main {
public static void main(String[] args) {
String resource="mybatis-config.xml";
InputStream inputStream=null;
try {
inputStream = Resources.getResourceAsStream(resource);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
SqlSessionFactory sqlSessionFactory=null;
sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession=null;
try {
sqlSession=sqlSessionFactory.openSession();
RoleMapper roleMapper=sqlSession.getMapper(RoleMapper.class);
Role role=roleMapper.getRole(1L);
System.out.println(role.getId()+":"+role.getRoleName()+":"+role.getNote());
sqlSession.commit();
} catch (Exception e) {
// TODO Auto-generated catch block
sqlSession.rollback();
e.printStackTrace();
}finally {
sqlSession.close();
}
}
}
通過執(zhí)行Main類，并設(shè)立斷點湖饱，就可以一步一步進(jìn)行源碼的調(diào)試以及閱讀了掖蛤。
