maven多模块创建-简介(1)

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变得过于庞大，方便某个模块的构建，而不用每次都构建整个项目，并且使得针对某个模块的特殊控制更为方便。