在Eclipse中创建Maven多模块工程

在平时的Javaweb项目开发中为了便于后期的维护，我们一般会进行分层开发，最常见的就是分为domain（域模型层）、dao（数据库访问层）、service（业务逻辑层）、web（表现层），这样分层之后，各个层之间的职责会比较明确，后期维护起来也相对比较容易，今天我们就是使用Maven来构建分模块项目。

在这个分模块项目中主要分为两个模块，Service模块和web模块，Service模块中包含dao，下面是项目结构

Complaints-parent
    　　　　|----pom.xml（pom）
    　　　　|----Complaints-web
        　　　　　　　　|----pom.xml (war)
    　　　　|----Complaints-service
        　　　　　　　　|----pom.xml（jar）

Complaints-parent是父工程，同时承担聚合模块和父模块的作用，没有实际代码和资源文件；

Complaints-web是web工程，最终形成最终的war包；

Complaints-service是业务模块的逻辑部分，包含了数据库访问层和业务逻辑层，但是不包括web相关的部分；

上述简单示意图中，有一个父项目(Complaints-parent)聚合很多子项目（Complaints-web，Complaints-service）。每个项目，不管是父子，都含有一个pom.xml文件。而且要注意的是，小括号中标出了每个项目的打包类型。父项目是pom,也只能是pom。子项目有jar，或者war。

依赖关系是：Complaints-web需要依赖Complaints-service

接下来就是在Eclipse中搭建项目了：

1.父项目（Complaints-parent）

在Eclipse里面New -> Maven Project；

在弹出界面中选择“Create a simple project”

父项目建好之后，目录下面只有一个src和pom.xml文件

将src文件夹删除，然后修改pom.xml文件，将<packaging>jar</packaging>修改为<packaging>pom</packaging>，

pom表示它是一个被继承的模块。（如果再创建项目时已经选为了pom就不需要修改）

以下是父项目的pom.xml的内容

[html]  view plain  copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
3.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">  
4.   <modelVersion>4.0.0</modelVersion>  
5.   <groupId>com.hrtel</groupId>  
6.   <artifactId>Complaints-parent</artifactId>  
7.   <version>0.0.1-SNAPSHOT</version>  
8.   <packaging>pom</packaging>  
9.   <name>Complaints-parent</name>  
10.   <modules>  
11.     <module>Complaints-service</module>  
12.     <module>Complaints-web</module>  
13.   </modules>  
14.     
15.   <dependencyManagement>  
16.     <dependencies>  
17.         <dependency>  
18.           <groupId>junit</groupId>  
19.           <artifactId>junit</artifactId>  
20.           <version>4.12</version>  
21.           <scope>test</scope>  
22.         </dependency>  
23.     </dependencies>  
24.   </dependencyManagement>  
25. </project>  

2.创建 Complaints -service项目

选中刚建的父项目，在弹出菜单中点击 New -> Maven Module;

使用默认的Archetype（默认：GroupId:org.apache.maven.archetypes,Artifact Id:maven-archetype-quickstart）

这样一个子项目就创建完成了，在文件系统中，子项目会建在父项目的目录中。

细心一点会发现，此时父项目的pom.xml文件中就多了一句

[html]  view plain  copy

1. <modules>  
2.     <module>Complaints-service</module>  
3.   </modules>  

3.创建web工程 Complaints -web

选中刚建的父项目，在弹出菜单中点击 New -> Maven Module;

[html]  view plain  copy

1. 创建完之后就会发现父项目的pom.xml文件中又自动多了一句  

[html]  view plain  copy

1. <modules>  
2.     <module>Complaints-service</module>  
3.     <module>Complaints-web</module>  
4.   </modules>  

4.优化配置

Complaints-web是依赖service项目的

需要在web的pom.xml中添加依赖配置

[html]  view plain  copy

1. <dependency>    
2.         <groupId>com.hrtel</groupId>    
3.         <artifactId>Complaints-service</artifactId>    
4.         <version>${project.version}</version>    
5.     </dependency>  

按上面步骤创建的子项目，在pom.xml中有个parent节点，所以，他可以继承父项目的相关信息。没错，父子项目中存在继承关系。

在子项目的pom.xml中，子项目的groupId和version一般和父项目相同，那么可以把子项目的这两个参数删除，这样会自动继承父项目的取值。

同样，如果其他的一些属性，所有子项目都是一样的，那么可以上移到父项目中设置，子项目中无需重复设置。比如：<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>可以仅在父项目中设置一次。

Manen提供 dependencyManagement 和 pluginManagement 两个标签。使用这两个标签，可以在父项目中统一管理依赖和插件的配置参数，比如版本号啥的。而在子项目中，仅需列出需要使用的依赖和插件的 groupId 和 artifactId 就可以了，其他信息会自动从父项目管理的信息里面获取。

在父项目中：

[html]  view plain  copy

1. <dependencyManagement>  
2.   <dependencies>  
3.     <dependency>  
4.         <groupId>junit</groupId>  
5.         <artifactId>junit</artifactId>  
6.         <version>${junit.version}</version>  
7.         <scope>test</scope>  
8.     </dependency>  
9.     <dependency>  
10.         <groupId>org.slf4j</groupId>  
11.         <artifactId>slf4j-log4j12</artifactId>  
12.         <version>1.7.5</version>  
13.         <scope>test</scope>  
14.     </dependency>  
15.     <dependency>  
16.         <groupId>org.slf4j</groupId>  
17.         <artifactId>slf4j-api</artifactId>  
18.         <version>1.7.5</version>  
19.     </dependency>     
20.   </dependencies></dependencyManagement>  

