Spring 的源码已经从 svn 迁移到 GitHub。而且也改为基于 Gradle 的构建来构建项目。它取代了之前的 Ant+Ivy 系统,所以要构建 Spring 源码环境首先要安装 GitHub 以及 Gradle。
Windows 系统对应的 GitHub 版本下载地址为: https://desktop.github.com/ 。如图所示:
下载、安装,开始菜单上 GitHub 菜单,如图:
Gradle 是一个基于 Groovy 的构建工具,它使用 Groovy 来编写构建脚本,支持依赖管理和多项目创建,类似 Maven,但比其更加简单轻便。
Gradle 为 Ivy 提供了一个 layer,提供了 build-by-convention 集成,而且他还让你获得许多类似 Maven 的功能。
Gradle 的下载地址是:http://www.gradle.org/downloads 作为初学者建议选择包含文档和样例源码的压缩文件较好,将下载文件解压。如果你下载的是gradle-xx-all.zip的完整包,它会有以下内容:二进制文件用户手册(包括PDF和HTML两种版本),DSL参考指南,API手册(包括Javadoc和Groovydoc),样例源代码,仅供参考使用。
在windows中的Gradle配置:在环境变量对话框中,定义环境变量GRADLE_HOME到你的gradle根目录当中,然后修改环境变量 Path,即追加 %GRADLE_HOME%\BIN;(linux或mac的是$GRADLE_HOME/bin)。
配置完成之后,当完成系统变量的配置后打开命令窗口输入命令 " gradle -version ",如果出现Gradle对应的版本信息,表示安装成功。
下载地址:https://github.com/SpringSource/spring-framework/tags/
选择需要的版本下载zip即可。
下载地址:https://github.com/SpringSource/spring-framework/tags/
Window-->Open Perspective -->SVN资源库研究把源码用svn checkout到本地磁盘
单击快捷菜单中的 Git Shell 选项,打开 GitHub 后,可以通过 cd 命令将当前操作目录转换到我们想要存储源码的目录。
例如:e:\test ,执行命令 cd e:\test
输入以下命令:
git clone git://github.com/SpringSource/Spring-framework.git
其中,git://github.com/SpringSource/Spring-framework.git 为Spring的源码地址。执行命令后便进入源码下载状态。
经过一段时间的等待后源码下载结束,窗口状态如下图
而这时,对应的文件夹下已经存在相应的源码信息,如下图所示。
使用gradle构建项目
当前的源码并不可以直接导入 Eclipse 中,我们还需要将源码转换为 Eclipse 可以读取的形式。
可以只对感兴趣的工程进行 Eclipse 工程转换,比如我们想要查看 Spring 事务部分的源码,打开命令窗口,将当前目录切换至源码所在目录,这里是 Spring-tx文件夹下,执行命令 gradle cleanidea eclipse 。当窗口出现如下状态说明已经开始执行转换过程,如下图:
经过一段时间后转换成功,如下图所示、
这时,我们再查看对应的文件夹会发现,已经出现了作为 Eclipse 工程所必须的 .project 和 .classpath 文件了,如下图所示
没有编译过的
打开 Eclipse,将工程导入,导入后目录结构如下图
你会发现工程名称前面有一个感叹号,这说明项目存在错误。查看依赖及工程,会看到当前工程所依赖的包出现问题。如下图
但是,查看依赖的 Projects 时发现
依赖的项目出现问题,只需要把需要的几个项目编译之后导入就可以了。
依赖的包出现问题,后边解决。
可以将所有工程一次性的编译、导入。但是不推荐这样的方式,这样会耗费大量的时间,而且当存在编译错误的时候,你不得不重新编译。
pring-framework目录里面有一个gradlew.bat批处理文件,双击出现控制台界面,连续按两次回车键,下载各种依赖jar包和dom文件,公司外网不好,用了几个小时,没下下来,这就尴尬了。
spring-framework目录里面有一个import-into-eclipse.bat批处理文件,双击出现控制台界面,连续按两次回车键,就可以开始自动构建了,构建过程需要花很长时间(如有没有提前执行gradlew.bat,这里就会下载各种依赖jar包和dom文件)。
中间还经常出现停止不动的情况,按Ctrl+c终止运行,再一次双击import-into-eclipse.bat文件重复上述过程即可(会接着上次构建的位置继续构建),到构建完成后控制台会自动关闭。
最后删除spring-framework下的setting文件夹和project文件,否则eclipse只能导入整体,不能导入每个工程。
暂时遇到:缺失spring-cglib-repack-3.2.4.jar和spring-objenesis-repack-2.4.jar。
虽然可能从网上下载到这个2个包,但是,由于版本问题,还是不能使用。最好的解决办法就是从源码里边将需要的包提取出来
下载对应版本的dist.zip文件来提取需要的jar包(distribution,发布用的版本)访问地址:http://repo.springsource.org/libs-release-local/org/springframework/spring/ (可能会很慢)
解压spring-framework-4.3.0.RELEASE-dist\spring-framework-4.3.0.RELEASE\libs目录下的spring-core-4.3.0.RELEASE.jar文件
在cmd命令窗口下切换到上一步的目录下,
使用jar命令生成需要的jar文件 :
spring-cglib-repack-3.2.4.jar
命令:jar cvf spring-cglib-repack-3.2.4.jar org\springframework\cglib
spring-objenesis-repack-2.4.jar
命令:jar cvf spring-objenesis-repack-2.4.jar org\springframework\cglib
查看当前目录E:\spring\code\spring-framework-4.3.0.RELEASE-dist\spring-framework-4.3.0.RELEASE\libs\spring-core-4.3.0.RELEASE下确实生成了需要的jar文件
验证一下生成的jar包的目录结构是否正确(因为第一次操作的时候不注意,导致虽然包打好了,但是目录结构不对,最终不能使用)
如果eclipse没有安装groovy插件,则spring-beans-groovy包中的GroovyBeanDefinitionReader.java会报错,因为eclipse不能编译groovy脚本。
报错信息:
Description Resource Path Location Type
GroovyDynamicElementReader cannot be resolved to a type
GroovyBeanDefinitionReader.java /spring-beans-groovy/src/main/java/org/springframework/beans/factory/groovy line 391 Java Problem
Groovy 下载地址:http://groovy-lang.org/download.html
step 1:检查自己的eclipse版本:在help->About Eclipse中查看:
step 2:进入 https://github.com/groovy/groovy-eclipse/wiki查找和自己eclipse对应版本的groovy:
step 3:拷贝下载地址http://dist.springsource.org/snapshot/GRECLIPSE/e4.6/
step 4:打开eclipse,在eclipse中,选择help -> Install New Software…:
step 5:选择add,对话框中name随便写,地址将上面拷贝的地址粘贴进去:
step 6:等待一小会,会出现如下选项,全选后下一步:
重启eclipse,然后clean一下项目就搞定了。
Spring环境搭建--Spring源码深度解析:
http://www.cnblogs.com/chuzh/p/4996976.html
Spring官网下载dist.zip的几种方法:
http://www.cnblogs.com/yjmyzz/p/3847364.html
spring源码构建时缺失spring-cglib-repack-3.2.4.jar和spring-objenesis-repack-2.4.jar:
http://www.itdadao.com/articles/c15a711547p0.html
spring源码gradle获得eclipse工程时,spring-beans-groovy项目GroovyDynamicElementReader报错解决
http://blog.csdn.net/smithdoudou88/article/details/46356305