《Maven实战》读书笔记--(1)使用intellij idea搭建并配置maven多模块项目

最新推荐文章于 2024-11-13 20:22:45 发布

原创

最新推荐文章于 2024-11-13 20:22:45 发布 · 1.2k 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#maven

本文使用intellij idea搭建Maven3多模块项目，并进行配置相关配置，以实现项目的构建打包。

项目结构

这里写图片描述

multi-module-project是我们的项目名称，其中包含多个模块：

mmp-dal模块：数据访问层，提供对原始数据（主要指数据库）的操作
mmp-integration模块：提供对第三方服务的调用
mmp-commons模块：提供工具类、常量定义等公共服务
mmp-biz模块：使用以上模块完成相关业务
mmp-service模块：对业务模块相应接口进行包装，并进行入参与返回值判断
mmp-api模块：提供对外服务的接口

搭建项目

新建项目，选择Maven，不要勾选Create from archetype。

这里写图片描述

填写GroupId、ArtifactId与Version。

GroupId定义了项目属于哪个组，一般和项目所在的组织或公司存在关联
ArtifactId定义了当前Maven项目在组中唯一的ID
Version指定了项目当前的版本，SNAPSHOT意为快照，说明该项目还处于开发中，是不稳定版本

这里写图片描述

下面的Project name与Project location默认是没有-的，这里我们为了与前面ArtifactId一致，将-加上。

这里写图片描述

由于multi-module-project为聚合项目，因此我们删除src文件夹。

这里写图片描述

接下来我们给该项目添加模块。

这里写图片描述

首先添加mmp-dal模块。

这里写图片描述

和上面一样，这里我们为了与前面ArtifactId一致，将-加上。

这里写图片描述

依次添加各个模块。

这里写图片描述

下面multi-module-project的POM配置是idea自动生成的，其中的注释解释了各个参数的含义。

<?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>

    <!--groupId定义了项目属于哪个组，一般和项目所在的组织或公司存在关联-->
    <groupId>com.sigalhu.mmp</groupId>
    <!--artifactId定义了当前Maven项目在组中唯一的ID-->
    <artifactId>multi-module-project</artifactId>
    <!--packaging指定打包类型，pom表示该项目为聚合项目，不打包-->
    <packaging>pom</packaging>
    <!--version指定了项目当前的版本，SNAPSHOT意为快照，说明该项目还处于开发中，是不稳定版本-->
    <version>1.0-SNAPSHOT</version>

    <!--用户可以通过在一个打包方式为pom的Maven项目中声明任意数量的module来实现模块的聚合-->
    <!--在构建时，Maven按序读取POM，如果该POM没有依赖模块，那么就构建该模块，否则就先构建其依赖模块，
        如果该依赖还依赖于其他模块，则进一步先构建依赖的依赖-->
    <modules>
        <module>mmp-dal</module>
        <module>mmp-integration</module>
        <module>mmp-commons</module>
        <module>mmp-biz</module>
        <module>mmp-service</module>
        <module>mmp-api</module>
    </modules>
</project>

下面mmp-dal的POM配置同样由idea自动生成，我们通过注释对各个参数进行说明。

<?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">
    <!--使用parent声明父模块-->
    <parent>
        <artifactId>multi-module-project</artifactId>
        <groupId>com.sigalhu.mmp</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <!--子模块隐式地从父模块继承了groupId和version-->
    <!--artifactId定义了当前Maven项目在组中唯一的ID-->
    <artifactId>mmp-dal</artifactId>
</project>

配置依赖

项目搭建好后，我们先来配置一下测试依赖，在multi-module-project的POM中添加配置，这里由于篇幅所限，省略了之前已经提到的配置。

在配置依赖时，我们一般在父模块的dependencyManagement中进行声明，此时声明的依赖并未生效，同时在properties中定义一个表示版本号的Maven属性，并通过${...}加以引用，在以后当我们想要升级依赖的版本时，只需要修改properties就可以。

接下来，我们通过dependencies来引入项目依赖，由于junit的依赖信息已经在dependencyManagement中声明过了，所以我们只需要在dependencies中声明junit的groupId和artifactId，Maven就会找到在dependencyManagement中的对应声明并引用该依赖。

通过dependencies引入的依赖会作用于当前项目以及在modules中声明的子模块，这里所有子模块都要使用junit进行单元测试，因此在父模块中引用该依赖。

<project>
    ...
    <!--使用properties定义Maven属性-->
    <properties>
        <junit.version>4.12</junit.version>
    </properties>

    <!--dependencies下可包含多个dependency以声明项目的依赖-->
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <!--测试-->
            <dependency>
                <!--定义当前Maven项目隶属的实际项目，一个实际项目往往会被划分成很多模块-->
                <groupId>junit</groupId>
                <!--定义实际项目中的一个Maven项目（模块），推荐使用实际项目名称作为artifactId的前缀-->
                <artifactId>junit</artifactId>
                <!--Maven运行时会将POM中所有${junit.version}替换成实际值-->
                <version>${junit.version}</version>
                <!--scope为依赖范围，test表示该依赖只对测试有效-->
                <scope>test</scope>