Maven

zwf[╯•́•̀╰]让我静静

已于 2024-06-22 09:58:14 修改

阅读量2k

点赞数 34

文章标签： github 开发语言 java maven intellij-idea java-ee tomcat

于 2024-04-05 17:40:15 首次发布

本文链接：https://blog.csdn.net/weixin_52347460/article/details/137404958

版权

2.2Idea构建Maven JavaSE工程

2.3Idea构建MavenJavaEE工程

（一）Maven简介和快速入门

1.1 Maven介绍

Maven是一款为Java项目构建管理、依赖管理的工具（软件），使用Maven可以自动化构建、测试、打包和发布项目，大大提高了开发效率和质量。

总结：Maven就是一个软件，掌握软件安装、配置、以及基本功能（项目构建、依赖管理）

1.2 Maven主要作用理解

场景概要

场景1：例如我们项目需要第三方库（依赖），如Druid连接池、MySQL数据库驱动和Jackson等。那么我们可以将需要的依赖项的信息编写到Maven工程的配置文件，Maven软件就会自动下载并复制这些依赖到项目中，也会自动下载依赖需要的依赖！确保依赖版本正确无冲突和依赖完整！

场景2：项目开发完成后，想要将项目打成.war文件，并部署到服务器中运行，使用Maven软件，我们可以通过一行构建命令（mvn package）快速项目构建和打包！节省大量时间！

依赖管理

Maven可以管理项目的依赖，包括自动下载所需依赖库、自动下载依赖需要的依赖并且保证版本没有冲突、依赖版本管理等。通过Maven，我们可以方便地维护项目所依赖的外部库，而我们仅仅需要编写配置即可。

构建管理

项目构建是指将源代码、配置文件、资料文件等转化为能够运行或部署的应用程序或库的过程！

Maven可以管理项目的编译、测试、打包、部署等构建过程。通过实现标准的构建生命周期，Maven可以确保每一个构建过程都遵循通用的规则和最佳实践。同时，Maven的插件机制也使得开发者可以对构建过程进行扩展和定制。主动出发构建，只需要简单的命令操作即可。

1.3Maven安装和配置

Maven – Maven Releases History

1.安装

安装条件:maven 需要本机安装java 环境、必需包含java home 环境变量!

软件安装:Maven – Maven Releases History

软件结构:

2.环境变量

环境变量：配置MAVEN_HOME 和 path

3.命令测试

mvn -v

输出版本信息即可，如果错误，请仔细检查环境变量即可！

友好提示，如果此处错误，绝大部分原因都是java_home变量的事，请仔细检查！

4.配置文件

我们需要需改maven/conf/settings.xml配置文件，来修改maven的一些默认配置。我们主要需要修改的有三个配置：1.依赖本地缓存位置（本地仓库位置）2.maven下载镜像3.maven选用编译项目的jdk版本！

a.配置本地仓库地址

<!-- localRepository
 | The path to the local repository maven will use to store artifacts.
 |
 | Default: ${user.home}/.m2/repository
<localRepository>/path/to/local/repo</localRepository>
-->
<!-- conf/settings.xml 55行 -->
<localRepository>D:\repository</localRepository>

b.配置国内阿里镜像

<!--在mirrors节点(标签)下添加中央仓库镜像 160行附近-->
<mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
    <mirrorOf>central</mirrorOf>
</mirror>

c.配置jdk17版本项目构建

<!--在profiles节点(标签)下添加jdk编译版本 268行附近-->
<profile>
    <id>jdk-17</id>
    <activation>
      <activeByDefault>true</activeByDefault>
      <jdk>17</jdk>
    </activation>
    <properties>
      <maven.compiler.source>17</maven.compiler.source>
      <maven.compiler.target>17</maven.compiler.target>
      <maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
    </properties>
</profile>

5.idea配置本地maven

我们需要将配置好的maven软件，配置到idea开发工具中。

注意：idea工具默认自带maven配置软件，但是因为没有修改配置，建议替换成本地配置好的maven！

a.打开idea配置文件，构建工具配置

依次点击：file / settings / build / build tool / maven

b.选中本地maven软件

c.测试是否配置成功

注意：如果本地仓库地址不变化，只有一个原因，就是maven/conf/settings.xml 配置文件编写错误！

（二）基于IDEA的Maven工程创建

