Spring5.x源码编译及导入IDEA全过程及踩坑记录

2024-05-25 19:08
文章标签 java 编译 源码 idea 记录 spring 导入 spring5 全过程

本文主要是介绍Spring5.x源码编译及导入IDEA全过程及踩坑记录，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

      • 1.写在前面
      • 2.编译前需要准备的环境和工具。
      • 3.具体步骤
      • 4.总结

1.写在前面

Spring作为风靡世界的优秀框架，很早就想研究研究Spring源码了。最近亲手搭建了Spring环境，从下载源码到编译到改动源码测试demo跑通，有些踩坑和心得需要记录一下，也与大家分享一下。
注：笔者在2台不同电脑上均告成功，但是也不敢保证各位看官一定能成功，如果失败请轻拍砖。不过相信对各位编译Spring还是有一定帮助的，废话不多说，Let’s Go Go Go!

2.编译前需要准备的环境和工具。

  • 操作系统：俺是在Win10上编译的
  • Java环境：1.8.0_151
    注意：有网友说JDK版本不能过高，比如jdk1.8_20和jdk1.8_191，因此当遇到一堆 0x000000: xxxxxxxx 之类的错误时，请留意你的JDK版本。
  • 源码下载：讲真，想在GitHub上下载，太难了，笔者试了若干次没有成功。逼不得已，去码云上下载的。如果看官也被逼上"码云"，请注意，在搜索框输入：Spring-Framework，然后请选择这个库：

码云极速下载 / Spring-Framework

，然后挑选需要的源码。笔者选择的是：v5.0.0.RELEASE，然后通过zip方式下载的。

  • Gradle：Spring是通过Gradle构建的，因此需要下载安装一个Gradle。很简单，下载解压，配置环境变量即可。
  • idea：笔者使用的2019 1.1版本

