IDEA导入spring5.1源码的构建

作为一个搞了几年开发的程序员，和人家说你没有看过研究过spring源码，感觉是一件很丢人的事情，以前也仔细看过，但是一直没有构建过源码来看。这次趁着病毒肆虐有时间构建了一把，下面写下心得体会。

这是一次血泪史啊，本来以为应该是很容易的一件事，但是没想到花费的时间差不读够把spring-core写一遍的。。。。。。
废话不说了，直接开搞。
首先千万不要用idea2017去做这件事，有许多不可预知的错误，我就不说了，我说下我用idea2019.3的经历。
版本工具：spring5.1.x，gradle4,9，jdk 1.8.0_162，kotlin1.2.41，groovy2.4.12，IntelliJ IDEA 2019-3，AspectJ

详细步骤及坑见下：

1，下载gradle,可以去官网下载，gradle版本需要4.2以上，小编这里选择的是gradle4.9版本。
gradle下载地址：https://services.gradle.org/distributions/
我下载的
gradle-4.9-bin.zip
解压到无汉字目录，忽略4.6的版本

2.配置gradle环境变量
计算机的系统变量中新建GRADLE_HOME，

path中增加%GRADLE_HOME%/bin;即可

配置完成以后win+r，输入cmd进入dos界面，键入命令gradle -v，若如下图正确输出版本信息即可

3.配置gradle默认的本地仓库，gradle和maven类似，工作时也需要一个本地仓库，管理工程jar包，可做如下配置，新增GRADLE_USER_HOME，路径配置成需要的本地仓库路径即可。

4.下载AspectJ
Spring实现了AOP（面向切面编程），它依赖AspectJ，因此需要下载AspectJ并安装，同时配置好环境变量。（盗图）

打开命令行，cd到AspectJ的jar包所在的文件夹，运行java -jar aspectj-1.9.4.jar命令，打开AspectJ的安装界面，直接点击Next，如下图：

根据提示安装完成。

5.进入到GitHub官网并搜索spring-framework工程，如下：

下载需要的版本，我这里是spring-5.1.x
直接下载很慢，大家可以想自己的办法。
6.下载完成解压完如下，打开下图中的绿框文件，这个很关键


该文件告诉我们
a，因为其他项目需要依赖spring-core和spring-oxm，所以我们导入后需要 先编译这两个包
b，spring-aspects需要依赖三方jar（精通aop的应该知道spring-aop和 aspectj的关系，在使用注解方式实现spring-aop的时候，需要导入aspectj的jar，有兴趣的可以去查阅下官方文档aop相关文档），这里编译可能会报错，不影响我们编译使用，我们先不处理
c，使用工具编译时，可能会出现内存溢出情况，这里我们编译时需要增 加相关参数
-XX:MaxPermSize=2048m -Xmx2048m -XX:MaxHeapSize=2048m

7.接下来大活才开始了：
本来直接导入到idea就可以开始以后的步骤了，但是由于我的idea不能科学上网导了几次都拉不下包来，所以都报错了。于是采取了下边的方式

在spring解压包根路径执行gradlew.bat，然后看到图片内容即为成功，如果显示失败重复执行几次就可以，直到看到成功的标记，然后接着执行命令：gradlew :spring-oxm:compileTestJava

gradlew :spring-core:compileTestJava

同样需要看到成功的标记。

然后IDEA导入源码，先设置好idea的gradle参数，如下
注意红框内容的修改，我这是idea2019.3可能其他版本不是这个版本，但是大致一样。
然后将spring源码导入，选择gradle构建方式
导入后等待相关编译完成显示为如下样子

接下来修改spring-framework源码配置信息

