使用Maven构建多模块项目

GuiHuey 9年前

来自： http://my.oschina.net/weiweiblog/blog/610602


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

　　项目结构如下：

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

一、创建system-parent项目

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

　　进入命令行，输入以下命令： 

mvn archetype:create -DgroupId=me.gacl -DartifactId=system-parent -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

　　如下图所示：

　　

　　命令执行完成之后可以看到在当前目录(C:\Documents and Settings\Administrator)生成了system-parent目录，里面有一个src目录和一个pom.xml文件，如下图所示：

　　

　　将src文件夹删除，然后修改pom.xml文件，将<packaging>jar</packaging>修改为<packaging>pom</packaging>，pom表示它是一个被继承的模块，修改后的内容如下：

复制代码 
 1 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  2  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">  3 <modelVersion>4.0.0</modelVersion>  4  5 <groupId>me.gacl</groupId>  6 <artifactId>system-parent</artifactId>  7 <version>1.0-SNAPSHOT</version>  8 <packaging>pom</packaging>  9 10 <name>system-parent</name> 11 <url>http://maven.apache.org</url> 12 13 <properties> 14 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 15 </properties> 16 17 <dependencies> 18 <dependency> 19 <groupId>junit</groupId> 20 <artifactId>junit</artifactId> 21 <version>3.8.1</version> 22 <scope>test</scope> 23 </dependency> 24 </dependencies> 25 </project>
复制代码

二、创建sytem-domain模块

　　在命令行进入创建好的system-parent目录，然后执行下列命令： 

mvn archetype:create -DgroupId=me.gacl -DartifactId=system-domain -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

　　如下图所示：

　　

　　命令执行完成之后可以看到在system-parent目录中生成了system-domain，里面包含src目录和pom.xml文件。如下图所示：

　　

　　

　　同时，在system-parent目录中的pom.xml文件自动添加了如下内容： 

<modules> <module>system-domain</module> </modules>

　　这时，system-parent的pom.xml文件如下：

复制代码 
 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" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">  3 <modelVersion>4.0.0</modelVersion>  4  5 <groupId>me.gacl</groupId>  6 <artifactId>system-parent</artifactId>  7 <version>1.0-SNAPSHOT</version>  8 <packaging>pom</packaging>  9 10 <name>system-parent</name> 11 <url>http://maven.apache.org</url> 12 13 <properties> 14 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 15 </properties> 16 17 <dependencies> 18 <dependency> 19 <groupId>junit</groupId> 20 <artifactId>junit</artifactId> 21 <version>3.8.1</version> 22 <scope>test</scope> 23 </dependency> 24 </dependencies> 25 <modules> 26 <module>system-domain</module> 27 </modules> 28 </project>
复制代码

　　修改system-domain目录中的pom.xml文件，把<groupId>me.gacl</groupId>和<version>1.0-SNAPSHOT</version>去掉，加上<packaging>jar</packaging>，因为groupId和version会继承system-parent中的groupId和version，packaging设置打包方式为jar

　　修改过后的pom.xml文件如下：

复制代码 
 1 <?xml version="1.0"?>  2 <project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"  3  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  4 <modelVersion>4.0.0</modelVersion>  5 <parent>  6 <groupId>me.gacl</groupId>  7 <artifactId>system-parent</artifactId>  8 <version>1.0-SNAPSHOT</version>  9 </parent> 10 11 <artifactId>system-domain</artifactId> 12 <packaging>jar</packaging> 13 14 <name>system-domain</name> 15 <url>http://maven.apache.org</url> 16 </project>
复制代码

三、创建sytem-dao模块

　　在命令行进入创建好的system-parent目录，然后执行下列命令： 

mvn archetype:create -DgroupId=me.gacl -DartifactId=system-dao -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

　　如下图所示：

　　

　　命令执行完成之后可以看到在system-parent目录中生成了system-dao，里面包含src目录和pom.xml文件。如下图所示：

　　

　　同时，在system-parent目录中的pom.xml文件自动变成如下内容：

