Idea中搭建Spring源码阅读环境

水深无声 2024-03-16 10:15 84阅读 0赞

#### 目录 ####

*  一、前期准备
 *   *  1. gradle配置
     *  2. Spring 源码下载
 *  二、spring-framwork 源代码编译
 *  三、问题解决
 *   *  1. 搭建时编译的过程中，可能会出现如下报错：A build scan was not published as you have not authenticated with server 'ge.spring.io'.Build scan background action failed.
     *   *  解决方式
     *  2. 在测试文件夹里添加了一个单元测试类myTest并运行，出现：No tests found for given includes: \[\*\*/\*Tests.class, \*\*/\*Test.class\]
     *   *  解决方式
     *  3. 运行单元测试类时，报错：java.lang.NoClassDefFoundError: org/hamcrest/SelfDescribing
     *   *  解决方式
     *  4. 控制台输出显示中文乱码
     *   *  解决方式

## 一、前期准备 ##

1.  IntelliJ IDEA 2020.2
2.  JDK 15.0.2
3.  gradle 6.8.3
4.  spring-framwork 5.3.x

### 1. gradle配置 ###

下载地址：[https://services.gradle.org/distributions/][https_services.gradle.org_distributions]  
gradle版本与JDK版本兼容性说明：[https://docs.gradle.org/current/userguide/compatibility.html\#compatibility][https_docs.gradle.org_current_userguide_compatibility.html_compatibility]

2.1 环境变量配置

以我下载存放文件夹位置为例：

![在这里插入图片描述][ecc6c7ef9cb74bb78cb4bcc31da68309.png]

打开“系统属性 - 高级 - 环境变量 - 系统变量”，增添以下变量：

![在这里插入图片描述][564e3087f32c4f8c85e1846b9a0d8b2a.png]

在系统变量 - 选择 Path，点编辑 - 添加“`%GRADLE_HOME%\bin`”  
![在这里插入图片描述][4c8070cd6b9c4fbe82cdbfc67e78f9e6.png]  
设置好了之后，打开cmd窗口验证下是否配置成功：

gradle -version

![在这里插入图片描述][d7ea0075e5c345c0ac39b3b0f5214003.png]

### 2. Spring 源码下载 ###

Spring 源码地址：[https://github.com/spring-projects/spring-framework/tree/5.3.x][https_github.com_spring-projects_spring-framework_tree_5.3.x]  
Spring 源码国内镜像地址：[https://gitcode.net/mirrors/spring-projects/spring-framework][https_gitcode.net_mirrors_spring-projects_spring-framework]  
Spring 源码构建官方文档：[https://github.com/spring-projects/spring-framework/wiki/Build-from-Source][https_github.com_spring-projects_spring-framework_wiki_Build-from-Source]

下载spring-framwork源码后，用 IntelliJ IDEA 打开，然后打开`Settings`，修改Gradle配置为本地配置

![在这里插入图片描述][0810555507ba40088c3cdbf15dd6e500.png]

打开 `build.gradle` 文件，配置阿里云镜像：

参考阿里云代理仓库指南：[https://developer.aliyun.com/mvn/guide][https_developer.aliyun.com_mvn_guide]  
会发现 public 仓库没有spring相关依赖，所以需要额外配置 https://maven.aliyun.com/repository/spring。否则会报异常：Could not resolve: com.ibm.websphere:uow:6.0.2.17  
![在这里插入图片描述][84ee7d5c23aa4dc0923608f07fb66dae.png]

maven {
         url 'https://maven.aliyun.com/nexus/content/groups/public/' }
    maven {
         url 'https://maven.aliyun.com/repository/spring' }

![在这里插入图片描述][f8be26a7485d478ab53de9bb691d2423.png]

修改 `gradle-wrapper.properties` 文件

![在这里插入图片描述][39a9f44e23914e2daa28e16c3cd06365.png]

## 二、spring-framwork 源代码编译 ##

需要注意的是：由于IDEA不能识别 AspectJ 语法，会报错。AspectJ 使用的 ajc 编译器，可以看成是 javac 的增强版，而IDEA默认使用的是 javac 编译器，无法识别 Aspectj 语法，所以会报错。AspectJ入门及在IDEA中的配置可以参考这篇文章：[https://juejin.cn/post/6844904065659305991][https_juejin.cn_post_6844904065659305991]

因此，这里我们可以选择直接排除 spring-aspects 模块，或者安装AspectJ并设置IDEA选用ajc编译器。具体操作可以参考《Spring源码深度解析》第2版中1.4章节。

在Project Structure中需要将 spring-aspects 这个module除去，因为build报错。

右键 spring-aspects 模块，点击 `Load/Unload modules`

选中 spring-aspects 点击 unload 之后如图所示  
![在这里插入图片描述][4085c1049f8b446c967d6ee064ca601d.png]

module 编译顺序：core-oxm-context-bean-aop

*  工程-Tasks-other-compileTestJava  
    ![在这里插入图片描述][f09c60d7497545dabf63a43e1d079842.png]  
    编译成功，显示如下  
    ![在这里插入图片描述][77d0a79b27eb43068ca1f3126cc7915b.png]  
    当以上 module 都编译好了后，则可以创建一个自己的 Spring module 来调试阅读 Spring 框架源码了。

## 三、问题解决 ##

### 1. 搭建时编译的过程中，可能会出现如下报错：A build scan was not published as you have not authenticated with server ‘ge.spring.io’.Build scan background action failed. ###

#### 解决方式 ####

将 `setting.gradle` 文件中的这行代码注释  
![在这里插入图片描述][aff0004727e94d1d81d463886036a4d1.png]

### 2. 在测试文件夹里添加了一个单元测试类myTest并运行，出现：No tests found for given includes: \[\*\*/\*Tests.class, \*\*/\*Test.class\] ###

![在这里插入图片描述][3f5c324a61ab40ea8b4134fecd1280cb.png]

#### 解决方式 ####

配置测试运行器  
在Settings的Gradle工具窗口中，打开 Gradle设置页面。

在“ 运行测试使用”列表中，为选定的Gradle项目选择以下测试运行器选项之一：

*  Gradle：IntelliJ IDEA使用Gradle作为默认测试运行器。结果，在持续集成（CI）服务器上获得相同的测试结果。此外，在命令行中运行的测试将始终在IDE中运行。
 *  IntelliJ IDEA：选择此选项可将测试过程委派给IntelliJ IDEA。在这种情况下，IntelliJ IDEA使用 JUnit 测试运行器，并且由于增量编译，测试运行得更快。  
    选择每个测试：选择此选项可配置每个测试专门使用哪个测试运行器（Gradle或IntelliJ IDEA）。

这里要选择IntelliJ IDEA  
![在这里插入图片描述][ac5e84630f674d6db36a50c8eb6ef9a4.png]

### 3. 运行单元测试类时，报错：java.lang.NoClassDefFoundError: org/hamcrest/SelfDescribing ###

![在这里插入图片描述][0565692cb7204f3aa7ba41608bcdbb6f.png]

查官网：JUnit now uses the latest version of Hamcrest. Thus, you can use all the available matchers and benefit from an improved assertThat which will now print the mismatch description from the matcher when an assertion fails.

*  junit.jar: Includes the Hamcrest classes. The simple all-in-one solution to get started quickly.Starting with version 4.11, Hamcrest is no longer included in this jar.（4.11以上版本不在包含hamcrest）
 *  junit-dep.jar: Only includes the JUnit classes but not Hamcrest. Lets you use a different Hamcrest version.

#### 解决方式 ####

所以现在有两个办法解决：

1.  junit版本降到4.10
2.  导入hamcrest-core-1.3.jar

这里我在 build.gradle 里将 junit 版本修改为 4.10

![在这里插入图片描述][7b8eee0f62d24f62b8d39574ef62115f.png]

然后重新build gradle，运行单元测试类 myTest

![在这里插入图片描述][3ba20fbe164c4ad9b0f07b12702f3570.png]

但是又出现了问题，测试类中我打印的是中文，控制台输出时乱码了。

### 4. 控制台输出显示中文乱码 ###

#### 解决方式 ####

在工具栏 - help中，选择 Edit Custom VM Options…  
![在这里插入图片描述][84ecca6c798241a699ff161b72c615de.png]

增加配置

-Dfile.encoding=UTF-8

![在这里插入图片描述][1f0aa7f7bc08448cb8d3e0c6563065e1.png]

重启 IDEA 即可。如果重启后控制台输出仍然显示中文乱码，则有可能是没有清楚缓存，需要在 File 中选择 Invalidate Caches / Restart…

![在这里插入图片描述][30a36d3b72ef45b59e35d471191c11f5.png]

[https_services.gradle.org_distributions]: https://services.gradle.org/distributions/
[https_docs.gradle.org_current_userguide_compatibility.html_compatibility]: https://docs.gradle.org/current/userguide/compatibility.html#compatibility
[ecc6c7ef9cb74bb78cb4bcc31da68309.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/e6a11d6ad0a34e389ad6c03d3dde024a.png
[564e3087f32c4f8c85e1846b9a0d8b2a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/157c111d5b9346a182af5d81ab7216d6.png
[4c8070cd6b9c4fbe82cdbfc67e78f9e6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/c93d5b253dff4b368319da5bd815e58c.png
[d7ea0075e5c345c0ac39b3b0f5214003.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/819a1398a8164e6ab1c58fc565cb8f8e.png
[https_github.com_spring-projects_spring-framework_tree_5.3.x]: https://github.com/spring-projects/spring-framework/tree/5.3.x
[https_gitcode.net_mirrors_spring-projects_spring-framework]: https://gitcode.net/mirrors/spring-projects/spring-framework
[https_github.com_spring-projects_spring-framework_wiki_Build-from-Source]: https://github.com/spring-projects/spring-framework/wiki/Build-from-Source
[0810555507ba40088c3cdbf15dd6e500.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/dcb87f18deda476dbe9f0ebc79274d1b.png
[https_developer.aliyun.com_mvn_guide]: https://developer.aliyun.com/mvn/guide
[84ee7d5c23aa4dc0923608f07fb66dae.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/85210240f31146a18e766a300c8b5cb9.png
[f8be26a7485d478ab53de9bb691d2423.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/ba1cd34f0fe94746aa4ee563c27b6ecb.png
[39a9f44e23914e2daa28e16c3cd06365.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/46bed7c4449c41718aa1c024c9eecdeb.png
[https_juejin.cn_post_6844904065659305991]: https://juejin.cn/post/6844904065659305991
[4085c1049f8b446c967d6ee064ca601d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/627516626263488f8c293daf9dc797dc.png
[f09c60d7497545dabf63a43e1d079842.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/598eeb68055d4205a194b80eea3c19ad.png
[77d0a79b27eb43068ca1f3126cc7915b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/44bf003471c5464dadc77a51a4ecb5c8.png
[aff0004727e94d1d81d463886036a4d1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/4560514af5bd4b4c9c2da505ccd0b186.png
[3f5c324a61ab40ea8b4134fecd1280cb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/9c15fd4063b44255afab290ecb445079.png
[ac5e84630f674d6db36a50c8eb6ef9a4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/848bd3e572b44a6ea1677f4caf99fbb7.png
[0565692cb7204f3aa7ba41608bcdbb6f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/a3d60e6085fc4e18ae6eff3b67476318.png
[7b8eee0f62d24f62b8d39574ef62115f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/eeaf1dbf0e0049059d6dc73b0ecf3c51.png
[3ba20fbe164c4ad9b0f07b12702f3570.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/30a0512f7fe04f089e0bd41d4b24f18a.png
[84ecca6c798241a699ff161b72c615de.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/70dfc362731a4d1b98124cb83a9fe928.png
[1f0aa7f7bc08448cb8d3e0c6563065e1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/19b6ca1e72d341bba0b2318eaba888bd.png
[30a36d3b72ef45b59e35d471191c11f5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/423f2944a05a4905bb9b8fb933294bbc.png