01--Spring源码阅读环境搭建

---

新版连接 01–Spring源码深度解析目录

---

SpringBoot源码分析中涉及到了很多Spring的基础内容，所以中断SpringBoot的源码分析，先行分析Spring的源码

1. 本例环境

• JDK1.8
• IDEA 2018.2

2. 源码下载

打开https://github.com/spring-projects/spring-framework/releases下载对应源码，本例是用的是5.1.0RC1版本(该版本即SpringBoot源码分析spring-boot-2.1.0.M1使用的版本)

3.源码编译

网上有很多Spring源码的编译文章，但是建议大家首先参考Spring的官方文档
进入spring-framework-5.1.0.RC1目录，打开import-into-idea.md文件

The following has been tested against IntelliJ IDEA 2016.2.2

## Steps

_Within your locally cloned spring-framework working directory:_

1. Precompile `spring-oxm` with `./gradlew :spring-oxm:compileTestJava`
2. Import into IntelliJ (File -> New -> Project from Existing Sources -> Navigate to directory -> Select build.gradle)
3. When prompted exclude the `spring-aspects` module (or after the import via File-> Project Structure -> Modules)
4. Code away

## Known issues

1. `spring-core` and `spring-oxm` should be pre-compiled due to repackaged dependencies.
See `*RepackJar` tasks in the build and https://youtrack.jetbrains.com/issue/IDEA-160605).
2. `spring-aspects` does not compile due to references to aspect types unknown to
IntelliJ IDEA. See http://youtrack.jetbrains.com/issue/IDEA-64446 for details. In the meantime， the
'spring-aspects' can be excluded from the project to avoid compilation errors.
3. While JUnit tests pass from the command line with Gradle， some may fail when run from
IntelliJ IDEA. Resolving this is a work in progress. If attempting to run all JUnit tests from within
IntelliJ IDEA， you will likely need to set the following VM options to avoid out of memory errors:
    -XX:MaxPermSize=2048m -Xmx2048m -XX:MaxHeapSize=2048m
4. If you invoke "Rebuild Project" in the IDE， you'll have to generate some test
resources of the `spring-oxm` module again (`./gradlew :spring-oxm:compileTestJava`)    


## Tips

In any case， please do not check in your own generated .iml， .ipr， or .iws files.
You'll notice these files are already intentionally in .gitignore. The same policy goes for eclipse metadata.

## FAQ

Q. What about IntelliJ IDEA's own [Gradle support](http://confluence.jetbrains.net/display/IDEADEV/Gradle+integration)?

A. Keep an eye on http://youtrack.jetbrains.com/issue/IDEA-53476

参照文档，在spring-framework-5.1.0.RC1目录下
Linux或者Mac操作系统：执行./gradlew :spring-oxm:compileTestJava命令
Windows操作系统：执行gradlew :spring-oxm:compileTestJava命令

等待一段时间，编译成功…

4.导入IDEA 注意导入的时候要选择:build.gradle

依次选择 File -> New -> Project from Existing Sources-->spring-framework-5.1.0.RC1-- build.gradle
将源码导入到IDEA

等待jar包下载完成，导入结束…

5. 运行测试

打开SimplePropertyNamespaceHandlerWithExpressionLanguageTests.java，运行测试用例即可!

6. 错误解决

• 6.1 jdk版本问题，本例使用的是jdk1.8版本，缺少jdk9中的money包，测试用例运行编译时会有测试类报错，删除MoneyFormattingTests.java即可
• 6.2 gradle，如果./gradlew :spring-oxm:compileTestJava命令无法下载gradle(本例用了例软件，如果不不知道能不能顺利下载下来)，大家可以google gradle环境搭建即可，注意版本 4.8.1
• 6.3 同事在构建源码时有Kotlin Complier错误，可以打开IDEA的插件配置，禁用此插件并重启IDEA即可

Spring源码阅读环境搭建就介绍到这里，本例环境在搭建过程中，没有太多的错误，所以解决方案列举的较少，大家若遇到问题，可百度或google解决，也可以留言给我！