maven多模块创建-简介(1)
1.简介Maven多模块项目,适用于一些比较大的项目,通过合理的模块拆分,实现代码的复用,便于维护和管理。尤其是一些开源框架,也是采用多模块的方式,提供插件集成,用户可以根据需要配置指定的模块。2.说明模块说明每个模块都对应着一个pom.xml。它们之间通过继承和聚合(也称作多模块,multi- module)相互关联。父项目聚合很多子项目(util, dao, service,web
1.简介
Maven多模块项目,适用于一些比较大的项目,通过合理的模块拆分,实现代码的复用,便于维护和管理。尤其是一些开源框架,也是采用多模块的方式,提供插件集成,用户可以根据需要配置指定的模块。
2.说明
- 模块说明
每个模块都对应着一个pom.xml。它们之间通过继承和聚合(也称作多模块,multi- module)相互关联。
父项目聚合很多子项目(util, dao, service,web)。每个项目,不管是父子,都含有一个pom.xml文件。而且要注意的是,小括号中标出了每个项目的打包类型。父项目是pom,也只能是pom。子项目有jar,或者war。根据它包含的内容具体考虑。
- 模块依赖关系
dao –> util
service –> dao
web –> service
注意依赖的传递性(大部分情况是传递的,除非你配置了特殊的依赖scope),dao依赖于util,service依赖 于dao,于是service也依赖于util。同理,web依赖于dao,util。
- pom依赖说明
POM配置细节,实际上非常简单,先看**parent的pom.xml:
Xml代码
<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/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>appname</groupId>
<artifactId>**parent</artifactId>
<packaging>pom</packaging>
<version>1.0-SNAPSHOT</version>
<modules>
<module>**util</module>
<module>**dao</module>
<module>**service</module>
<module>**web</module>
</modules>
</project>
Maven的坐标GAV(groupId, artifactId, version)在这里进行配置,这些都是必须的。特殊的地方在于,这里的packaging为pom。所有带有子模块的项目的packaging都为 pom。packaging如果不进行配置,它的默认值是jar,代表Maven会将项目打成一个jar包。
该配置重要的地方在于modules,例子中包含的子模块有**util, **dao, **service, **web。在Maven build **parent的时候,它会根据子模块的相互依赖关系整理一个build顺序,然后依次build。
这就是一个父模块大概需要的配置,接下来看一下子模块符合配置继承父模块。
Xml代码
<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/maven-v4_0_0.xsd">
<parent>
<artifactId>**parent</artifactId>
<groupId>appname</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>**util</artifactId>
<dependencies>
<dependency>
<groupId>commons-lang</groupId>
<artifactId>commons-lang</artifactId>
<version>2.4</version>
</dependency>
</dependencies>
</project>
**util模块继承了**parent父模块,因此这个POM的一开始就声明了对**parent的引用,该引用是通过Maven坐 标GAV实现的。而关于项目**util本身,它却没有声明完整GAV,这里我们只看到了artifactId。这个POM并没有错,groupId 和version默认从父模块继承了。实际上子模块从父模块继承一切东西,包括依赖,插件配置等等。
此外**util配置了一个对于commons-lang的简单依赖,这是最简单的依赖配置形式。大部分情况,也是通过GAV引用的。
再看一下**dao,它也是继承于**parent,同时依赖于**util:
Xml代码
<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/maven-v4_0_0.xsd">
<parent>
<artifactId>**parent</artifactId>
<groupId>appname</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>**dao</artifactId>
<dependencies>
<dependency>
<groupId>appname</groupId>
<artifactId>**util</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
</project>
该配置和util的配置几乎没什么差别,不同的地方在于,依赖变化了,**dao依赖于**util。这里要注意的是 version的值为${project.version},这个值是一个属性引用,指向了POM的project/version的值,也就是这个 POM对应的version。由于**dao的version继承于**parent,因此它的值就是1.0-SNAPSHOT。而 util也继承了这个值,因此在所有这些项目中,我们做到了保持版本一致。
这里还需要注意的是,**dao依赖于**util,而**util又依赖于commons-lang,根据传递性,**dao也拥有了对于commons-lang的依赖。
**service我们跳过不谈,它依赖于**dao。我们最后看一下**web:
Xml代码
<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/maven-v4_0_0.xsd">
<parent>
<artifactId>**parent</artifactId>
<groupId>appname</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>**web</artifactId>
<packaging>war</packaging>
<dependencies>
<dependency>
<groupId>appname</groupId>
<artifactId>**service</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
</project>
**web依赖于**service,因此配置了对其的依赖。
由于**web是我们最终要部署的应用,因此它的packaging是war。为此,你需要有一个目录src/main/webapp。并在这 个目录下拥有web应用需要的文件,如/WEB-INF/web.xml。没有web.xml,Maven会报告build失败,此外你可能还会有这样一 些子目录:/js, /img, /css … 。
看看Maven是如何build整个项目的,我们在 **parent 根目录中运行 mvn clean install 即可。
整个项目根据我们希望的顺序进行build。Maven根据我们的依赖配置,智能的安排了顺序,**util, **dao, **service, **web。
最后,你可以在 **web/target 目录下找到文件 **web-1.0-SNAPSHOT.war ,打开这个war包,在 /WEB-INF/lib 目录看到了 commons-lang-2.4.jar,以及对应的**util, **dao, **service 的jar包。Maven自动帮你处理了打包的事情,并且根据你的依赖配置帮你引入了相应的jar文件。
使用多模块的Maven配置,可以帮助项目划分模块,鼓励重用,防止POM变得过于庞大,方便某个模块的构建,而不用每次都构建整个项目,并且使得针对某个模块的特殊控制更为方便。
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)