打开上图文档
a. 将 dokka方法以及asciidoctor方法注释
b. task schemaZip(type: Zip) 在某些版本该任务中是没有兼容window的路径符号，需要手动修改一下
task schemaZip(type: Zip) {
group = “Distribution”
baseName = “spring-framework”
classifier = “schema”
description = "Builds -${classifier} archive containing all " +
“XSDs for deployment at https://springframework.org/schema.”
duplicatesStrategy ‘exclude’
moduleProjects.each { subproject ->
def Properties schemas = new Properties();

	subproject.sourceSets.main.resources.find {
		/*(it.path.endsWith("META-INF/spring.schemas") || it.path.endsWith("META-INF\\spring.schemas"))
	}?.withInputStream { schemas.load(it) }*/
		it.path.endsWith("META-INF\\spring.schemas")
	}?.withInputStream { schemas.load(it) }

	for (def key : schemas.keySet()) {
		def shortName = key.replaceAll(/http.*schema.(.*).spring-.*/, '$1')
		assert shortName != key
		File xsdFile = subproject.sourceSets.main.resources.find {
		//	(it.path.endsWith(schemas.get(key)) || it.path.endsWith(schemas.get(key).replaceAll('\\/','\\\\')))
			it.path.endsWith(schemas.get(key).replaceAll('\\/','\\\\'))
		}

然后最关键的一步来了--------》

双击如上图按钮，开始项目的编译，等待，这个时间有点长是个拼网速的时候，也看人品，哈哈哈。如果没成功多执行几次。如下为成功：

这个时间完全看网速大家耐心点。
接下来测试一波

显示如下图片即为成功：

注意：图片上那些其他的错我也没有详细研究，目前没有影响。

碰到的问题：
1）运行java的main方法出现 Process ‘command ‘D:/jdk8/bin/java.exe’’ finished with non-zero exit value 1
将idea的gradle按如下设置

2）Failed to apply plugin [id ‘com.gradle.build-scan’]

• What went wrong:
  An exception occurred applying plugin request [id: ‘com.gradle.build-scan’, version: ‘1.8’]

Failed to apply plugin [id ‘com.gradle.build-scan’]
This version of Gradle requires version 2.0.2 of the build scan plugin or later.
Please see https://gradle.com/scans/help/gradle-incompatible-plugin-version for more information.
原因是gradle版本太高了，具体参考：https://docs.gradle.com/enterprise/compatibility/#build_scan_plugin

3）No such property: immutableValues for class: org.gradle.api.internal.tasks.DefaultTaskDependency
修改：spring-beans.gradle

Open File(spring-beans\spring-beans.gradle ）
点击：Open File 然后注释掉
//compileGroovy.dependsOn = compileGroovy.taskDependencies.values - ‘compileJava’

4）Error:(42, 16) java: 找不到符号: 类 AnnotationTransactionAspect
位置: 类 org.springframework.transaction.aspectj.AspectJTransactionManagementConfiguration
下边的图那拿的别人的

解决方法：主要原因是Idea默认使用的Javac编译器，而aspectj关键字它不认识。这个时候需要我们前期准备的AspectJ编译器Ajc了。开头下载的AspectJ排上用场了。

1. 将Idea的编译器设置为Ajc：
   打开：IDEA–Preferences–Build,Execution,Deployment–Compiler–JavaCompiler,将Use compiler设置为Ajc，将Path to Ajc compiler设置为AspectJ安装目录下的lib文件夹中的aspectjtools.jar文件，同时，可以勾选Delegate to Javac选项，它能够只编译AspectJ的Facets项目，而其他普通项目还是交由Javac来编译。
   
   2.将spring-aop_main和spring-aspectjs_main两个模块添加AspectJ Facets：
   打开：File–Project Structure–Facets，点击+号，选择AspectJ，选择spring-aop_main。添加完后，同样的操作，将spring-aspectjs_main模块也设置AspectJ。（盗图）
   
   再次执行build，已经没有错误了。别忘了下边的步骤
   
   5）1 报错 Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.BeanCreationException
   缺少AspectJ的包，spring AOP就是用aspectj来实现的，是依赖关系！AspectJ是动态代理的一种实现！而spring默认使用的就是AspectJ来实现的动态代理，spring自己的AOP就是使用AspectJ来实现的！
   
   6）Deprecated Gradle features were used in this build, making it incompatible with Gradle 5.0 这是项目运行过程中的一个提示，目前没什么影响，希望有人解决的话留个言。。。。
   7）D:\jdk8\bin\java.exe “-javaagent:D:\IntelliJ IDEA 2019.3.2\lib\idea_rt.jar=57873:D:\IntelliJ IDEA 2019.3.2\bin” -Dfile.encoding=UTF-8 -classpath D:\jdk8\jre\lib\charsets.jar;D:\jdk8\jre\lib\deploy.jar;D:\jdk8\jre\lib\ext\access-bridge-64.jar;D:\jdk8\jre\lib\ext\cldrdata.jar;D:\jdk8\jre\lib\ext\dnsns.jar;D:\jdk8\jre\lib\e