1.3 获取MyBatis源码

1.2节介绍了搭建MyBatis源码调试环境需要的工具,这些工具的安装比较简单,而且本书面向的读者为Java开发人员,相信大部分读者的机器上本身就具备这样的环境。如果缺少这些工具,读者可以自行安装。准备工作完成后,我们就可以获取MyBatis的源码了。MyBatis源码目前托管在Github上,源码地址为https://github.com/mybatis/mybatis-3。

MyBatis框架在Github上的仓库如图1-1所示,如果读者想为MyBatis项目贡献源码,可以注册Github账户,然后单击Fork按钮,在自己的仓库中创建MyBatis项目的副本,代码开发测试完毕后,向上游仓库提交Pull Request即可。当MyBatis源码维护者将我们提交的代码合并后,我们就可以成为MyBatis源码贡献者。关于Github的Fork+Pull Request工作流模式这里不做详细介绍,有兴趣的读者可以参考Github官方文档。

回归主题,我们的目的是获取MyBatis的源码,读者可以先单击图1-1中的Clone or download按钮再单击Download Zip按钮直接下载源码的压缩包。除了这种方式外,我们还可以使用Git客户端克隆一份代码到本地,具体操作如下:

打开Git Bash控制台,执行git clone命令:

上面的命令执行结束后,MyBatis源码项目就会克隆到本地。本书除了介绍MyBatis源码外,还会详细介绍MyBatis与Spring进行整合的原理,因此我们还需要获取mybatis-spring项目的源码,该项目同样托管在Github上,源码地址为https://github.com/mybatis/spring。

图1-1 MyBatis源码Github仓库

我们同样可以使用git clone命令在本地克隆一份mybatis-spring项目源码,具体命令如下:

需要注意的是,MyBatis源码项目使用Maven作为项目构建工具,mybatis和mybatis-spring项目都依赖于一个公共的parent项目,该项目中没有任何代码,只是定义了一些公共的属性及项目依赖的插件信息,我们还需要把mybatis-parent项目(地址为https://github.com/mybatis/parent)克隆到本地。

我们依然使用git clone命令将mybatis-parent项目克隆到本地,具体如下:

3个项目全部克隆到本地后,需要放在同一个目录下。源码目录结构如下:

到此为止,我们获取了阅读本书所需要的MyBatis源码,一共3个项目,分别为mybatis源码项目、mybatis-spring项目以及这两个项目依赖的parent项目。1.4节介绍如何将这些源码导入集成开发工具中。