3.具体步骤

  1. 相信你已经安装好了JDK，idea，让我们往下。

  2. 将下载好的源码包放到一个单独目录，解压之。根目录下留心下面几个文件。

    • build.gradle ：这是和Spring构建有关的文件，后面会有所修改。
    • import-into-idea.md ：这是关于导入idea的一个说明文件。里面有关于导入idea的信息，这是我们需要的，里面有个命令马上就会用到。

  3. 在 import-into-idea.md文件中，有这么一句话

    Precompile spring-oxm with ./gradlew :spring-oxm:compileTestJava

    说得很清楚，需要预先编译spring-oxm模块，使用gradlew :spring-oxm:compileTestJava这个命令。好照着做。但是等等，1号坑出现，如果不想编译后出现类似这样的错误

    Could not open/create prefs root node Software\JavaSoft\Prefs at root 0x80000002

    那么一定要在 管理员窗口 中执行gradlew :spring-oxm:compileTestJava命令。如下：
    在这里插入图片描述

  4. 执行命令后，从上面图片中可以得到4个信息：

    • 其一：会自动下载gradle-4.1-bin.zip，笔者曾试过，就算本机安装有一个gradle，配置好环境变量，这里spring也会去下载一个。不知道是正常还是不正常。但是你还是应该去gradle官网下载一个gradle，因为待会儿导入idea要用，不建议用idea自带的。
    • 其二：注意2号坑出现，你下载安装的gradle版本不能太高，过高的话，导入idea后，会出现各种头疼的问题导致你心态炸裂。那么下载什么版本呢？其实spring已经告诉你了，去下载一个和他自动安装的那个版本就好了。而且v5.0.0.RELEASE对应的gradle版本是gradle-4.1，其他的可不一定，以spring自己打印出来的版本为准。
    • 其三：spring会自己去下载一些包来支撑构建，而从上面图片来看，下载地址是https://repo.spring.io/plugins-release。一般说来速度不会很慢，但是如果速度慢怎么办？拿鞭子抽它，让它加速。下面第5步，是可选步骤，如果很慢的话，可以按照第5步操作，如果不慢，就跳过。一般说来，这一步预编译步骤，不应该超过10分钟。
    • 其四：编译的时候，有个进度条，和打印一些信息的东西，有时候界面会看似卡死不动，其实是在正常进行的，敲一下回车，就可以看到了，不会打断编译过程的，放心敲。

  5. 【可选步骤】加速编译spring-oxm模块。原理就是添加一个阿里云镜像。如果你发现下载速度很慢，Ctrl + C退出编译，然后在spring源码包下，打开build.gradle文件，像下图一样，将红框中的部分添加到文件中。
    在这里插入图片描述

    注意点：

    1. 绿色框中的是文件本来就有的，不要删掉它，因为有些插件包，阿里云并没有同步完全，如果删掉，很可能下载不下来而导致失败。另外它的顺序应该如图一样，排在最后。
      2.allprojects那个框，也保持如图中的位置，不要移动到plugins上面。

    再一次执行gradlew :spring-oxm:compileTestJava命令。注意在管理员窗口执行。

  6. 稍等一会儿，不管有没有执行第5步，你应该都可以得到一个编译成功的结果。如下：
    在这里插入图片描述
    只不过进了第5步的话，应该还是会快点，在笔者的后面几次实验中，只用了2分半钟。
    另外，预编译成功后，可以打开源码包看看，其实有些核心模块，比如core，context，已经编译出jar包了，但是像jdbc等模块，是没有的，因此可以导入idea来继续编译，不过应该是可以继续在管理员窗口编译的，有兴趣的可以自行尝试。

  7. 导入idea之前，核实一下是否按照第4步中，安装好了gradle，如果是，需要配置一下继续go go go

  8. 打开idea，在WelCome页面，点击open，选择编译好的Spring源码根目录，自动弹出如下gradle项目向导，按下图配置即可。ps：如果没有，请核实自己的idea是否安装了gradle插件。
    在这里插入图片描述

  9. 点击OK，idea会自动构建环境，下载包等，此时等待。如果按照上面的步骤来，此处应该是能成功的。不然很多坑就会在这里应验 ^ _ ^。
    在这里插入图片描述

  10. 等到IDEA构建好之后，出现如上图的几个绿条。那么就可以打开右侧Gradle面板，进行编译了。如图：
    在这里插入图片描述

    • 可以选择点击1号框，手动输入命令编译
    • 也可以双击2号框，直接编译。

  11. 但是注意，3号坑出现。此坑说来话长，但是不得不说。Spring源码有当前master分支，和历史各个分支，还有RELEASE版本。如果你是选择clone master分支来编译，那么是不会编译生成文档包和源码包的。如果是历史分支，Release版本，则会做这些事情，比如笔者目前选择的v5.0.0.RELEASE版本。但是，在Win10系统上，编译生成文档包，会遇到一些非常棘手的事情，如果你尝试这样编译了，会发现控制台打印出一些???和乱码，并且最后编译失败(其实也不算失败，文档失败了而已)得到类似这样的错

    Execution failed for task ‘:asciidoctor’.
    …
    (SystemCallError) Unknown error 123 - FindFirstFile

    这个错是因为Win10路径的一些兼容问题，很难解决，如果只是为了阅读源码，没有必要在这个问题纠结。如果是正式的用途，那可以到Linux环境进行编译。
    那么我们的解决方式就是：跳过文档源码包编译
    找到如下2个地方，注释掉（另外看官们可以去GitHub上瞧瞧，master分支上没有下面2个东西，所以编译master分支时不会遇到3号坑，但编译Release版本，则会遇到）：
    在这里插入图片描述在这里插入图片描述

  12. 现在又可以双击build进行编译了，不会出现刚刚一堆红色???了，但是世界似乎仍不安静，控制台在打印一些白色FAILED。这是因为编译测试程序出了问题。这里笔者曾经尝试解决，但是当解决了一个模块后，另一个模块的测试又会出问题，时间有限，这里只给出解决思路和1个例子。
    在测试程序失败后，会出具一份Report，在控制台可以看到连接，可以复制出来在浏览器打开，可以看到报错信息，哪些类失败等。
    比如这个问题：

     Execution failed for spring ':spring-webflux:test'

    解决办法是：将

    compile"com.fasterxml.jackson.module:jackson-module-kotlin:2.9.0"

    放入spring-webflux的gradle dependencies 节点中。

    由于笔者只是研究一下Spring源码，于是选择跳过测试程序，有兴趣的可继续自行解决。进行下一步

  13. 跳过测试。点击第10步1号框，手动输入下面命令来跳过测试执行编译。

    build -x test

    这样只编译源码，就很快了，快的几十秒，慢点几分钟就打完收工。
    在这里插入图片描述

  14. 编译完毕，下一步就是新建一个模块来测试一下啦。

    1. new -> module -> gradle -> next -> 输入artifactID -> 确定
    2. 向自动生成的gradle文件的dependencies中添加一行：compile(project(’:spring-context’))
    3. 新建测试类
     public class HelloSpring {public void say(){System.out.println("hello spring");}
}

    public class TestClient {public static void main(String[] args) {AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext();context.refresh();context.register(HelloSpring.class);HelloSpring helloSpring = (HelloSpring)context.getBean("helloSpring");helloSpring.say();}
}

  15. 点击运行。nice，4号坑出现。应该会得到下面一个错误

        Error:(26, 38) java: 找不到符号符号:   类 InstrumentationSavingAgent位置: 程序包 org.springframework.instrument

    解决办法是：将下图本来为optional的，改为compile
    在这里插入图片描述

  16. 再次点击运行，运行成功。v5.0.0.RELEASE版本编译到此结束。
    在这里插入图片描述

  17. 都运行成功了，为什么还有下一点呢？因为还有5号坑，但是此坑在编译v5.0.0.RELEASE版本的时候，并没有出现。而出现在了编译master分支上，目前master版本是5.2.2，当运行测试程序的时候，很可能得到这个错误：

    Error:(347, 51) java: 找不到符号符号:   变量 CoroutinesUtils位置: 类 org.springframework.core.ReactiveAdapterRegistry.CoroutinesRegistrar

    这是因为有个包，spring没有帮你打进去，需要自己添加，如下操作：

    1. 找到Spring-core模块，右键新建一个lib文件夹
    2. 按照如下图所示，将包复制过去
      在这里插入图片描述
    3. 打开spring-core.gradle文件，将compile fileTree(dir:'lib',includes:['*jar']) 添加到dependencies，如下图
      在这里插入图片描述
      然后idea触发自动编译。编译好后，运行测试程序，问题解决。

