@[toc]
因为最近有小伙伴问到了,所以我想和大家轻易扯扯 Maven 我的项目中代码的组织模式这个问题。
其实也不是啥大问题,然而如果不懂的话,就像雾里看花,始终不能看的明明白白,懂了就像一层窗户纸,捅破就好了。
所以咱们就简略扯几句。
1. 代码组织模式
首先来说说代码组织模式。
一般来说,就两种比拟常见的模式:
- 平铺
- 父子构造
这两种模式松哥在不同的我的项目中都有遇到过,所以咱们就不说孰优孰劣,单纯来说这两种计划。
1.1 平铺
平铺的代码相似上面这样:
├── parent│ ├── pom.xml│ └── src│ ├── main│ │ ├── java│ │ └── resources│ └── test│ └── java├── vhr-dao│ ├── pom.xml│ ├── src│ │ ├── main│ │ │ ├── java│ │ │ └── resources│ │ └── test│ │ └── java└── vhr-service ├── pom.xml ├── src │ ├── main │ │ ├── java │ │ └── resources │ └── test │ └── java
如下图:
能够看到,在这种构造下,parent 父工程和各个子工程从代码组织模式上来看都是平级的,都处于同一个目录下。
不过认真查看 pom.xml 文件,还是可能清晰的看到这三个 module 的父子关系的:
parent:
<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.javaboy</groupId> <artifactId>parent</artifactId> <packaging>pom</packaging> <version>1.0-SNAPSHOT</version> <modules> <module>../vhr-dao</module> <module>../vhr-service</module> </modules></project>
能够看到,在指定 module 时,因为 vhr-dao 和 vhr-service 和 parent 的 pom.xml 不在同一个目录下,所以这里应用了相对路径,相对路径的参考根据是 parent 的 pom.xml 文件地位。
vhr-dao:
<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>parent</artifactId> <groupId>org.javaboy</groupId> <version>1.0-SNAPSHOT</version> <relativePath>../parent/pom.xml</relativePath> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>vhr-dao</artifactId></project>
能够看到,relativePath 节点中,通过相对路径指定了 parent 的 pom.xml 文件地位,这个相对路径的参考根据是子模块的 pom.xml 文件。
vhr-service:
<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>parent</artifactId> <groupId>org.javaboy</groupId> <version>1.0-SNAPSHOT</version> <relativePath>../parent/pom.xml</relativePath> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>vhr-service</artifactId></project>
这个和 vhr-dao 的差不多,不赘述。
1.2 父子构造
父子构造则相似于上面这样:
├── maven_parent│ ├── pom.xml│ ├── vhr-dao│ │ ├── pom.xml│ │ └── src│ │ ├── main│ │ │ ├── java│ │ │ └── resources│ │ └── test│ │ └── java│ └── vhr-service│ ├── pom.xml│ └── src│ ├── main│ │ ├── java│ │ └── resources│ └── test│ └── java
如下图:
这种父子构造的看起来就十分的层次分明了,parent 和各个 module 一眼就能看进去,咱们从 GitHub 上下载的很多开源我的项目如 Shiro,都是这种构造。
不过文件夹的层级并不能阐明任何问题,要害还是要看 pom.xml 中的定义,接下来咱们就来看看 parent 的 pom.xml 和各个子模块的 pom.xml 有何异同。
maven_parent:
<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.javaboy</groupId> <artifactId>maven_parent</artifactId> <packaging>pom</packaging> <version>1.0-SNAPSHOT</version> <modules> <module>vhr-dao</module> <module>vhr-service</module> </modules></project>
和后面不同的是,这里申明 modules 不须要相对路径了(其实还是相对路径,只是不须要 ../
了),因为各个子模块和 parent 的 pom.xml 文件处于同一目录下。
vhr-dao:
<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>maven_parent</artifactId> <groupId>org.javaboy</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>vhr-dao</artifactId></project>
这里也不须要通过 relativePath 节点去指定 parent 的 pom.xml 文件地位了,因为 parent 的 pom.xml 和各个子模块处于同一目录下。
vhr-service:
<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>maven_parent</artifactId> <groupId>org.javaboy</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>vhr-service</artifactId></project>
2. 打包问题
2.1 继承
有的时候,单纯只是想通过 parent 来对立治理不同的我的项目的依赖,并非一个聚合我的项目。
这个时候只须要去掉 parent 的 pom.xml 中的 modules 节点及其中的内容即可,这样就不是聚合工程了,各个子模块也能够独立打包。
2.2 聚合
当然很多状况咱们是聚合工程。
聚合工程的话,个别松哥是倡议大家从 parent 处对立进行打包:
这样能够确保打包到的是最新的代码。
当然还有另外一种操作流程:
- 首先将 parent 装置到本地仓库。
- 而后别离将 model、dao 以及 service 等模块装置到本地仓库。
- 最初 web 模块就能够独立打包了。
如果应用这种操作流程,须要留神一点,就是每个模块代码更新之后,要及时装置到本地仓库,否则当 web 模块独立打包时,用到的其余模块就不是最新的代码。
3. 小结
好啦,几个 Maven 中的小问题,窗户纸捅破了就恍然大悟啦~