Maven使用 | 多模块下的打包问题

背景1. Maven相关知识介绍

1.1 The Reactor1.2 Reactor Sorting1.3 Maven高级reactor命令1.4 总结 2. 多模块打包的正确做法

2.1 Maven生命周期2.2 第一次打包2.3 第二次打包

在实际的Java项目中，经常会见到多模块应用 (multi-module applications)，比如一个简单的基于Maven多模块项目的文件结构如下：

+- pom.xml
+- my-app
| +- pom.xml
| +- src
|   +- main
|     +- java
+- my-webapp
| +- pom.xml
| +- src
|   +- main
|     +- webapp
+- my-others
| +- pom.xml
| +- src
|   +- main
|     +- others

这个示例项目包含my-app和my-webapp两个子项目，其中my-webapp依赖于my-app，但如果我们只希望打包my-webapp这个项目，需要怎么做呢？

The mechanism in Maven that handles multi-module projects is referred to as the reactor. This part of the Maven core does the following:

Collects all the available modules to buildSorts the projects into the correct build orderBuilds the selected projects in order

Maven中处理多模块项目的机制称为Reactor。Maven 核心的这一部分执行以下操作：

收集要构建的所有可用模块将项目按正确的生成顺序排序按顺序生成选定的项目 1.2 Reactor Sorting

由于多模块构建中的模块可以相互依赖，因此反应堆必须对所有项目进行排序，以确保在需要之前构建任何项目。

对项目进行排序时，将遵循以下关系：

项目依赖于生成中的另一个模块插件声明，其中插件是构建中的另一个模块插件依赖于构建中的另一个模块生成中另一个模块上的生成扩展声明元素中声明的顺序（如果没有其他规则适用） 1.3 Maven高级reactor命令

-pl, --projects
        Build specified reactor projects instead of all projects
-am, --also-make
        If project list is specified, also build projects required by the list

因此，要想正确对某个子模块打包，就必须要使用到Maven的Reactor机制，使Maven能够正确理解子模块打包所需依赖的顺序。

package: 完成了项目编译、单元测试、打包功能，但没有把打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库和远程maven私服仓库install: 完成了项目编译、单元测试、打包功能，同时把打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库，但没有布署到远程maven私服仓库。deploy: 完成了项目编译、单元测试、打包功能，同时把打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库和远程maven私服仓库 2.2 第一次打包

需要注意的是，如果是第一次打包，则需要在最顶层目录下，对指定子模块进行打包，使用Maven命令如下所示：

mvn install -pl my-webapp -am

至于使用install或package，则取决于是否还需要进行进一步代码修改、再打包，如果需要，使用install可以将打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库 2.3 第二次打包

如果上一步已经再顶层目录下执行过install，对指定子模块的二次打包只需要在子目录下执行即可（在依赖的其他模块代码不修改的情况下），如果依赖的其他模块代码修改了，则仍需要在顶层目录下进行打包