Spring源码编译一次性通过&遇到的坑解决方法

前言

spring源码本地编译,按网上的博客参考资料的操作步骤,总是会出现各种莫名其妙的错误。根据错误信息找解决方案,但在自己的环境下又总是编译不过去。结合参加培训学习Jack老师提供的方法,自己多种方式尝试,最终编译成功了。

为了验证自己的方式是否有失误的地方,全部过程我自己走了大概5遍,详细记录下每个步骤。如果按1天8小时计的话,为了这个源码编译至少花了3~4天时间。我觉得是值得的,为后面的源码阅读扫除一个拦路虎。

仅以此篇记录踩到的坑,为同样想读源码的同学可以在编译这一步少花一些时间,也可以后面源码阅读增加自信心。同时感谢在网上留下博客的同学,给予我相当多的帮助,这也是我想写这篇文章的原因。

参考博客:

https://www.it610.com/article/1295306604677242880.htm
https://www.cnblogs.com/haoxianrui/p/12825586.html
https://www.cnblogs.com/jhj117/p/5455081.html

1.资源及环境说明:

idea 2019.3.3

gradle-5.6.4版本(对源码里面的版本,版本需要一致,否则编译过程会出现各种异常)

jdk1.8 or 以上版本

spring-5.2.8.RELEASE

系统:win7 or 以上

2.下载源码

选择gitee下载速度快,官网速度非常慢,耗时约60s
git clone --branch v5.2.8.RELEASE https://gitee.com/Z201/spring-framework.git

2.1.查看源码gradle版本号

查看文件路径:/gradle/wrapper/gradle-wrapper.properties

对应的gradle版本:gradle-5.6.4-bin.zip

Spring源码编译一次性通过&遇到的坑解决方法

3.gradle下载&配置环境变量

3.1.gradle下载

# gradle 下载地址
https://services.gradle.org/distributions/
选择版本: gradle-5.6.4-bin.zip
下载到本机,并解压到指定路径

Spring源码编译一次性通过&遇到的坑解决方法

3.2.配置环境变量

配置环境变量
变量名:GRADLE_HOME
变量值:A:\java_about\gradle-5.6.4
在Path加上 ;%GRADLE_HOME%\bin

Spring源码编译一次性通过&遇到的坑解决方法

3.3.验证gradle

Spring源码编译一次性通过&遇到的坑解决方法

4.源码配置相关修改

4.1.gradle-wrapper.properties配置修改

目录:spring-framework/gradle/wrapper
修改 distributionUrl=file:///A:/java_about/gradle-5.6.4-bin.zip  #(本机的所在路径)

Spring源码编译一次性通过&遇到的坑解决方法

4.2.确认kotlin版本号

先查看idea的kotlin版本,查看路径:File->Setting->Plugins,搜索kotlin,如果还没安装过先安装一下。

我的版本号是1.3.61

Spring源码编译一次性通过&遇到的坑解决方法

4.3.build.gradle配置

目标文件:build.gradle 在根目录下

4.3.1.注释gradle企业约束

因为该plugins不注释,会发生很多不可预期的错误,

搜索关键字:io.spring.gradle-enterprise-conventions

注释如下:

//	id 'io.spring.gradle-enterprise-conventions' version '0.0.2'

Spring源码编译一次性通过&遇到的坑解决方法

4.3.2.确认kotlin版本号是否一致

如果不一致,修改成跟idea的kotlin的版本号一样,我的版本号为1.3.61,而Spring-5.2.8.RELEASE对应kotlin的版本号是1.3.72,所以需要修改。需要修改的地方有2处

搜索关键字:kotlin.jvm    ,    kotlin-bom

Spring源码编译一次性通过&遇到的坑解决方法

4.3.3.添加上阿里镜像

为仓库添加上阿里镜像,目的是加快资源下载,编译速度加快。行号约279,在dependencyManagement下的repositories 添加:

maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter'}

Spring源码编译一次性通过&遇到的坑解决方法

4.4.settings.gradle配置

为插件仓库添加上阿里镜像,行号约2,在pluginManagement下的repositories 添加:

maven { url "https://maven.aliyun.com/repository/public" }

Spring源码编译一次性通过&遇到的坑解决方法

4.5.解决gradle build慢问题

目标文件:gradle.properties

1.增加内存分配 -- 这个按本机的内存去分配,我的是16G
org.gradle.jvmargs=-Xmx2048M

