Spring4.3.12源碼閱讀系列:1-環境搭建

學習任務

近期想增加部分源碼閱讀經驗,提高自己在造輪子方面的實力,增長些在設計模式應用方面的編碼能力,以及懷着向大佬們膜拜的心情,開始有計劃地閱讀Spring源碼

前期準備

以下幾項準備事項,算是基本的日常開發環境,就算沒有,也是動動手很快安裝好的,這裏就不囉嗦詳細記錄了。

若安裝存在困難的,可以嘗試百度解決:請相信自己可以做到的!

  • JDK 1.8 安裝及其環境配置(略)
  • Eclipse Mars 2 的安裝(略)
  • Git客戶端安裝(略)
  • Gradle 安裝及其環境變量配置(略)

搭建過程

1. 下載源碼

訪問 spring-framework 項目官方源碼網站,查看版本Release日誌,選定比較穩定合適的版本來分析學習:

Spring源碼的git地址:
https://github.com/spring-projects/spring-framework

Spring Release版本:
https://github.com/spring-projects/spring-framework/releases

本文選取最近發佈的: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

git checkout

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項目中的報錯問題,根據報錯提示的推薦,能解決問題;

我遇到的情況基本上是:

  1. Mock類中,存在未實現的接口方法; # 增加空白的實現方法可解決報錯;
  2. TestCase中,import語句造成的方法名模糊; # 重新組織導包語句可以解決之;

到此,源碼閱讀環境搭建完成!

開始艱苦的源碼閱讀之路!加油!

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章