我把公司 10 年老系统改造 Maven,真香!

作者 : 开心源码 本文共4340个字,预计阅读时间需要11分钟 发布时间: 2022-05-13 共248人阅读

公司有几个老古董项目,应该是 10 年前开发的了,有一个是 JSP + Servlet,有一个还用的 SSH 框架,打包用的 Ant,是有多老啊,我想在座的各位很多都没听过吧。

为了持续集成、持续部署的需要,需要把这些老古董项目全改造成 Maven 管理,下面开搞。

快速创立一个 Maven 项目

Maven Archetype 详情

如何快速创立一个 Maven 项目,可以通过 Maven 的 Archetype 来进行创立,Archetype 是 Maven 提供的各种各样的工程模板,通过这些模板可以生成不同的 Maven 项目结构。

Maven 提供的 Archetype 列表如下:

http://maven.apache.org/archetypes/index.html

我把公司 10 年老系统改造 Maven,真香

这里我们选择 maven-archetype-quickstart 这个模板进行快速创立,由于它提供了一个标准的项目结构,基于这个基本项目结构可以进行后续扩展。

project|-- pom.xml`-- src    |-- main    |   `-- java    |       `-- $package    |           `-- App.java    `-- test        `-- java            `-- $package                `-- AppTest.java

生成 Maven 项目

1)通过 Maven 命令

Maven 提供了命令快速创立 Maven 项目:

mvn archetype:generate-DarchetypeGroupId=org.apache.maven.archetypes-DarchetypeArtifactId=maven-archetype-quickstart-DarchetypeVersion=1.4

命令中指定我们前面所说的 Maven Archetype:maven-archetype-quickstart 信息。

我把公司 10 年老系统改造 Maven,真香

运行过程中会提醒让你输入项目的 Naven 坐标信息,直到创立完成。基础部分这里不撰述了,需要完整 Maven 教程的关注公众号Java技术栈在后端回复”mvn”获取。

2)通过 IDEs

通过 IDE 也能快速创立 Maven 项目,现在 Java IDEs 都支持 Maven 或者者自带 Maven 插件,下面以 Intellij IDEA 为例进行创立。

选择 maven-archetype-quickstart:

我把公司 10 年老系统改造 Maven,真香

输入项目的 Naven 坐标信息:

我把公司 10 年老系统改造 Maven,真香

选择 Maven 及仓库设置信息:

我把公司 10 年老系统改造 Maven,真香

等待项目构建完成,如下所示:

我把公司 10 年老系统改造 Maven,真香

Maven 项目重构

Maven 项目配置

项目生成后,我们即可以把原系统的文件移到新的 Maven 项目了,因生成的项目结构比较简单,Maven 提供的 maven-archetype-webapp 模板也不符合要求:

我把公司 10 年老系统改造 Maven,真香

我们的项目性质又是后端系统,涉及到方方面面,所以还需要再完善其余资源目录的创立:

- src  - main    - java    - resources    - filters    - webapp  - test    - java    - resources

这是一个比较标准的 Maven Web 项目结构,我把它弄成了一个基础脚手架,还集成了各种现成的插件和功能,后面其余项目转 Maven 可以直接拿来套用。

已经上传到了 Github:

javastacks/maven-demo-project

主要目录结构详情:

我把公司 10 年老系统改造 Maven,真香

所有目录创立完后,再根据文件性质把原系统所有除了(*.jar)文件移到对应的目录,这里没什么难度。

配置 Maven 环境信息:

<build> <filters>  <filter>src/main/filters/filter-${env}.properties</filter> </filters> <resources>  <resource>   <directory>src/main/resources/config</directory>   <filtering>true</filtering>  </resource>  <resource>   <directory>src/main/resources/resource</directory>   <filtering>false</filtering>  </resource> </resources>  <plugins>  <plugin>   <groupId>org.apache.maven.plugins</groupId>   <artifactId>maven-compiler-plugin</artifactId>   <version>${maven-compiler-plugin.version}</version>  </plugin>  <plugin>   <groupId>org.apache.maven.plugins</groupId>   <artifactId>maven-war-plugin</artifactId>   <version>${maven-war-plugin.version}</version>   <configuration>    <failOnMissingWebXml>false</failOnMissingWebXml>   </configuration>  </plugin> </plugins></build><profiles> <profile>  <id>dev</id>  <activation>   <activeByDefault>true</activeByDefault>  </activation>  <properties>   <env>dev</env>  </properties> </profile> <profile>  <id>test</id>  <properties>   <env>test</env>  </properties> </profile> <profile>  <id>mirror</id>  <properties>   <env>mirror</env>  </properties> </profile> <profile>  <id>prod</id>  <properties>   <env>prod</env>  </properties> </profile></profiles>

