下載Spring4.1.x原始碼並用IntelliJ IDEA開啟

在學習Spring的時想了解一些重要介面和類的原始碼，本文講述了Spring工程的下載和在IDEA上開啟的操作，共需要以下幾步：
1. 安裝JDK；
2. 安裝gradle；
3. 下載spring原始碼；
4. 切換到4.1.x分支；
5. 用IntelliJ IDEA匯入；

接下來準備開始吧；

原文地址：http://blog.csdn.net/boling_cavalry/article/details/79426075

版本參考

以下列出我本次實戰用到的各個工具的版本，以供您參考：
1. 作業系統：win10
2. Git Bash版本2.15，並且已配置好賬號資訊，可以正常執行git命令；
3. JDK：1.8.0_111
4. gradle：2.14.1（不要用4.x版本，會提示找不到外掛”sonar-runner”）
5. IDEA版本如下圖：

安裝JDK

這個就不多說了，記得要配置環境變數JAVA_HOME；

安裝gradle

1. 在此下載：http://services.gradle.org/distributions/；
2. 下載gradle-2.14.1-bin.zip檔案並解壓；
3. 設定環境變數GRADLE_HOME，值是解壓後的gradle-2.14.1資料夾的目錄；
4. 將gradle-2.14.1/bin的路徑新增到PATH中；
5. 在控制檯執行gradle -version可以看到以下資訊，表明安裝和設定成功：

C:\Users\12167>gradle -version

------------------------------------------------------------
Gradle 2.14.1
------------------------------------------------------------

Build time:   2016-07-18 06:38:37 UTC
Revision:     d9e2113d9fb05a5caabba61798bdb8dfdca83719

Groovy:       2.4.4
Ant:          Apache Ant(TM) version 1.9.6 compiled on June 29 2015
JVM:          1.8.0_111 (Oracle Corporation 25.111-b14)
OS:           Windows 10 10.0 amd64

下載spring原始碼

1. 登入GitHub；
2. spring專案的地址是：https://github.com/spring-projects/spring-framework，點選右上角的Fork按鈕，如下圖：
   
3. Fork成功後網頁會自動跳轉到新的專案主頁，如下圖，點選紅框1和紅框2，複製新專案的git地址，例如我這裡的地址是：https://github.com/zq2599/spring-framework.git；
   
4. 開啟命令列終端，執行以下命令開始下載：

git clone https://github.com/zq2599/spring-framework.git

5. 在spring-framework資料夾下，執行git branch -a檢視分支列表，如下：

12167@zhaoqinwin10 MINGW64 /d/study/spring-framework (master)
$ git branch -a
  4.0.x
  4.1.x
* master
  remotes/origin/3.0.x
  remotes/origin/3.1.x
  remotes/origin/3.2.x
  remotes/origin/4.0.x
  remotes/origin/4.1.x
  remotes/origin/HEAD -> origin/master
  remotes/origin/beanbuilder
  remotes/origin/conversation
  remotes/origin/gh-pages
  remotes/origin/master

6. 執行命令 git checkout 4.1.x切換到4.1.x分支；

用IntelliJ IDEA匯入工程

1. 開啟IntelliJ，點選Import Porject按鈕，如下圖紅框：
   
2. 選中spring-framework資料夾；
3. 選擇”Import project from external model“，再選中”Gradle”，如下圖，點選”Next”按鈕：
   
4. 接下來的頁面是一些配置資訊，選擇如下圖，注意要確保Grandle和Jdk的設定是有效的：
   
5. 等待IDEA匯入和構建完成，這裡比較耗時，因為要下載一些依賴庫，如下圖：
   

看原始碼和類圖

匯入完成後，就可以愉快的閱讀原始碼了，遇到重要的類和介面可以用IDEA自帶的類圖工具檢視類圖和繼承關係，操作方法是在原始碼上右鍵選擇”Diagrams -> Show Diagram”，更詳細的操作請參考《用IntelliJ IDEA看Java類圖》；

幾個特別說明

1. 原始碼資料夾下的import-into-idea.md檔案中，說要先執行命令./gradlew cleanIdea :spring-oxm:compileTestJava再用IDEA匯入工程，經過實測不需要執行此命令，就按前面的步驟直接匯入工程也沒問題，當然前提是您的IDEA版本和我的一致或更高；
2. gradle版本請用2.14.1，此版本可以構建成功，我試過4.6版本，會提示找不到外掛”sonar-runner”；
3. 我也試過在匯入時選擇“Use gradle ‘wrapper’ task configuration”，如下圖，也會匯入失敗，提示“Could not determine the class-path for interface org.jetbrains.kotlin.kapt.idea.KaptGradleModel.”：