【Maven篇】我整理了一篇Maven笔记

前言

在本章，会分为分模块开发、依赖管理、聚合和继承、属性、多环境配置和应用、私服几个模块，完成本文的学习，将学会团队内部是如何使用模块开发，如何解决团队内部的资源共享与资源同步问题。

文章目录

- 前言
- [1. 分模块开发](#1. 分模块开发)
- - [(1) 分模块开发意义](#(1) 分模块开发意义)
  - [(2) 快速实现](#(2) 快速实现)
- [2. 依赖管理](#2. 依赖管理)
- - [(1) 依赖传递与依赖冲突](#(1) 依赖传递与依赖冲突)
  - [(2) 可选依赖与排除依赖](#(2) 可选依赖与排除依赖)
- 3.聚合和继承
- - [(1) 聚合](#(1) 聚合)
  - - [<1> **概念**](#<1> 概念)
    - [<2> 聚合工程开发](#<2> 聚合工程开发)
  - [(2) 继承](#(2) 继承)
  - - [<1> 概念](#<1> 概念)
    - [<2> 继承实现](#<2> 继承实现)
  - [(3) 聚合和继承的区别](#(3) 聚合和继承的区别)
- [4. 属性](#4. 属性)
- - - [<1> 使用方法](#<1> 使用方法)
    - [<2> 配置文件加载属性](#<2> 配置文件加载属性)
    - [<3> 其他属性](#<3> 其他属性)
    - [<4> 版本管理](#<4> 版本管理)
- [5. 多环境配置与应用](#5. 多环境配置与应用)
- - [(1) 多环境开发](#(1) 多环境开发)
  - - [<1> 简介](#<1> 简介)
    - [<2> 使用方式](#<2> 使用方式)
  - [(2) 跳过测试(了解)](#(2) 跳过测试(了解))
  - - [<1> 通过IDEA工具实现跳过测试](#<1> 通过IDEA工具实现跳过测试)
    - [<2> 通过配置插件实现跳过测试](#<2> 通过配置插件实现跳过测试)
    - [<3> 通过命令行跳过测试](#<3> 通过命令行跳过测试)
- [6. 私服](#6. 私服)
- - - [<1> 简介](#<1> 简介)
    - [<2> 仓库分类](#<2> 仓库分类)
    - [<3> 本地仓库访问私服配置](#<3> 本地仓库访问私服配置)
    - [<4> 私服资源上传与下载](#<4> 私服资源上传与下载)

1. 分模块开发

(1) 分模块开发意义

将原始模块按照功能拆分成若干个子模块，方便模块间的互相调用，接口共享，例如将各层拆分成对立的模块，这样项目每一层都可以单独维护，方便别人使用。

(2) 快速实现

1.创建Maven模块

2.书写模块代码(分模块开发需要现针对模块功能进行设计，再进行编码。不会先将工程开发完毕，然后进行拆分)

3.通过Maven指令安装模块到本地仓库(install指令)

在团队内部开发需要发布模块功能到团队内部可共享的仓库中(私服)

2. 依赖管理

依赖指当前项目需要的jar包，一个项目可以设置多个依赖

格式：

xml 复制代码

<!--设置当前项目所依赖的所有jar-->
<dependencies>
    <!--设置具体的依赖-->
    <dependency>
        <!--依赖所属群组id-->
        <groupId>org.springframework</groupId>
        <!--依赖所属项目id-->
        <artifactId>spring-webmvc</artifactId>
        <!--依赖版本号-->
        <version>5.2.10.RELEASE</version>
    </dependency>
</dependencies>

(1) 依赖传递与依赖冲突

依赖传递

在项目依赖的jar包中，如果含有>，说明这个jar包还依赖其他的jar包

以上都称为依赖，对于不同的依赖有以下名称

直接依赖：在当前项目中通过依赖配置建立的依赖关系
间接依赖：被资源的资源如果依赖其他资源，当前项目间接依赖其他资源

若有间接依赖的资源和直接依赖的资源相同时，去除直接依赖也可以使用，这个特性就是依赖传递。

依赖冲突

由于有了依赖传递的存在，难免会导致依赖冲突，依赖冲突就是项目所依赖的某个jar包，有不同的版本，从而导致类包版本冲突。

冲突问题分为三种

路径优先：当依赖中出现相同的资源时，层级越深，优先级越低，层级越浅，优先级越高。
声明优先：当资源在相同层级被依赖时，配置顺序靠前的覆盖配置顺序靠后的
特殊优先：当同级配置了相同资源的不同版本，后配置的覆盖先配置的

(2) 可选依赖与排除依赖

可选依赖

隐藏当前工程所依赖的资源，隐藏后不具有依赖传递

可选依赖指对外隐藏当前所依赖的资源--不透明

xml 复制代码

<dependency>
    <groupId>com.itheima</groupId>
    <artifactId>maven_03_pojo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!--可选依赖是隐藏当前工程所依赖的资源，隐藏后对应资源将不具有依赖传递-->
    <optional>true</optional>
</dependency>

排除依赖

当别的项目依赖这个项目时，将不会依赖这个资源

排除依赖指主动断开依赖的资源，被排除的资源无需指定版本--不需要

xml 复制代码

<dependency>
    <groupId>com.itheima</groupId>
    <artifactId>maven_04_dao</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!--排除依赖是隐藏当前资源对应的依赖关系-->
    <exclusions>
        <exclusion>
            <groupId>com.itheima</groupId>
            <artifactId>maven_03_pojo</artifactId>
        </exclusion>
        <exclusion>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
        </exclusion>
    </exclusions>
</dependency>

排除依赖资源仅指定GA,无需指定V

3.聚合和继承

(1) 聚合

快速构建多模块开发

<1> 概念

聚合：将多个模块组织成一个整体，同时进行项目构建的过程称为聚合

聚合工程：通常是一个不具有业务功能的"空"工程(有且只有一个pom文件)

作用：使用聚合工程可以将多个工程编组，通过对聚合工程进行构建，实现对所包含的模块进行同步构建

当工程中某个模块发生更新时，必须保障工程中与已更新模块的关联的模块同步更新，此时可以使用聚合工程来解决批量模块同步构建的问题

通过聚合，避免了我们项目多的时候，改动需要对所有模块重新编译的问题

<2> 聚合工程开发

1.创建Maven项目,设置打包类型为pom

xml 复制代码

<packaging>pom</packaging>

每个maven工程有对应的打包方式，默认为jar，web工程为war

2.设置当前聚合工程所包含的子模块名称

xml 复制代码

    <!--设置管理的模块名称-->
    <modules>
        <module>../maven_02_ssm</module>
        <module>../maven_03_pojo</module>
        <module>../maven_04_dao</module>
    </modules>

聚合工程中所包含的模块在进行构建时会根据模块间的依赖关系设置构建顺序，与聚合工程中模块的配置书写位置无关

参与聚合的工程无法向上感知是否参与聚合，只能向下配置哪些模块参与本工程的聚合

(2) 继承

<1> 概念

继承描述的是两个工程间的关系，与java相似，子工程继承父工程的配置信息，常见于依赖关系的继承.

作用：快速配置依赖，统一依赖版本（减少版本冲突)

<2> 继承实现

1.创建Maven项目,设置打包类型为pom

xml 复制代码

<packaging>pom</packaging>

2.在父工程的pom文件中配置依赖关系(子工程将沿用父工程的依赖关系)

xml 复制代码

    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>5.2.10.RELEASE</version>
        </dependency>
	</dependencies>

3.配置子工程中可选的依赖关系

xml 复制代码

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

4.在子工程中配置当前工程所继承的父工程

xml 复制代码

<!--配置当前工程继承自parent工程-->
<parent>
    <groupId>com.itheima</groupId>
    <artifactId>maven_01_parent</artifactId>
    <version>1.0-RELEASE</version>
    <!--设置父项目pom.xml位置路径-->
    <relativePath>../maven_01_parent/pom.xml</relativePath>
</parent>

5.在子工程中配置使用父工程中可选依赖的坐标

xml 复制代码

<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <scope>test</scope>
</dependency>

子工程中使用父工程中的可选依赖时，仅需要提供群组id和项目id，无需提供版本，版本由父工程统一提供，避免版本冲突

子工程中还可以定义父工程中没有定义的依赖关系

(3) 聚合和继承的区别

作用：

聚合用于快速构建项目
继承用于快速配置

相同点：

聚合与继承的pom.xml文件打包方式均为pom，可以将两种关系制作到同一个pom文件中
聚合与继承均属于设计型模块，并无实际的模块内容

不同点：

聚合是在当前模块中配置关系，聚合可以感知到参与聚合的模块有哪些
继承是在子模块中配置关系，父模块无法感知哪些子模块继承了自己

4. 属性

如果需要更新多个jar包，可能会出现漏改导致出现问题.

类似java基础的变量，在其他的地方使用变量即可.

<1> 使用方法

1.父工程定义属性

xml 复制代码

<!-- 设置属性 -->
<properties>
    <spring.version>5.2.10.RELEASE</spring.version>
    <junit.version>4.12</junit.version>
    <mybatis-spring.version>1.3.0</mybatis-spring.version>
</properties>

2.子工程引用属性

xml 复制代码

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>${spring.version}</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>${spring.version}</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>${spring.version}</version>
</dependency>

<2> 配置文件加载属性

将properties抽取到父工程，之后只需要更新父工程即可

1.定义属性

xml 复制代码

<!--定义自定义属性-->
<properties>
    <jdbc.url>1.3.0</jdbc.url>
</properties>

2.配置文件中引用属性

properties 复制代码

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=${jdbc.url}
jdbc.username=root
jdbc.password=root

3.开启资源文件目录加载属性的过滤器

为了能让配置文件解析到${}

xml 复制代码

<build>
    <resources>
        <!--
			${project.basedir}: 当前项目所在目录,子项目继承了父项目，
			相当于所有的子项目都添加了资源目录的过滤
		-->
        <resource>
            <directory>${project.basedir}/src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

注：这个属性在其他属性会写

4.配置maven打war包时，忽略web.xml检查

xml 复制代码

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.2.3</version>
            <configuration>
                <failOnMissingWebXml>false</failOnMissingWebXml>
            </configuration>
        </plugin>
    </plugins>
</build>

<3> 其他属性

<4> 版本管理

在jar包的版本定义中，有两个工程版本用的比较多(了解即可):

SNAPSHOT（快照版本）
- 项目开发过程中临时输出的版本，称为快照版本
- 快照版本会随着开发的进展不断更新
RELEASE（发布版本）
- 项目开发到一定阶段里程碑后，向团队外部发布较为稳定的版本，这种版本所对应的构件文件是稳定的
- 即便进行功能的后续开发，也不会改变当前发布版本内容，这种版本称为发布版本

除了上面的工程版本，我们还经常能看到一些发布版本:

alpha版:内测版，bug多不稳定内部版本不断添加新功能
beta版:公测版，不稳定(比alpha稳定些)，bug相对较多不断添加新功能
纯数字版

5. 多环境配置与应用

(1) 多环境开发

<1> 简介

在项目中，我们在开发环境开发，测试人员在测试环境开发，项目部署到生产环境上线使用，这三个环境不可能使用同一个数据库.

而在maven中，提供了多种环境的设定，帮助开发者使用过程中快速切换环境

<2> 使用方式

1.定义多环境

xml 复制代码

<!--定义多环境-->
<profiles>
    <!--定义具体的环境：开发环境-->
    <profile>
        <!--定义环境中唯一名称-->
        <id>env_dev</id>
        <properties>
            <jdbc.url>jdbc:mysql://127.1.1.1:3306/ssm_db</jdbc.url>
        </properties>
        <!--设定是否为默认启动环境-->
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
    </profile>
    <!--测试环境-->
    <profile>
        <id>env_test</id>
        <properties>
            <jdbc.url>jdbc:mysql://127.3.3.3:3306/ssm_db</jdbc.url>
        </properties>
    </profile>
</profiles>

2.使用多环境(构建过程)

powershell 复制代码

mvn 指令 -P 环境定义ID[环境定义中获取]

范例：

powershell 复制代码

mvn install -P env_test

(2) 跳过测试(了解)

在执行install时，会自动执行test.

test的意义是提前发现代码问题、保障软件质量，避免有缺陷的代码流入生产环境.

但是当测试通过后，打包和安装还需要进行测试.

部分模块没有开发完毕，想要快速打包一部分，但是测试环境失败.

遇到以上的情况，我们需要跳过测试，跳过测试有三种方式

<1> 通过IDEA工具实现跳过测试

当点击后，test会自动取消

<2> 通过配置插件实现跳过测试

细粒度控制跳过测试

xml 复制代码

 <plugin>
     <artifactId>maven-surefire-plugin</artifactId>
     <version>2.22.1</version>
     <configuration>
         <skipTests>true</skipTests>
         <!-- 设置跳过测试-->
         <includes>
             <!-- 包含指定的测试用例-->
             <include>**/User*Test.java</include>
         </includes>
         <excludes>
             <!-- 排除指定的测试用例-->
             <exclude>**/User*TestCase.java</exclude>
         </excludes>
     </configuration>
</plugin>

<3> 通过命令行跳过测试

跳过测试：

powershell 复制代码

mvn 指令 -D skipTests

示例：

powershell 复制代码

mvn install -D skipTests

执行的项目构建指令必须包含测试生命周期，否则不生效.例如执行compile生命周期，不经过test生命周期

6. 私服

在团队之间的jar管理，我们如果直接使用U盘拷贝，会使得非常混乱，但我们又不能将写好的项目传到中央仓库，这个时候，我们可以选择自己搭建一个类似于中央仓库的东西，将内容上传上去，这种东西就是私服

<1> 简介

私服是一台独立的服务器，用于解决团队内部的资源共享与资源同步问题，这里使用的是Nexus

<2> 仓库分类

仓库分为三大类

宿主仓库hosted

保存无法从中央仓库获取的资源
- 自主研发
- 第三方非开源项目,比如Oracle,因为是付费产品，所以中央仓库没有

代理仓库proxy

代理远程仓库，通过nexus访问其他公共仓库，例如中央仓库

仓库组group

将若干个仓库组成一个群组，简化配置
仓库组不能保存资源，属于设计型仓库

<3> 本地仓库访问私服配置

我们想通过Maven访问私服，需要上传的地址、访问私服的账号密码、下载的地址

以上都需要在Maven的配置文件settings.xml中配置

实现步骤

前置步骤：需要在私服创建snapshot仓库和release仓库

1.配置本地Maven对私服的访问权限

xml 复制代码

    <!-- 配置访问私服的权限 -->
    <server>
      <id>Coolipa-release</id>
      <username>admin</username>
      <password>password</password>
    </server>
    <server>
      <id>Coolipa-snapshot</id>
      <username>admin</username>
      <password>password</password>
    </server>

2.配置私服的访问路径

xml 复制代码

    <!-- 私服访问路径 -->
    <mirrors>
    <mirror>
      <id>maven-public</id>
      <mirrorOf>*</mirrorOf>
      <url>http://localhost:8081/repository/maven-public/</url>
    </mirror>
  </mirrors>

如果是练习，请把之前的镜像地址注释掉，以免干预正常使用

<4> 私服资源上传与下载

当某一个工程要上传的时候

配置位置(工程pom文件)

xml 复制代码

 <!--配置当前工程保存在私服中的具体位置-->
<distributionManagement>
    <repository>
        <!--和maven/settings.xml中server中的id一致，表示使用该id对应的用户名和密码-->
        <id>Coolipa-release</id>
         <!--release版本上传仓库的具体地址-->
        <url>http://localhost:8081/repository/Coolipa-release/</url>
    </repository>
    <snapshotRepository>
        <!--和maven/settings.xml中server中的id一致，表示使用该id对应的用户名和密码-->
        <id>Coolipa-snapshot</id>
        <!--snapshot版本上传仓库的具体地址-->
        <url>http://localhost:8081/repository/Coolipa-snapshot/</url>
    </snapshotRepository>
</distributionManagement>

发布命令mvn deploy

拓：如果想改变私服访问中央服务器设置

在Repositories -> maven-central