Maven 依赖转换

依赖转换就是要把所有原系统的(*.jar)依赖包一律转换为 Maven 依赖管理,这里是难点,要处理编译、启动、运行时遇到的 jar 包冲突、版本冲突等异常。

我的思路是先把少量核心框架的依赖进行转换,再进行少量比较独立的公共工具包的转换,最后就是少量不熟习的依赖转换。

引入 Maven 依赖的时候,看下其所有附属的所有依赖,再逐步从 lib 目录删除,直到一律删除完成即转换完成。

在找对应依赖的时候,假如中央仓库找不到,其余远程仓库能找到的,就在公司私库中增加该包所在的远程仓库代理商配置。

假如中央仓库或者者其余远程仓库都找不到的,比方第三方的 SDK 包,就上传到公司私库。怎样上传到私库,点击这里阅读,更多 Maven 教程在公众号Java技术栈回复maven进行阅读。

根据 JAR 包 找 Maven 依赖的时候,可能有多个名称一样的依赖,不知道引用哪个,这时候需要去原始 JAR 包中看下包名,根据包名就大概知道坐标信息了。

依赖传递:

在依赖转换过程中,假如一个依赖又依赖了其余依赖,可以直接引用父依赖就可,如在老项目中存在:poi、poi-ooxm、poi-ooxml-schemas 这三个依赖:

我把公司 10 年老系统改造 Maven,真香

但在 POI 依赖体系中,poi-ooxml 包又需要依赖其余两个包,所以只要要引入 poi-ooxml 依赖就可:

<dependency>    <groupId>org.apache.poi</groupId>    <artifactId>poi-ooxml</artifactId>    <version>4.1.2</version></dependency>

这样就把这个包需要依赖的其余包都引进来了,这就是 Maven 管理依赖的好处,不会出现多包少包的情况,也能尽量避免依赖冲突。

依赖范围:

在老项目中,所有 jar 包都在 web-inf/lib 目录下,如:Servlet、JUnit,这些包在打完生产包之后也还在目录下,没有生命周期的管理。

在 Maven 中就能控制它们的生命周期:

<dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>${javax.servlet-api.version}</version> <scope>provided</scope></dependency><dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>${junit.version}</version> <scope>test</scope></dependency>

Servlet 只要要编译时用到,JUnit 只要要测试时用到,控制好每个包的依赖范围,做到每个包的作用范围最小化。

处理冲突:

当传递的依赖版本不符合,或者者是同一个包出现不同版本导致冲突的时候要学会使用排除:

我把公司 10 年老系统改造 Maven,真香

或者者强制指定包版本:

<dependency> <groupId>org.bouncycastle</groupId> <artifactId>bcprov-jdk16</artifactId> <version>${bctsp-jdk16.version}</version></dependency>

有的时候,还要根据需要使用 classifier 指定不同 JDK 的版本:

<dependency> <groupId>com.test</groupId> <artifactId>test</artifactId> <version>${test.version}</version> <classifier>JDK6</classifier></dependency>

如源代码编译报错,不知道引用的哪个 JAR 包、或者者哪个版本,可以到原始项目中点对应的类引用进去看就知道了。

整个改造过程比较顺利,就是编译和运行时需要处理少量 JAR 包冲突导致的问题,根据上面的种种方法直至编译、启动正常。

以后可以舒舒服服用 Maven 咯。

整理了半天,无私分享给大家,希望你们能有收获,觉得不错,欢迎点赞、转发哟~

说明
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » 我把公司 10 年老系统改造 Maven,真香!

发表回复