首页 > 编程语言 > 构建Maven多模块项目的方法
2022
03-16

构建Maven多模块项目的方法

构建Maven多模块项目

JavaWeb开发一般都会进行分层开发，通常分为

  • model，模型层
  • dao，数据访问层
  • service，业务逻辑层
  • web，表现层

分层后，各层职责明确，后期维护起来也会容易一些。接下来我们就是使用Maven来构建以上各层，即构建一个Maven多模块项目，项目目录结构如下所示。

在这里插入图片描述

创建父模块

执行命令：mvn -B archetype:generate -DgroupId=com.jepcc.app -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4，得到一个新项目。

在这里插入图片描述

接下来作如下处理：

  • 删除src文件夹
  • 修改demo/pom.xml文件

<packaging>标签在没有指明的情况下默认是jar，这里将其修改为pom，表示模块是一个可以被继承的模块。

在这里插入图片描述 

创建子模块:model层

进入demo目录，执行命令：mvn -B archetype:generate -DgroupId=com.jepcc.app -DartifactId=model -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4，在demo目录下生成了model目录，model目录里包含了src目录和pom.xml文件。

在这里插入图片描述

且demo/pom.xml里自动新增了以下内容，

<modules>  
	<module>model</module>
</modules>

接下来做如下处理： 修改model/pom.xml文件

  • 删除<groupId>com.jepcc.app</groupId>和<version>1.0-SNAPSHOT</version>
  • 因为groupId和version会继承自父模块的groupId和version。
  • 增加<packaging>jar</packaging>
  • 将打包方式设置为jar。

在这里插入图片描述

创建子模块：dao模块

在demo目录下，执行命令：mvn -B archetype:generate -DgroupId=com.jepcc.app -DartifactId=dao -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4，在demo目录下生成了dao目录，dao目录里包含了src目录和pom.xml。

在这里插入图片描述

且demo/pom.xml里自动新增了内容，如下，

<modules>  
	<module>model</module>
    <module>dao</module>
 </modules>

接下来做如下处理：

修改 dao/pom.xml

删除<groupId>com.jepcc.app</groupId>和<version>1.0-SNAPSHOT</version>
因为groupId和version会继承自父模块的groupId和version。

增加<packaging>jar</packaging>
将打包方式设置为jar。增加依赖
增加对model模块的依赖

<dependency>
  <groupId>com.jepcc.app</groupId>
  <artifactId>model</artifactId>
  <version>${project.version}</version>
</dependency>

在这里插入图片描述

创建子模块：service层

在demo目录下，执行命令：mvn -B archetype:generate -DgroupId=com.jepcc.app -DartifactId=service -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4，在demo目录下生成service目录，service目录里包含src目录和pom.xml文件。

在这里插入图片描述

且demo/pom.xml文件自动新增内容，如下，

<modules>  
	<module>model</module>
    <module>dao</module>
    <module>service</module>
</modules>

接下来作如下处理：

修改 service/pom.xml

删除<groupId>com.jepcc.app</groupId>和<version>1.0-SNAPSHOT</version>
因为groupId和version会继承自父模块的groupId和version。

增加<packaging>jar</packaging>
将打包方式设置为jar。

增加依赖
service 层依赖dao层和model层，但我们只需要添加dao层，因为dao模块中已经添加了对model模块的依赖。

<dependency>
  <groupId>com.jepcc.app</groupId>
  <artifactId>dao</artifactId>
  <version>${project.version}</version>
</dependency>

创建子模块：web层

在demo目录下执行命令：mvn -B archetype:generate -DgroupId=com.jepcc.app -DartifactId=web -DarchetypeArtifactId=maven-archetype-webapp -DarchetypeVersion=1.4，在demo目录下生成web目录，web目录包含src目录和pom.xml。web/src/main/webapp/WEB-INF目录下生成了web.xml。
web/src/main/webapp目录下生成了简单的index.jsp，如下，

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

在这里插入图片描述

且demo/pom.xml自动新增内容，如下，

<modules>  
	<module>model</module>
    <module>dao</module>
    <module>service</module>
    <module>web</module>
</modules>

接下来作如下处理：

  • 修改 web/pom.xml
  • 删除<groupId>com.jepcc.app</groupId>和<version>1.0-SNAPSHOT</version>
  • 因为groupId和version会继承自父模块的groupId和version。
  • 增加依赖
  • service 层依赖dao层和model层，但我们只需要添加dao层，因为dao模块中已经添加了对model模块的依赖。
