MyBatis如何给源码加中文注释

本文转自 MyBatis如何给源码加中文注释？

   我们在看框架源码的时候，如果没有注释，看起来会比较吃力。所以如果能够一边看源码一边自己加中文注释，下次阅读的时候就会轻松很多。问题是：通过maven下载的jar，查看源码，实际上看到的是经过反编译的class文件，是不能够修改的（提示：file is read only）。
   如果把当前maven下载的jar包强行关联到自己下载的源码，又有可能会出现字节码跟源码文件不一致的情况（提示：Library source does not match the bytecode for class），导致debug的时候无法进入代码。
如果要保证源码和字节码一致，最好的办法当然是在本地把下载的源码编译生成jar包，上传到本地maven仓库，再引用这个jar。以MyBatis为例，如果我们要给MyBatis源码加上中文注释（以IDEA操作为例）,按照如下几个步骤操作：

1. 配置Maven

因为需要用Maven打包编译源代码，所以第一步是检查Maven的配置。

• 第一个是环境变量，需要在系统变量中添加MAVEN_HOME，配置Maven主路径，例如“E:\dev\apache-maven-3.5.4”，确保mvn命令可以使用。
• 第二个是检查Maven的配置。Maven运行时，默认会使用conf目录下的settings.xml配置，例如：E:\dev\apache-maven-3.5.4\conf\settings.xml。为了保证下载速度，建议配置成国内的aliyun中央仓库（此处需要自行搜索）。并且，settings.xml中的localRepository应该和IDEA中打开的项目设置中的Local repository保持一致（例如：E:\repository）。否则项目引入依赖时，无法读取到编译后的jar包。
  

2.下载并编译Mybatis源码

因为MyBatis源码编译依赖parent项目的源码，所以第一步是编译parent项目。先从git clone两个工程的项目（截止2020年4月，最新版本是3.5.4）。以在E盘根目录下载为例。

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

打开mybatis-3中的pom.xml文件，查看parent的版本号，例如：

    <parent>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-parent</artifactId>
        <version>31 </version>
        <relativePath/>
    </parent>

确定parent版本是31（记住这个数字）。
把mybatis版本号改成自定义的版本号，避免跟官方版本号冲突（加上了-snapshot）：

<artifactId>mybatis</artifactId>
<version>3.5.4-snapshot</version>
<packaging>jar</packaging>

进入parent目录，切换项目分支（不能在默认的master分支中编译），工程名后面的数字就是前面看到的parent版本号。开始编译parent项目：

cd parent
git checkout mybatis-parent-31
mvn install

接下来编译mybatis工程，进入mybatis-3目录，切换到最新3.5.4分支（不能在默认的master分支中编译）。

cd ../mybatis-3
git checkout mybatis-3.5.4
mvn clean
mvn install -DskipTests=true -Dmaven.test.skip=true -Dlicense.skip=true

编译完毕，本地仓库就会出现一个编译后的jar包，例如：E:\repository\org\mybatis\mybatis\3.5.4-snapshot\mybatis-3.5.4-snapshot.jar
在我们的项目中就可以引入这个jar包了（version是自定义的version）:

<dependency>  
	<groupId>org.mybatis</groupId>  
	<artifactId>mybatis</artifactId> 
	<version>3.5.4-snapshot</version>
</dependency>

3. 关联jar包到源码

本地编译的jar包已经有了，接下来是把jar包和源码关联起来。
Project Structure —— Libries —— Maven: org.mybatis:mybatis:3.5.4-snapshot —— 在原来的Sources上面点+（加号） —— 选择到下载的源码路径，例如：E:\mybatis-3\src\main\java，点击OK

关联好之后，开始打断点debug，就会进入到本地的源码，可以给本地的源码加上注释了。

Tips:
1、如果之前打开过类的字节码文件，本地可能有缓存，一样会有“Library source does not match the bytecode for class”的提示。解决办法：File —— Invalidate Caches and Restart（IDEA会重启）。
2、如果添加注释导致了debug的当前行跟实际行不一致，再把mybatis3工程编译一次即可。