2.1梳理Maven工程GAVP属性

Maven工程相对之前的工程，多出一组gavp属性，gav需要我们在创建项目时指定，p有默认值，后期通过配置文件修改。既然要填写的属性，我们先行了解下这组属性的含义！

Maven中的GAVP是指GroupId、ArtifactId、Version、Packaging等四个属性的缩写，其中前三个是必要的，Packaging属性为可选项。这四个属性主要为每个项目在maven仓库做一个标识。有了具体标识，方便maven软件对项目进行管理和互相引用！

GAV遵循以下规则：

1.GroupID格式：com.{公司/BU}.业务线.[子业务线]，最多4级。

说明：{公司/BU} 例如：alibaba/taobao等BU一级；子业务线可选

正例：com.taobao.tddl 或 com.alibaba.sourcing.multilang

2.ArtifactID格式：产品线名-模块名。语言不重复不遗漏，先到仓库中心去查证一下。

正例：tc-client / uic-api / tair-tool / bookstore

3.Version版本号格式推荐：主版本号.次版本号.修订号 1.0.0

1）主版本号：当做了不兼容的API修改，或者增加了能改变产品方向的新功能。

2）次版本号：当做了向下兼容的功能性新增（新增类、接口等）。

3）修订号：修改bug，没有修改方法签名的功能加强，保持API兼容性。

例如：初始 --> 1.0.0 修改 bug --> 1.0.1 功能调整 --> 1.1.1 等

Packaging定义规则：

指定将项目打包为什么类型的文件，Idea根据Packaging值，识别maven项目类型！

packaging 属性为 jar （默认值），代表普通的Java工程，打包以后是 .jar 结尾的文件。

packaging 属性为 war，代表 Java 的 web 工程，打包以后 .war 结尾的文件。

packaging 属性为 pom，代表不会打包，用来做继承的父工程。

2.2Idea构建Maven JavaSE工程

在ssm-maven空项目里创建一个maven-javase-project01工程

注意：此处省略version，直接给了一个默认值<version>1.0-SNAPSHOT</version>

自己后期可以在项目中随意修改

2.3Idea构建MavenJavaEE工程

1.手动创建

a.创建一个 javase maven 工程

b.手动添加 web 项目结构文件

注意：结构和命名固定

把一下代码复制到web.xml文件里去

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
         version="5.0">
</web-app>

c.修改 pom.xml 文件打包方式

修改位置：项目下/pom.xml

<groupId>com.itzwf</groupId>
<artifactId>maven-javaee-project02</artifactId>
<version>1.0-SNAPSHOT</version>
<!-- 新增一列打包方式packaging -->
<packaging>war</packaging>

d.刷新和校验

项目的webapp文件夹出现小蓝点，代表成功！！

2.插件方式创建

a.安装插件JBLJavaToWeb

file / settings / plugins / marketplace

b.创建一个javase maven工程

c.右键、使用插件快速补全 web 项目

2.4Maven工程项目结构说明

Maven 是一个强大的构建工具，它提供一种标准化的项目结构，可以帮助开发者更容易地管理项目的依赖、构建、测试和发布等任务。以下是 Maven Web 程序的文件结构及每个文件的作用：

