概要

本文介紹使用IntelliJ IDEA搭建Spring Framework源代碼環境，用于源代碼閱讀與debug。

環境搭建

1.下載源代碼

訪問Spring Framework在GitHub的地址，下載最新源代碼。本人在下載時，版本號為5.2.2.BUILD-SNAPSHOT

https://github.com/spring-projects/spring-framework

2.根據說明導入IntelliJ IDEA

根據源代碼文件中的IDEA導入說明進行操作，說明文件為源代碼根目錄的import-into-idea.md

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

• 1.需要預編譯spring-oxm，通過控制臺，進入到Spring Framework目錄，運行命令gradlew :spring-oxm:compileTestJava。
  注：Spring Framework是通過Gradle進行的編譯打包，故需要提前安裝Gradle
• 2.導入至IDEA中， 操作方法：File -> New -> Project from Existing Sources -> Navigate to directory -> Select build.gradle
  
• 3.排除spring-aspects模塊，因IDEA的問題該模塊不會被識別，如不排除則會提示編譯錯誤。
  操作方法：spring-aspects右鍵 -> Load/Unload modules -> 添加spring-aspects為Unloaded modules
  

  測試DEMO

  在源代碼項目目錄下，本人直接創建了一個Maven測試項目，并創建了一個簡單的Bean注冊于獲取的例子。

  pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>cn.daiwuliang</groupId>
  <artifactId>demo</artifactId>
  <version>1.0-SNAPSHOT</version>
  <name>demo</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
      <!-- 引入commons-logging依賴 -->
      <dependency>
          <groupId>commons-logging</groupId>
          <artifactId>commons-logging</artifactId>
          <version>1.2</version>
      </dependency>
  </dependencies>
  <build>
    <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
      <plugins>
        <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>3.1.0</version>
        </plugin>
        <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.22.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-jar-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.5.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.8.2</version>
        </plugin>
        <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
        <plugin>
          <artifactId>maven-site-plugin</artifactId>
          <version>3.7.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-project-info-reports-plugin</artifactId>
          <version>3.0.0</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

TestDemo

package demo.test;
public class TestDemo {
    public String test(String str) {
        return String.format("ECHO: %s", str);
    }
}

App.java

package demo.test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.FileSystemXmlApplicationContext;
public class App {
    public static void main(String[] args) {
        String XMLPath = "D:\\spring-framework-master\\demo\\src\\main\\java\\demo\\test\\spring-config.xml";
        ApplicationContext applicationContext = new FileSystemXmlApplicationContext(XMLPath);
        TestDemo td = (TestDemo) applicationContext.getBean("testDemo");
        System.out.println(td.test("Hello World!!!"));
    }
}

spring-config.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd">
    <bean id="testDemo" class="demo.test.TestDemo"/>
</beans>

運行問題

1. Demo模塊需要添加相應的spring模塊的依賴，添加方式：File -> Project Structure -> Dependencies，目前Demo中僅實現了簡單的例子，故只添加了如下幾個模塊：
   
2. spring-core中缺少commons-logging的依賴
   雖然已經在demo的pom中添加了依賴，但仍舊報錯，本人的解決辦法為在spring-core的spring-core.gradle再添加一次，并重新構建

   dependencies {
    ......
    compile("commons-logging:commons-logging:1.2")
   }
   

3. CoroutinesRegistrar中找不到變量CoroutinesUtils
   CoroutinesUtils位于spring-core目錄下的kotlin-coroutines中，看結構其為一個獨立的模塊，并且spring-core并未關聯依賴。
   找到kotlin-coroutines/build/libs/kotlin-coroutines-5.2.2.BUILD-SNAPSHOT.jar->右鍵Add as Library

至此，運行App中的main方法，得到以下結果:

Hello World!