复制代码 
 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" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">  3 <modelVersion>4.0.0</modelVersion>  4  5 <groupId>me.gacl</groupId>  6 <artifactId>system-parent</artifactId>  7 <version>1.0-SNAPSHOT</version>  8 <packaging>pom</packaging>  9 10 <name>system-parent</name> 11 <url>http://maven.apache.org</url> 12 13 <properties> 14 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 15 </properties> 16 17 <dependencies> 18 <dependency> 19 <groupId>junit</groupId> 20 <artifactId>junit</artifactId> 21 <version>3.8.1</version> 22 <scope>test</scope> 23 </dependency> 24 </dependencies> 25 <modules> 26 <module>system-domain</module> 27 <module>system-dao</module> 28 </modules> 29 </project>
复制代码

　　修改system-dao目录中的pom.xml文件，，把<groupId>me.gacl</groupId>和<version>1.0-SNAPSHOT</version>去掉，加上<packaging>jar</packaging>，因为groupId和version会继承system-parent中的groupId和version，packaging设置打包方式为jar，同时添加对system-domain模块的依赖，修改后的内容如下：

复制代码 
 1 <?xml version="1.0"?>  2 <project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"  3  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  4 <modelVersion>4.0.0</modelVersion>  5 <parent>  6 <groupId>me.gacl</groupId>  7 <artifactId>system-parent</artifactId>  8 <version>1.0-SNAPSHOT</version>  9 </parent> 10 11 <artifactId>system-dao</artifactId> 12 <packaging>jar</packaging> 13 14 <name>system-dao</name> 15 <url>http://maven.apache.org</url> 16 <properties> 17 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 18 </properties> 19 <dependencies> 20 <!--system-dao需要使用到system-domain中的类，所以需要添加对system-domain模块的依赖--> 21 <dependency> 22 <groupId>me.gacl</groupId> 23 <artifactId>system-domain</artifactId> 24 <version>${project.version}</version> 25 </dependency> 26 </dependencies> 27 </project>
复制代码

四、创建system-service模块

　　在命令行进入创建好的system-parent目录，然后执行下列命令： 

mvn archetype:create -DgroupId=me.gacl -DartifactId=system-service -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

　　如下图所示：

　　

　　命令执行完成之后可以看到在system-parent目录中生成了system-service，里面包含src目录和pom.xml文件。如下图所示：

　　

　　同时，在system-parent目录中的pom.xml文件自动变成如下内容：

复制代码 
 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" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">  3 <modelVersion>4.0.0</modelVersion>  4  5 <groupId>me.gacl</groupId>  6 <artifactId>system-parent</artifactId>  7 <version>1.0-SNAPSHOT</version>  8 <packaging>pom</packaging>  9 10 <name>system-parent</name> 11 <url>http://maven.apache.org</url> 12 13 <properties> 14 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 15 </properties> 16 17 <dependencies> 18 <dependency> 19 <groupId>junit</groupId> 20 <artifactId>junit</artifactId> 21 <version>3.8.1</version> 22 <scope>test</scope> 23 </dependency> 24 </dependencies> 25 <modules> 26 <module>system-domain</module> 27 <module>system-dao</module> 28 <module>system-service</module> 29 </modules> 30 </project>
复制代码

　　修改system-service目录中的pom.xml文件，，把<groupId>me.gacl</groupId>和<version>1.0-SNAPSHOT</version>去掉，加上<packaging>jar</packaging>，因为groupId和version会继承system-parent中的groupId和version，packaging设置打包方式为jar，同时添加对system-dao模块的依赖，system-service依赖system-dao和system-domain，但是我们只需添加system-dao的依赖即可，因为system-dao已经依赖了system-domain。修改后的内容如下：

复制代码 
 1 <?xml version="1.0"?>  2 <project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"  3  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  4 <modelVersion>4.0.0</modelVersion>  5 <parent>  6 <groupId>me.gacl</groupId>  7 <artifactId>system-parent</artifactId>  8 <version>1.0-SNAPSHOT</version>  9 </parent> 10 11 <artifactId>system-service</artifactId> 12 <packaging>jar</packaging> 13 14 <name>system-service</name> 15 <url>http://maven.apache.org</url> 16 <properties> 17 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 18 </properties> 19 <dependencies> 20 <!-- 21  system-service依赖system-dao和system-domain， 22  但是我们只需添加system-dao的依赖即可，因为system-dao已经依赖了system-domain 23 --> 24 <dependency> 25 <groupId>me.gacl</groupId> 26 <artifactId>system-dao</artifactId> 27 <version>${project.version}</version> 28 </dependency> 29 </dependencies> 30 </project>