<dependency>
  <groupId>com.jepcc.app</groupId>
  <artifactId>service</artifactId>
  <version>${project.version}</version>
</dependency>

注意哈，web层的打包方式是war!!!

编译运行项目

web模块添加jetty插件
经过以上过程，相关模块全部创建完成，怎么运行起来呢？由于最终运行的是web模块，所以我们对该模块添加jetty支持，方便测试运行，修改web模块的pom.xml，

<?xml version="1.0" encoding="UTF-8"?>
<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">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <artifactId>demo</artifactId>
    <groupId>com.jepcc.app</groupId>
    <version>1.0-SNAPSHOT</version>
  </parent>


  <artifactId>web</artifactId>
  <packaging>war</packaging>

  <name>web Maven Webapp</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.7</maven.compiler.source>
    <maven.compiler.target>1.7</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>com.jepcc.app</groupId>
      <artifactId>service</artifactId>
      <version>${project.version}</version>
    </dependency>
  </dependencies>

  <build>
    <finalName>web</finalName>
    <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
      <plugins>
<!--        配置Jetty插件-->
        <plugin>
          <groupId>org.mortbay.jetty</groupId>
          <artifactId>maven-jetty-plugin</artifactId>
        </plugin>
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>3.1.0</version>
        </plugin>
        <!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging -->
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.22.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-war-plugin</artifactId>
          <version>3.2.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.5.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.8.2</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

进入demo目录，执行命令mvn clean install，完成模块构建。

在这里插入图片描述

构建完成后，web目录下多出了target目录，里面包含web.war。

在这里插入图片描述

进入web目录，执行命令：mvn jetty:run，启动jetty。

在这里插入图片描述

打开浏览器访问网址：http://localhost:8080/web/

在这里插入图片描述 

Maven相关特性

每个子模块都有自己的pom.xml文件，这就意味着每个子模块都有可以添加自己的依赖，这就可能造成一个相同的依赖每个模块都要添加一次，而且添加的版本可能不一致，这会造成项目混乱、导致运行时的各种问题。
所以，就应该有个父模块去统一管理所有的jar包，其他子模块去引用父模块就好了，子模块就不需要重复去定义依赖。

父模块的配置

父模块有两个特点：

  • 父模块中没有代码，只有pom.xml文件，用来管理所有依赖及共同配置
  • 父模块pom.xml中的<packaging>标签必须设置为pom
<groupId>com.jepcc.app</groupId>
<artifactId>demo</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>pom</packaging>

父模块聚合子模块

父模块在pom.xml中通过<modules>和<module>声明需要聚合的子模块。

<modules>
  <module>model</module>
  <module>dao</module>
  <module>service</module>
  <module>web</module>
</modules>

父模块统一管理依赖包

父模块的pom.xml通过<dependencyManagement>来统一管理所有jar包及其版本，这样子模块要引用一个依赖时，就不需要在自己的pom.xml里显式列出版本号。因为Maven会沿着父子层次往上走，直到找到拥有dependencyManagement标签的模块，最终确定依赖包对应的版本，并完成加载。
使用<dependencyManagement>来统一管理依赖的版本号，可以确保各个依赖的版本是一致的。
关于<dependencyManagement>和<dependencies>，二者有如下区别：

  • 对于<dependencyManagement>，只是在父模块中声明依赖，而不实现引入，因此子模块需要显式声明所需要的依赖，否则子模块是不会从父模块中继承下来的。
  • 当子模块显式声明依赖且没有指定版本，子模块会从父模块中继承依赖；当子模块显式声明依赖且指定版本号，Maven会使用子模块中的指定版本。
  • 对于<dependencies>，即使子模块中不写依赖，子模块依然会从父模块中继承所有依赖。

子模块在pom.xml中声明父模块

子模块在自己的pom.xml中通过<parent>声明父模块。

<parent>
  <artifactId>demo</artifactId>
  <groupId>com.jepcc.app</groupId>
  <version>1.0-SNAPSHOT</version>
</parent>

参考文章

使用Maven构建多模块项目

到此这篇关于构建Maven多模块项目的方法的文章就介绍到这了,更多相关Maven多模块项目内容请搜索自学编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持自学编程网！

编程技巧