|-- pom.xml                               # Maven 项目管理文件 
|-- src
    |-- main                              # 项目主要代码
    |   |-- java                          # Java 源代码目录
    |   |   `-- com/example/myapp         # 开发者代码主目录
    |   |       |-- controller            # 存放 Controller 层代码的目录
    |   |       |-- service               # 存放 Service 层代码的目录
    |   |       |-- dao                   # 存放 DAO 层代码的目录
    |   |       `-- model                 # 存放数据模型的目录
    |   |-- resources                     # 资源目录，存放配置文件、静态资源等
    |   |   |-- log4j.properties          # 日志配置文件
    |   |   |-- spring-mybatis.xml        # Spring Mybatis 配置文件
    |   |   `-- static                    # 存放静态资源的目录
    |   |       |-- css                   # 存放 CSS 文件的目录
    |   |       |-- js                    # 存放 JavaScript 文件的目录
    |   |       `-- images                # 存放图片资源的目录
    |   `-- webapp                        # 存放 WEB 相关配置和资源
    |       |-- WEB-INF                   # 存放 WEB 应用配置文件
    |       |   |-- web.xml               # Web 应用的部署描述文件
    |       |   `-- classes               # 存放编译后的 class 文件
    |       `-- index.html                # Web 应用入口页面
    `-- test                              # 项目测试代码
        |-- java                          # 单元测试目录
        `-- resources                     # 测试资源目录

pom.xml : Maven项目管理文件，用于描述项目的依赖和构建配置等信息。
src / main / java : 存放项目的java源代码
src / main / resources : 存放项目的资源文件，如配置文件、静态资源等。
src / main / webapp / WEB-INF :存放 Web 应用的配置文件。
src / main / webapp / index.html : Web 应用的入口页面。
src / test / java : 存放项目的测试代码。
src / test / resources : 存放测试相关的资源文件，如测试配置文件等。

（三）Maven核心功能依赖管理

3.1 依赖管理和配置

Maven依赖管理是Maven软件中最重要的功能之一。Maven的依赖管理能够帮助开发人员自动解决软件包依赖问题，使得开发人员能够轻松地将其他开发人员开发的模块或第三方框架集成到自己的应用程序或模块中，避免出现版本冲突和依赖缺失等问题。

我们通过定义POM文件，Maven能够自动解析项目的依赖关系，并通过Maven仓库自动下载和管理依赖，从而避免了手动下载和管理依赖的繁琐工作和可能引发的版本冲突问题。

重点：编写 pom.xml 文件！！！

Maven项目信息属性配置和读取：

<!-- 模型版本 -->
<modelVersion>4.0.0</modelVersion>
<!-- 公司或者组织的唯一标志，并且配置时生成的路径也是由此生成， 如com.companyname.project-group，maven会将该项目打成的jar包放本地路径：/com/companyname/project-group -->
<groupId>com.companyname.project-group</groupId>
<!-- 项目的唯一ID，一个groupId下面可能多个项目，就是靠artifactId来区分的 -->
<artifactId>project</artifactId>
<!-- 版本号 -->
<version>1.0.0</version>

<!--打包方式
    默认：jar
    jar指的是普通的java项目打包方式！ 项目打成jar包！
    war指的是web项目打包方式！项目打成war包！
    pom不会讲项目打包！这个项目作为父工程，被其他工程聚合或者继承！后面会讲解两个概念
-->
<packaging>jar/pom/war</packaging>

依赖管理和添加：

<!-- 
   通过编写依赖jar包的gav必要属性，引入第三方依赖！
   scope属性是可选的，可以指定依赖生效范围！
   依赖信息查询方式：
      1. maven仓库信息官网 https://mvnrepository.com/
      2. mavensearch插件搜索
 -->
<dependencies>
    <!-- 引入具体的依赖包 -->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
        <!--
            生效范围
            - compile ：main目录 test目录  打包打包 [默认]
            - provided：main目录 test目录  Servlet
            - runtime： 打包运行           MySQL
            - test:    test目录           junit
         -->
        <scope>runtime</scope>
    </dependency>

</dependencies>

依赖版本提取和维护：

<!--声明版本-->
<properties>
  <!--命名随便,内部制定版本号即可！-->
  <junit.version>4.11</junit.version>
  <!-- 也可以通过 maven规定的固定的key，配置maven的参数！如下配置编码格式！-->
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>

<dependencies>
  <dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <!--引用properties声明版本 -->
    <version>${junit.version}</version>
  </dependency>
</dependencies>

第三方依赖信息要怎么查找？

1.Maven提供的查询官网：https://mvnrepository.comhttps://mvnrepository.com点击上面链接进入官网

比如搜索MySQL依赖

点击上面想要的版本号

2.Maven插件 maven-search

3.2 依赖传递和冲突

依赖传递指的是当一个模块或库A依赖于另一个模块或库B，而B又依赖于模块或库C，那么A会间接依赖于C，这种依赖传递结构可以形成一个依赖树。当我们引入一个库或框架时，构建工具（如Maven、Gradle）会自动解析和加载其所有的直接和间接依赖，确保这些依赖都可用。

依赖传递的作用是：

减少重复依赖：当多个项目依赖同一个库时，Maven可以自动下载并且只下载一次该库。这样可以减少项目的构建时间和磁盘空间。
自动管理依赖：Maven可以自动管理依赖项，使用依赖传递，简化了依赖项的管理，使项目构建更加可靠和一致。
确保依赖版本正确性：通过依赖传递的依赖，之间都不会存在版本兼容性问题，确实依赖的版本正确性！

依赖冲突：当直接引用或者间接引用出现了相同的 jar包！这时呢，一个项目就会出现相同的重复jar包，这就算作冲突！依赖冲突避免出现重复依赖，并且终止依赖传递！

Maven有自动解决依赖冲突问题能力，会按照自己的原则，进行重复依赖选择。

1.自动选择原则

短路优先原则（第一原则）

A --> B --> C --> D --> E --> X(version 0.0.1)

A -->F --> X(version 0.0.2)

则A依赖于X（version 0.0.2）

依赖路径长度相同情况下，则“先声明优先”（第二原则）

A --> E --> X(version 0.0.1)

A --> F --> X(version 0.0.2)

在<depencies></depencies>中，先声明的，路径相同，会优先选择！

3.3 依赖导入失败场景和解决方案

在使用Maven构建项目时，可能会发生依赖项下载错误的情况，主要原因有以下几种：

下载依赖时出现网络故障或仓库服务器宕机等原因，导致无法连接至Maven仓库，从而无法下载依赖。
依赖项的版本号或配置文件中的版本号错误，或者依赖性没有正确定义，导致Maven下载的依赖项与实际需要的不一致，从而引发错误。
本地Maven仓库或缓存被污染或损坏，导致Maven无法正确地使用现有的依赖项，并且也无法重新下载！

解决方法：

检查网络连接和Maven仓库服务器状态。
确保依赖性的版本号与项目对应的版本号匹配，并检查POM文件中的依赖项是否正确。
清除本地Maven仓库缓存（lastUpdated文件），因为只要存在lastupdated缓存文件，刷新也不会重新下载。本地仓库中，根据依赖的gav属性依次向下查找文件夹，最终删除内部的文件，刷新重新下载即可！

使用脚本：在桌面新建一个“文本文档” 文件并将下面的内容复制粘贴过去，保存后退出，并将后缀名改为 “ .bat ” 后，运行文件，就会自动清除本地Maven仓库缓存（lastUpdated文件）。

注意：set REPOSITORY_PATH=D:\maven\repo 这里改为自己的本地Maven仓库路径

@echo off
rem 这里写你的仓库路径
set REPOSITORY_PATH=D:\maven\repo
rem 正在搜索...
for /f "delims=" %%i in ('dir /b /s "%REPOSITORY_PATH%\*lastUpdated*"') do (
    del /s /q %%i
)
rem 搜索完毕
pause

3.4 扩展构建管理和插件配置

构建概念：

项目构建是指将源代码、依赖库和资源文件等转换成可执行或可部署的应用程序的过程，在这个过程中包括编译源代码、链接依赖库、打包和部署等多个步骤。

主动出发场景：

重新编译：编译不充分，部分文件没有被编译！
打包：独立部署到外部服务器软件，打包部署。
部署本地或者私服仓库：maven 工程加入到本地或者私服仓库，供其他工程使用。

命令方式构建：

命令执行需要我们进入到项目的根路径 pom.xml 平级
部署必须是 jar包形式
语法：mvn 构建命令构建命令 ……

命令	描述
mvn clean	清理编译或打包后的项目结构，删除 target 文件夹
mvn compile	编译项目，生成 target 文件
mvn test	执行测试源码（测试）
mvn site	生成一个项目依赖信息的展示页面
mvn package	打包项目，生成 war / jar 文件
mvn install	打包后上传到 maven 本地仓库（本地部署）
mvn deploy	只打包，上传到 maven 私服仓库（私服部署）

可视化方式构建：

构建命令周期：

构建生命周期可以理解成一组固定构建命令的有序集合，触发周期后的命令，会自动触发周期前的命令！也是一种简化构建的思路！

清理周期：主要是对项目编译生成文件进行清理。包含命令：clean
默认周期：定义了真正构件时所需要执行的所有步骤，它是生命周期中最核心的部分。包含命令：compile - test - package - install / deploy
报告周期：包含命令：site 。打包：mvn clean package 。本地仓库： mvn clean install

最佳使用方案：

打包: mvn clean package
重新编译: mvn clean compile
本地部署: mvn clean install

周期、命令和插件：

周期 --> 包含若干个命令 --> 包含若干个插件！

使用周期命令构建，简化构建过程！

最终进行构建的是插件！

插件配置：

<build>
   <!-- jdk17 和 war包版本插件不匹配 -->
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.2.2</version>
        </plugin>
    </plugins>
</build>

（四）Maven继承和聚合特性

4.1 Maven工程继承关系

1.继承概念

Maven继承是指在Maven的项目中，让一个项目从另一个项目中继承配置信息的机制。继承可以让我们在多个项目中共享同一配置信息，简化项目的管理和维护工作。

2.继承作用

作用：在父工程中统一管理项目中的依赖信息，进行统一版本管理！

它的背景是：

对一个比较大型的项目进行了模块拆分。
一个project下面，创建了很多个module。
每一个module都需要配置自己的依赖信息。

需求是：

多个模块要使用同一个框架，它们应该是同一个版本，所以整个项目中使用的框架版本需要统一管理。
使用框架时所需要的 jar包组合（或者说依赖信息组合）需要经过长期摸索和反复调试，最终确定一个可用组合。

通过在父工程中为整个项目维护依赖信息和组合既保证了整个项目使用规范、准确的 jar 包；又能够将以往的经验沉淀下来，节约时间和精力。

3.继承语法

父工程：

<groupId>com.itzwf.maven</groupId>
<artifactId>pro03-maven-parent</artifactId>
<version>1.0-SNAPSHOT</version>
<!-- 当前工程作为父工程，它要去管理子工程，所以打包方式必须是 pom -->
<packaging>pom</packaging>

子工程：

<!-- 使用parent标签指定当前工程的父工程 -->
<parent>
  <!-- 父工程的坐标 -->
  <groupId>com.itzwf.maven</groupId>
  <artifactId>pro03-maven-parent</artifactId>
  <version>1.0-SNAPSHOT</version>
</parent>

<!-- 子工程的坐标 -->
<!-- 如果子工程坐标中的groupId和version与父工程一致，那么可以省略 -->
<!-- <groupId>com.itzwf.maven</groupId> -->
<artifactId>pro04-maven-module</artifactId>
<!-- <version>1.0-SNAPSHOT</version> -->

4.父工程依赖统一管理

父工程声明版本

<!-- 使用dependencyManagement标签配置对依赖的管理 -->
<!-- 被管理的依赖并没有真正被引入到工程 -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>4.0.0.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>4.0.0.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>4.0.0.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-expression</artifactId>
      <version>4.0.0.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>4.0.0.RELEASE</version>
    </dependency>
  </dependencies>
</dependencyManagement>

子工程引用版本

<!-- 子工程引用父工程中的依赖信息时，可以把版本号去掉。  -->
<!-- 把版本号去掉就表示子工程中这个依赖的版本由父工程决定。 -->
<!-- 具体来说是由父工程的dependencyManagement来决定。 -->
<dependencies>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-beans</artifactId>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-expression</artifactId>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-aop</artifactId>
  </dependency>
</dependencies>

4.2 Maven工程聚合关系

1.聚合概念

Maven聚合是指将多个项目组织到一个父级项目中，通过触发父工程的构建，统一按顺序触发子工程构建的过程！！

2.聚合作用

统一管理字项目构建：通过聚合，可以将多个子项目组织在一起，方便管理和维护。
优化构建顺序：通过聚合，可以对多个项目进行顺序控制，避免出现构建依赖混乱导致构建失败的情况。

3.聚合语法

父项目中包含的子项目列表。

<project>
  <groupId>com.example</groupId>
  <artifactId>parent-project</artifactId>
  <packaging>pom</packaging>
  <version>1.0.0</version>
  <modules>
    <module>child-project1</module>
    <module>child-project2</module>
  </modules>
</project>

4.聚合演示

通过触发父工程构建命令、引发所有子模块构建！产生反应堆！

（五）Maven核心掌握总结

核心点	掌握目标
安装	maven 安装、环境变量、maven配置文件修改
工程创建	GAVP属性理解、JavaSE/EE工程创建、项目构建
依赖管理	依赖添加、依赖传递、版本提取、导入依赖错误解决
构建管理	构建过程、构建场景、构建周期等
继承和聚合	理解继承和聚合作用、继承语法和实践、聚合语法和实践