Maven构建多模块项目

摘要：本文要用Maven来构建一个多模块的web项目   出处http://blog.csdn.net/evankaka

项目结构如下：

　　system-parent
    　　　　|----pom.xml
    　　　　|----system-domain
        　　　　　　　　|----pom.xml
    　　　　|----system-dao
        　　　　　　　　|----pom.xml
    　　　　|----system-service
        　　　　　　　　|----pom.xml
    　　　　|----system-web
        　　　　　　　　|----pom.xml

一、创建system-parent项目

　　创建system-parent，用来给各个子模块继承

勾选create a simple...

注意要选pom

创建好的结构如下，把src文件删除掉

二、创建sytem-domain模块

项目右键-》new->other

注意选择maven module

packageing,选择jar，因为这是要打包成jar给别的模块用的

子模块添加好后如下

打开system-domain项目pom.xml文件，改成如下

[html] view plain copy

1. <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">  
2.   <modelVersion>4.0.0</modelVersion>  
3.     <parent>  
4.         <groupId>com.mucfc</groupId>  
5.         <artifactId>system-parent</artifactId>  
6.         <version>0.0.1-SNAPSHOT</version>  
7.     </parent>  
8.       
9.     <artifactId>system-domain</artifactId>  
10.     <packaging>jar</packaging>  
11.       
12.     <name>system-domain</name>  
13.     <url>http://maven.apache.org</url>  
14. </project>  

此时system-parent应该有这么一句

[html] view plain copy

1. <modules>  
2.     <module>system-domain</module>  
3. </modules>  

表明子模块添加成功

三、创建system-dao模块

步骤和2一样，命名不同

然后把再打开system-dao的项目下的pom文件，修改成如下：

[html] view plain copy

1. <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">  
2.   <modelVersion>4.0.0</modelVersion>  
3.     <parent>  
4.         <groupId>com.mucfc</groupId>  
5.         <artifactId>system-parent</artifactId>  
6.         <version>0.0.1-SNAPSHOT</version>  
7.     </parent>  
8.     <artifactId>system-dao</artifactId>  
9.     <packaging>jar</packaging>  
10.   
11.     <name>system-dao</name>  
12.     <url>http://maven.apache.org</url>  
13.     <dependencies>  
14.     <!--system-dao需要使用到system-domain中的类，所以需要添加对system-domain模块的依赖-->  
15.     <dependency>  
16.         <groupId>com.mucfc</groupId>  
17.         <artifactId>system-domain</artifactId>  
18.          <version>${project.version}</version>  
19.     </dependency>  
20.  </dependencies>  
21. </project>  

四、创建system-service模块

步骤和2一样，命名不同

然后把再打开system-service的项目下的pom文件，修改成如下：

[html] view plain copy

1. <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">  
2.   <modelVersion>4.0.0</modelVersion>  
3.     <parent>  
4.         <groupId>com.mucfc</groupId>  
5.         <artifactId>system-parent</artifactId>  
6.         <version>0.0.1-SNAPSHOT</version>  
7.     </parent>  
8.       
9.     <artifactId>system-service</artifactId>  
10.     <packaging>jar</packaging>  
11.   
12.     <name>system-service</name>  
13.     <url>http://maven.apache.org</url>  
14.   
15.     <dependencies>  
16.         <!--system-service依赖system-dao和system-domain但是我们只需添加system-dao的依赖即可，因为system-dao已经依赖了system-domain -->  
17.         <dependency>  
18.             <groupId>com.mucfc</groupId>  
19.             <artifactId>system-dao</artifactId>  
20.             <version>${project.version}</version>  
21.         </dependency>  
22.     </dependencies>  
23. </project>  

五、创建system-web模块

web项目要打包成war文件，所以有个地方要改下

这里记得要选war文件

把pom文件改成如下：

[html] view plain copy

1. <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">  
2.   <modelVersion>4.0.0</modelVersion>  
3.     <parent>  
4.         <groupId>com.mucfc</groupId>  
5.         <artifactId>system-parent</artifactId>  
6.         <version>0.0.1-SNAPSHOT</version>  
7.     </parent>  
8.       
9.     <artifactId>system-web</artifactId>  
10.     <packaging>war</packaging>  
11.   
12.     <name>system-web</name>  
13.     <url>http://maven.apache.org</url>  
14.   
15.     <dependencies>  
16.         <dependency>  
17.             <groupId>com.mucfc</groupId>  
18.             <artifactId>system-service</artifactId>  
19.             <version>${project.version}</version>  
20.         </dependency>  
21.     </dependencies>  
22. </project>  