2.按需配置
org.gradle.configureondemand=true

3.开启守护进程
org.gradle.daemon=true

Spring源码编译一次性通过&遇到的坑解决方法

5.idea导入源码

依次点击File->New->Project from Existing Sources,选择源码包路径下的 build.gradle 文件完成源码导入

Spring源码编译一次性通过&遇到的坑解决方法

5.1.idea配置gradle

可以预先打开idea配置,也可在导入过程中去配置(导入后会出现一个进度条,选择backgroud后台运行)

操作路径:File->Setting->Build,Execution,Deployment->Build Tools->Gradle

Spring源码编译一次性通过&遇到的坑解决方法

5.2.导入等待&configure成功

以上设置完成后,就是等待过程了,具体多长时间看网速,我的导入编译完成耗时约11m 57s,一次性成功。

编译日志内容如下:

Starting Gradle Daemon...
Gradle Daemon started in 4 s 477 ms
> Task :buildSrc:compileJava
> Task :buildSrc:compileGroovy NO-SOURCE
> Task :buildSrc:pluginDescriptors
> Task :buildSrc:processResources
> Task :buildSrc:classes
> Task :buildSrc:jar
> Task :buildSrc:assemble
> Task :buildSrc:pluginUnderTestMetadata
> Task :buildSrc:compileTestJava NO-SOURCE
> Task :buildSrc:compileTestGroovy NO-SOURCE
> Task :buildSrc:processTestResources NO-SOURCE
> Task :buildSrc:testClasses UP-TO-DATE
> Task :buildSrc:test NO-SOURCE
> Task :buildSrc:validateTaskProperties
> Task :buildSrc:check
> Task :buildSrc:build

CONFIGURE SUCCESSFUL in 11m 57s

Spring源码编译一次性通过&遇到的坑解决方法

5.3.预编译

在idea底部菜单栏,切到Terminal菜单,输入spring-oxm的预编译命令:

gradlew :spring-oxm:compileTestJava

预编译成功,耗时约 29s:

Spring源码编译一次性通过&遇到的坑解决方法

6.测试

6.1.前置说明

在spring-context添加测试类,测试验证是否能编译通过,拿到实例的对象。

6.2.添加测试实体类

为了快速定位到,先添加测试的package: com.elephant.bean , 创建Student实体类

package com.elephant.bean;

import org.springframework.stereotype.Service;

@Service
public class Student {

	private String username = "elephant";

	private String password;

	public String getUsername() {
		return username;
	}

	public void setUsername(String username) {
		this.username = username;
	}

	public String getPassword() {
		return password;
	}

	public void setPassword(String password) {
		this.password = password;
	}
}

6.3.测试配置文件

spring-test.xml ,目录在test/resources,内容如下:

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="
	http://www.springframework.org/schema/beans
	http://www.springframework.org/schema/beans/spring-beans.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context.xsd
	">
    <context:component-scan base-package="com.elephant"/>
</beans>

6.4.添加测试类

为了快速定位到,先添加测试的package: com.elephant.test , 创建MyTest类

package com.elephant.test;

import com.elephant.bean.Student;
import org.junit.Test;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class MyTest {

	@Test
	public void test1() {
		ClassPathXmlApplicationContext applicationContext = new ClassPathXmlApplicationContext("spring-test.xml");
		Student student = (Student)applicationContext.getBean("student");
		System.out.println(student.getUsername());
		System.out.println("我获取用户名了:"+student.getUsername());
	}
}

6.5.运行测试

该类MyTest 方法 test1() 右击Run,然后等待运行结果。

Spring源码编译一次性通过&遇到的坑解决方法

6.6.运行结果

耗时约 1m 36s

预期结果:成功打印出student的userName , 结果符合预期,成功!

 

我获取用户名了:elephant
BUILD SUCCESSFUL in 1m 36s
50 actionable tasks: 26 executed, 7 from cache, 17 up-to-date
The remote build cache was disabled during the build due to errors.
18:34:24: Tasks execution finished ':spring-context:cleanTest :spring-context:test --tests "com.elephant.test.MyTest.test1"'.

Spring源码编译一次性通过&遇到的坑解决方法

Spring源码编译一次性通过&遇到的坑解决方法

 

 

上一篇:无线保镖安全图片的问题


下一篇:Android---Android Studio项目目录结构分析.