过程说明
如果项目中使用了Spring Framework 的版本比较老(比如V3.1.1),而社区已经对对应的分支停止了维护,当遇到了新发现的安全漏洞或缺陷时,会面临面临尴尬,虽然有官方的补丁版本但和自己的版本差别太大,不能直接靠升级解决,只能自己来维护,而这一般都要被迫经历一个不熟悉的过程。
步骤
- 下载代码
一般老版本的的发布时间太久了,直接在发布区要爬很长时间的楼才(或许)可能找到对应版本。最直接的还是通过git 来获取吧。
# 下载代码
git clone https://github.com/spring-projects/spring-framework
cd spring-framework
老版本在Tag中可以找到,为了方便代码修改和变更跟踪,基于tag建立一个开发分支
# 基于tag 建立开发分支
git branch v3.1.1.dev v3.1.1.RELEASE
git checkout v3.1.1.dev
- 下载jdk及ant镜像
要核对该版本对应的JDK的版本,既然比较老的版本,可能至少是JDK6 或7, 但不要认为只要是高于指定版本的就可以编译成功,一般不是的。对于Spring-framework 3.1.x 需要JDK6的编译环境(经尝试可以用JDK7,但不能用JDK8),而3.2.x则是要JDK7的编译环境。为了避免与运行环境的不一致导致的兼容性问题,最好采用与运行环境一致的JDK版本。
为避免繁琐在本地安装多个JDK并进行环境变量的配置和切换,采用了通过docker 容器来构建的方法。
# 下载jdk6-ant镜像
docker pull nahuelolgiati/jdk6-antbuild
- 进行构建
首先启动容器,把要构建的目录挂载到容器上
# 启动容器,挂载待构建的代码目录
docker run -it --name ant6 -v ${spring-framework}:/root/spring-framework nahuelolgiati/jdk6-antbuild sh
在容器中执行构建
cd /root/spring-framework/build-spring-framework/
ant
构建后打包
ant jar package
# 之后在spring-framework/build-spring-framework/target/artifacts 下找到生成的发布包
ls artifacts/
spring-framework-3.1.1.RELEASE-dependencies.zip spring-framework-3.1.1.RELEASE.zip
spring-framework-3.1.1.RELEASE-with-docs.zip
遇到过的问题
- JDK的版本兼容
在用高版本JDK编译时会提示
The type java.lang.CharSequence cannot be resolved. It is indirectly referenced from required .class files
降级到低版本(JDK6,7)就可以了
构建时间
第一次构建做完整时间很长,之前的版本采用ivy做依赖管理,在ant逐个的项目构建中做下载,网络(或者服务器端的瓶颈)原因,8个多小时后完成了大部分的构建,但最后也出现过下载失败而导致的构建失败,多次重复执行构建后,才取得了成功。单元测试用例执行失败
在构建中会报出单元测试失败,比如
org.springframework.beans 中测试用例
standardReadMethodsAndOverloadedNonStandardWriteMethods
readMethodReturnsSubtypeOfWriteMethodParameter
执行失败
v3.1.1.RELEASE在JDK7(ryanmehta/jdk7-ant)中执行单元测试会遇到,但在JDK6中这两个单元测试用例是可以通过的。
因为test是依赖于jar 任务的,也就是说jar都已经生成了。可以通过执行ant jar package 避开单元测试。
- 重复执行ant Jar失败
在重复执行ant jar时,会报如下的错误
/root/spring-framework/spring-build/multi-bundle/artifact.xml:60: The following error occurred while executing this line:
/root/spring-framework/spring-build/multi-bundle/common.xml:86: The following error occurred while executing this line:
/root/spring-framework/spring-build/resource/artifact.xml:35: impossible to publish artifacts for org.springframework#org.springframework.spring-parent;working@7e524d04e96d: java.io.IOException: file copy not done from /root/spring-framework/org.springframework.spring-parent/target/artifacts/ivy.xml to /root/spring-framework/org.springframework.spring-parent/../integration-repo/org.springframework/org.springframework.spring-parent/3.1.1.RELEASE/ivy-3.1.1.RELEASE.xml: destination already exists and overwrite is false
at org.apache.ivy.plugins.repository.file.FileRepository.copy(FileRepository.java:78)
at org.apache.ivy.plugins.repository.file.FileRepository.put(FileRepository.java:58)
...
可通过执行clean-integration 或手工删除integration-repo目录排除
ant clean-integration jar
[前一篇]对Spring framwrok 3.1.1 修复RDF缺陷(CVE-2015-5211及CVE-2020-5421)的全过程