Mybatis源码学习系列之搭建源码阅读环境

1. 实验环境

jdk1.8.0_171
apache-maven-3.5.4
IntelliJ IDEA 2018
mybatis-parent 31
mybatis-3.5.4

2. 下载源码

先在官方GitHub下载对应的代码

shell 复制代码

git clone https://github.com/mybatis/parent
git clone https://github.com/mybatis/mybatis-3

mybatis3使用3.5.4版本，代码只能去归档的Tags里重新下载到local branch

在mybatis3.5.4里查看maven配置，知道mybatis3.5.4依赖的mybatis-parent版本是31

所以，同样，在parent工程里找到对应的tab，切换到local branch

3. 构建mybatis-parent工程

因为mybatis-3.5.4工程依赖于mybatis-parent工程，所以需要先用maven构建好，使用maven命令

shell 复制代码

mvn install -DskipTests=true -Dmaven.test.skip=true -Dlicense.skip=true

可能会有如下的报错提示，网上搜索资料知道，maven-gpg-plugin是maven上传到仓库进行数字签名的插件，初步猜测可能是因为maven版本和源码版本不兼容

Failed to execute goal org.apache.maven.plugins:maven-gpg-plugin:1.6:sign (sign-artifacts)

因为本文只是来学习框架源码，所以可以选择先跳过这个插件编译

修改配置后，mybatis-parent就可以构建成功

4. 构建mybatis-3.5.4工程

构建好mybatis-parent工程后，同理maven install就可以构建好工程，构建的时间会稍微久一点

为了和原本的mybatis3.5.4版本区分，可以修改一下版本号

5. 新建mybatis测试工程

新建一个mybatis测试工程，引入刚才自定义版本号的mybatis-3.5.4-snapshot

可是在测试工程里，我们找个源码文件，发现是不可以编辑的，所以需要设置一下源码，选择File->Project Structure->Libraries，选择maven:org.mybatis:mybatis3.5.4-snapshot，选择sources，再点击加号，将对应的本地代码加进行，然后就可以在源码里写上自己的注释啦

如果出现相关源码查找不到的提示，可以如下操作File->Invalidate Caches and Restart，重启IDEA即可