在子项目中

[html]  view plain  copy

1. <dependencies>  
2.   <dependency>  
3.     <groupId>junit</groupId>  
4.     <artifactId>junit</artifactId>  
5.   </dependency>  
6. </dependencies>  

由于web项目依赖service项目，子项目中只需service中添加配置，web项目会自动加载过去的

最后是打包配置：

打包时需要把service项目中的xml文件和别的property文件也打进去，就得在pom文件中说明

[html]  view plain  copy

1. <!-- 打包时把需要的xml文件一块打进去 -->  
2.   <build>    
3.         <finalName>Complaints-service</finalName>    
4.         <plugins>    
5.             <plugin>    
6.                 <groupId>org.apache.maven.plugins</groupId>    
7.                 <artifactId>maven-jar-plugin</artifactId>    
8.             </plugin>    
9.         </plugins>    
10.         <resources>    
11.             <resource>    
12.                 <directory>src/main/java</directory>    
13.                 <includes>    
14.                     <include>**/*.xml</include>    
15.                 </includes>    
16.             </resource>    
17.             <resource>    
18.                 <directory>src/main/resources</directory>    
19.                 <includes>    
20.                     <include>**/*.xml</include>    
21.                     <include>**/*.properties</include>    
22.                 </includes>    
23.             </resource>    
24.         </resources>    
25.     </build>  

一下是三个项目的pom.xml中的全部内容

Complaints-parent

[html]  view plain  copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
3.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">  
4.   <modelVersion>4.0.0</modelVersion>  
5.   <groupId>com.hrtel</groupId>  
6.   <artifactId>Complaints-parent</artifactId>  
7.   <version>0.0.1-SNAPSHOT</version>  
8.   <packaging>pom</packaging>  
9.   <name>Complaints-parent</name>  
10.   <modules>  
11.     <module>Complaints-service</module>  
12.     <module>Complaints-web</module>  
13.   </modules>  
14.     
15.   <dependencyManagement>  
16.     <dependencies>  
17.     <span style="white-space:pre">    </span><dependency>  
18.           <groupId>junit</groupId>  
19.           <artifactId>junit</artifactId>  
20.           <version>4.12</version>  
21.           <scope>test</scope>  
22.         </dependency>  
23.         <!-- spring beans -->  
24.         <dependency>  
25.             <groupId>org.springframework</groupId>  
26.             <artifactId>spring-core</artifactId>  
27.             <version>4.2.5.RELEASE</version>  
28.         </dependency>  
29.     </dependencies>  
30.   </dependencyManagement>  
31. </project>  

Complaints-service:

[html]  view plain  copy

1. <?xml version="1.0"?>  
2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
3.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">  
4.   <modelVersion>4.0.0</modelVersion>  
5.   <parent>  
6.     <groupId>com.hrtel</groupId>  
7.     <artifactId>Complaints-parent</artifactId>  
8.     <version>0.0.1-SNAPSHOT</version>  
9.   </parent>  
10.     
11.   <artifactId>Complaints-service</artifactId>  
12.   <name>Complaints-service</name>  
13.   <url>http://maven.apache.org</url>  
14.   <properties>  
15.     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
16.   </properties>  
17.   <!-- 打包时把需要的xml文件一块打进去 -->  
18.   <build>    
19.         <finalName>Complaints-service</finalName>    
20.         <plugins>    
21.             <plugin>    
22.                 <groupId>org.apache.maven.plugins</groupId>    
23.                 <artifactId>maven-jar-plugin</artifactId>    
24.             </plugin>    
25.         </plugins>    
26.         <resources>    
27.             <resource>    
28.                 <directory>src/main/java</directory>    
29.                 <includes>    
30.                     <include>**/*.xml</include>    
31.                 </includes>    
32.             </resource>    
33.             <resource>    
34.                 <directory>src/main/resources</directory>    
35.                 <includes>    
36.                     <include>**/*.xml</include>    
37.                     <include>**/*.properties</include>    
38.                 </includes>    
39.             </resource>    
40.         </resources>    
41.     </build>  
42.   <!-- 依赖配置 -->  
43.   <dependencies>  
44.     <dependency>  
45.       <groupId>junit</groupId>  
46.       <artifactId>junit</artifactId>  
47.     </dependency>  
48.     <!-- spring beans -->  
49.     <dependency>  
50.         <groupId>org.springframework</groupId>  
51.         <artifactId>spring-core</artifactId>  
52.     </dependency>  
53.   </dependencies>  
54. </project>  

Complaints-web

[html]  view plain  copy

1. <?xml version="1.0"?>  
2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">  
4.   <modelVersion>4.0.0</modelVersion>  
5.   <parent>  
6.     <groupId>com.hrtel</groupId>  
7.     <artifactId>Complaints-parent</artifactId>  
8.     <version>0.0.1-SNAPSHOT</version>  
9.   </parent>  
10.     
11.   <artifactId>Complaints-web</artifactId>  
12.   <packaging>war</packaging>  
13.   <name>Complaints-web Maven Webapp</name>  
14.   <url>http://maven.apache.org</url>  
15.   <dependencies>  
16.     <dependency>    
17.         <groupId>com.hrtel</groupId>    
18.         <artifactId>Complaints-service</artifactId>    
19.         <version>${project.version}</version>    
20.     </dependency>  
21.       
22.     <dependency>  
23.       <groupId>junit</groupId>  
24.       <artifactId>junit</artifactId>  
25.     </dependency>  
26.       
27.   </dependencies>  
28.   <build>  
29.     <finalName>Complaints-web</finalName>  
30.   </build>  
31. </project>