Spring4.3.12原始碼閱讀系列:1-環境搭建
學習任務
近期想增加部分原始碼閱讀經驗,提高自己在造輪子方面的實力,增長些在設計模式應用方面的編碼能力,以及懷著向大佬們膜拜的心情,開始有計劃地閱讀Spring原始碼
前期準備
以下幾項準備事項,算是基本的日常開發環境,就算沒有,也是動動手很快安裝好的,這裡就不囉嗦詳細記錄了。
若安裝存在困難的,可以嘗試百度解決:請相信自己可以做到的!
- JDK 1.8 安裝及其環境配置(略)
- Eclipse Mars 2 的安裝(略)
- Git客戶端安裝(略)
- Gradle 安裝及其環境變數配置(略)
搭建過程
1. 下載原始碼
訪問 spring-framework 專案官方原始碼網站,檢視版本Release日誌,選定比較穩定合適的版本來分析學習:
本文選取最近釋出的:v4.3.12,進行後續的原始碼閱讀:
# 獲取原始碼
cd d:\Programs\spring\spring-src
git clone https://github.com/spring-projects/spring-framework.git
# 根據網速,上面這一步可能相當慢
# 檢視遠端分支
git branch -r
# 建立切換本地分支
git checkout -b 4.3.x origin/4.3.x
git pull
2. 匯入Eclipse
這樣下載後的原始碼,並不可以直接匯入Eclipse中使用,還需要將原始碼轉化為Eclipse專案後,才可以匯入。
轉換命令是:
cd spring-framework
gradle cleanidea eclipse
# gradle 轉換時,可能出錯,但作者一次就過了,所以,只能略略略地不好意思啦
當然,也可以不用這樣轉換所有的spring專案,而只是轉換某個子專案;本文采用一次轉換全部子專案的做法。
轉換成功後,當然就是按部就班地啟動Eclipse然後匯入了:
Import -> Existing Project … -> Select Root Directory -> check Option: Search for nested projects -> Finish
3. 解決專案依賴錯誤
spring原始碼專案匯入後,會首先遇到專案依賴錯誤的問題,我遇到的存在依賴問題的子專案有:
- spring-core
- spring-beans-groovy
- spring-web
- spring-oxm
- spring-test
- … …
解決辦法:
step 1:開啟專案的屬性頁面,找到構建路徑項(build path),檢視是否缺少jar包依賴,定位到子專案,然後gradle構建之;在解決spring-core的依賴問題時,就是需要這樣做:
cd spring-core gradle build
step 2:按step 1能解決spring-core,spring-oxm等子專案的依賴問題,但spring-beans-groovy依然會存在問題。此時,開啟報錯的程式碼,根據出錯提示,setup project,新增專案依賴:spring-beans,問題得到解決;
如果依舊得不到解決,可以在build path -> libraries 頁面中,新增缺少的依賴jar,jar包一般位於子專案的build\libs下;
其它子專案類似。
4. 解決原始碼錯誤
按照上一步操作後,依然還有部分子專案存在錯誤;開啟報錯的程式碼,發現基本上是test專案中的報錯問題,根據報錯提示的推薦,能解決問題;
我遇到的情況基本上是:
- Mock類中,存在未實現的介面方法; # 增加空白的實現方法可解決報錯;
- TestCase中,import語句造成的方法名模糊; # 重新組織導包語句可以解決之;
到此,原始碼閱讀環境搭建完成!
開始艱苦的原始碼閱讀之路!加油!