4.总结

以上都是

这篇关于Spring5.x源码编译及导入IDEA全过程及踩坑记录的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1002373。

相关文章

JVM 的类初始化机制

JVM 的类初始化机制

前言 当你在 Java 程序中new对象时，有没有考虑过 JVM 是如何把静态的字节码（byte code）转化为运行时对象的呢，这个问题看似简单，但清楚的同学相信也不会太多，这篇文章首先介绍 JVM 类初始化的机制，然后给出几个易出错的实例来分析，帮助大家更好理解这个知识点。 JVM 将字节码转化为运行时对象分为三个阶段，分别是：loading 、Linking、initialization
阅读更多...
Spring Security 基于表达式的权限控制

Spring Security 基于表达式的权限控制

前言 spring security 3.0已经可以使用spring el表达式来控制授权，允许在表达式中使用复杂的布尔逻辑来控制访问的权限。 常见的表达式 Spring Security可用表达式对象的基类是SecurityExpressionRoot。 表达式描述hasRole([role])用户拥有制定的角色时返回true （Spring security默认会带有ROLE_前缀）,去
阅读更多...
浅析Spring Security认证过程

浅析Spring Security认证过程

类图 为了方便理解Spring Security认证流程，特意画了如下的类图，包含相关的核心认证类 概述 核心验证器 AuthenticationManager 该对象提供了认证方法的入口，接收一个Authentiaton对象作为参数; public interface AuthenticationManager {Authentication authenticate(Authenti
阅读更多...
Spring Security--Architecture Overview

Spring Security--Architecture Overview

1 核心组件 这一节主要介绍一些在Spring Security中常见且核心的Java类，它们之间的依赖，构建起了整个框架。想要理解整个架构，最起码得对这些类眼熟。 1.1 SecurityContextHolder SecurityContextHolder用于存储安全上下文（security context）的信息。当前操作的用户是谁，该用户是否已经被认证，他拥有哪些角色权限…这些都被保
阅读更多...
Spring Security基于数据库验证流程详解

Spring Security基于数据库验证流程详解

Spring Security 校验流程图 相关解释说明（认真看哦） AbstractAuthenticationProcessingFilter 抽象类 /*** 调用 #requiresAuthentication(HttpServletRequest, HttpServletResponse) 决定是否需要进行验证操作。* 如果需要验证，则会调用 #attemptAuthentica
阅读更多...
Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
Java架构师知识体认识

Java架构师知识体认识

源码分析 常用设计模式 Proxy代理模式Factory工厂模式Singleton单例模式Delegate委派模式Strategy策略模式Prototype原型模式Template模板模式 Spring5 beans 接口实例化代理Bean操作 Context Ioc容器设计原理及高级特性Aop设计原理Factorybean与Beanfactory Transaction 声明式事物
阅读更多...
python: 多模块(.py)中全局变量的导入

python: 多模块(.py)中全局变量的导入

文章目录 global关键字可变类型和不可变类型数据的内存地址单模块(单个py文件)的全局变量示例总结 多模块(多个py文件)的全局变量from x import x导入全局变量示例 import x导入全局变量示例 总结 global关键字 global 的作用范围是模块(.py)级别： 当你在一个模块（文件）中使用 global 声明变量时，这个变量只在该模块的全局命名空
阅读更多...
Java进阶13讲__第12讲_1/2

Java进阶13讲__第12讲_1/2

多线程、线程池 1.  线程概念 1.1  什么是线程 1.2  线程的好处 2.   创建线程的三种方式 注意事项 2.1  继承Thread类 2.1.1 认识  2.1.2  编码实现  package cn.hdc.oop10.Thread;import org.slf4j.Logger;import org.slf4j.LoggerFactory
阅读更多...
JAVA智听未来一站式有声阅读平台听书系统小程序源码

JAVA智听未来一站式有声阅读平台听书系统小程序源码

智听未来，一站式有声阅读平台听书系统 🌟 开篇：遇见未来，从“智听”开始 在这个快节奏的时代，你是否渴望在忙碌的间隙，找到一片属于自己的宁静角落？是否梦想着能随时随地，沉浸在知识的海洋，或是故事的奇幻世界里？今天，就让我带你一起探索“智听未来”——这一站式有声阅读平台听书系统，它正悄悄改变着我们的阅读方式，让未来触手可及！ 📚 第一站：海量资源，应有尽有 走进“智听
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2