然后自己在在\system-web\src\main\webapp目录中添加一个index.jsp

六、整体目录如下
                                                                                      

六、编译运行项目

　　经过上面的五个步骤，相关的模块全部创建完成，怎么运行起来呢

Maven Tomcat7自动部署：

1、配置tomcat-users.xml文件

在tomcat安装目录下找到tomcat-users.xml文件。该文件路径为【tomcat安装根目录】/conf/

修改文件内容，增加下列内容：

[html] view plain copy

1. <tomcat-users>  
2. <role rolename="manager"/>  
3. <role rolename="admin"/>  
4. <role rolename="manager-gui"/>  
5.  <role rolename="manager-script"/>  
6. <user username = "admin" password = "password" roles = "admin,manager,manager-gui,manager-script" />  
7. </tomcat-users>  

启动tomcat7，然后访问 http://localhost:8080/manager/html，输入admin/password，如果出现以下界面，表示tomcat一切OK

如果是Tomcat6 http://localhost:8080/manager

2、配置maven 的setting.xml 文件

在Maven的conf目录中的setting.xml servers节点增加

[html] view plain copy

1. <server>  
2.  <id>tomcat7</id>  
3.  <username>admin</username>  
4.  <password>password</password>  
5. </server>  

3、配置项目pom.xml文件

[html] view plain copy

1. <plugin>  
2.     <groupId>org.codehaus.mojo</groupId>  
3.     <artifactId>tomcat-maven-plugin</artifactId>  
4.     <version>1.1</version>  
5.     <configuration>  
6.         <url>http://localhost:8080/manager/text</url>  
7.         <server>tomcat7</server>  
8.         <username>admin</username>  
9.         <password>password</password>  
10.         <ignorePackaging>true</ignorePackaging>    
11.     </configuration>  
12. </plugin>  

注:此处的url 注意是xxx/manager/text 并非是 xxx/manager/html 原因是我用的tomcat 是tomcat7 的版本
4、cmd运行

先进入到项目所在的目录，然后运行

[html] view plain copy

1. mvn tomcat:redeploy  

最终结果：

其中只有system-web是web项目，其它都不是，只是一些依赖项目

在目录D:\Java\Tool\apache-tomcat-7.0.62\webapps可以找到发布好的文件

浏览器输入：http://localhost:8080/system-web/

常见错误排除：

1.Connection refused错误

报错信息如下：

[html] view plain copy

1. [ERROR]Failed to execute goal org.apache.tomcat.maven: tomcat7-maven-plugin: 2.0- SNAPSHOT: deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Connection refused: connect -> [Help 1]  

原因：未启动Tomcat服务器

解决办法：先启动Tomcat服务器再选择Run

2. 401错误

报错信息如下:

[html] view plain copy

1. [ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin: 2.0-SNAPSHOT:deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Server returned HTTP response code: 401 for URL: http://localhost:8080/manager/text/deploy?path=%2Fhelloworld -> [Help 1]  

原因：权限问题

解决办法在$CATALINA_BASE/conf/tomcat-users.xml，

如D:\apache-tomcat-7.0.34\conf\tomcat-users.xml文件中添加权限

[html] view plain copy

1. <role rolename=”manager”/>  
2. <user username=”admin” password=”admin” roles=”manager”/>  

修改pom.xml文件，在<configuration>  

</configuration>中添加

[html] view plain copy

1. <username>admin</username>    
2. <password>admin</password>  

3.403错误

报错信息如下：

[html] view plain copy

1. [ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin: 2.0-SNAPSHOT:deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Server returned HTTP response code: 403 for URL: http://localhost:8080/manager/html/deploy?path=%2Fhelloworld -> [Help 1]  

原因：产生该问题有可能因为两个原因，具体参见解决办法

解决办法：

1）如果使用的是Tomcat 7，需要修改pom.xml中部署的url地址，将

<url>http://localhost:8080/manager</url>

改

<url>http://localhost:8080/manager/text</url>

在这次部署的问题上，我就是遇到了url 的问题，我用的是tomcat7

2）给tomcat用户权限分配上，需要同时具备manager-gui和manager-script权限

正确的conf/tomcat-users.xml配置应为：

[html] view plain copy

1. <tomcat-users>  
2. <role rolename="manager-gui"/>  
3. <role rolename="manager-script"/>  
4. <user username="admin” password="admin" roles="manager-gui, manager-script"/>  
5. </tomcat-users>