复制代码

五、创建system-web模块

　　在命令行进入创建好的system-parent目录，然后执行下列命令： 

mvn archetype:create -DgroupId=me.gacl -DartifactId=system-web -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

　　如下图所示：

　　

　　命令执行完成之后可以看到在system-parent目录中生成了system-web，里面包含src目录和pom.xml文件。如下图所示：

　　

　　在\system-web\src\main\webapp目录中还生成了一个简单的index.jsp,如下图所示：

　　

　　里面的内容为 

<html> <body> <h2>Hello World!</h2> </body> </html>

　　system-web\src\main\webapp\WEB-INF目录中生成了web.xml

　　

　　同时，在system-parent目录中的pom.xml文件自动变成如下内容：

复制代码 
 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" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">  3 <modelVersion>4.0.0</modelVersion>  4  5 <groupId>me.gacl</groupId>  6 <artifactId>system-parent</artifactId>  7 <version>1.0-SNAPSHOT</version>  8 <packaging>pom</packaging>  9 10 <name>system-parent</name> 11 <url>http://maven.apache.org</url> 12 13 <properties> 14 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 15 </properties> 16 17 <dependencies> 18 <dependency> 19 <groupId>junit</groupId> 20 <artifactId>junit</artifactId> 21 <version>3.8.1</version> 22 <scope>test</scope> 23 </dependency> 24 </dependencies> 25 <modules> 26 <module>system-domain</module> 27 <module>system-dao</module> 28 <module>system-service</module> 29 <module>system-web</module> 30 </modules> 31 </project>
复制代码

　　修改system-web目录中的pom.xml文件，，把<groupId>me.gacl</groupId>和<version>1.0-SNAPSHOT</version>去掉，因为groupId和version会继承system-parent中的groupId和version，同时添加对system-service模块的依赖，修改后的内容如下：

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

　　 注意，web项目的打包方式是war。

六、编译运行项目

　　经过上面的五个步骤，相关的模块全部创建完成，怎么运行起来呢。由于最终运行的是system-web模块，所以我们对该模块添加jetty支持，方便测试运行。修改system-web项目的pom.xml如下：

复制代码 
 1 <?xml version="1.0"?>  2 <project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"  3  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  4 <modelVersion>4.0.0</modelVersion>  5 <parent>  6 <groupId>me.gacl</groupId>  7 <artifactId>system-parent</artifactId>  8 <version>1.0-SNAPSHOT</version>  9 </parent> 10 11 <artifactId>system-web</artifactId> 12 <packaging>war</packaging> 13 14 <name>system-web Maven Webapp</name> 15 <url>http://maven.apache.org</url> 16 <dependencies> 17 <!-- 18  system-web依赖system-service 19 --> 20 <dependency> 21 <groupId>me.gacl</groupId> 22 <artifactId>system-service</artifactId> 23 <version>${project.version}</version> 24 </dependency> 25 </dependencies> 26 <build> 27 <finalName>system-web</finalName> 28 <plugins> 29 <!--配置Jetty插件--> 30 <plugin> 31 <groupId>org.mortbay.jetty</groupId> 32 <artifactId>maven-jetty-plugin</artifactId> 33 </plugin> 34 </plugins> 35 </build> 36 </project>
复制代码

　　在命令行进入system-parent目录，然后执行下列命令： 

mvn clean install

　　如下图所示：

　　

　　

　　命令执行完后，在system-web目录下多出了target目录，里面有了system-web.war，如下图所示：

　　

　　命令行进入sytem-web目录，执行如下命令，启动jetty 

mvn jetty:run

　　如下图所示：

　　

　　

　　启动jetty服务器后，访问http://localhost:8080/system-web/ 运行结果如下图所示：

　　

七、导入Eclipse中进行开发

　　操作步骤如下所示：