Maven学习

1 Maven介绍

Maven就是是专门为Java项目打造的管理和构建工具，它的主要功能有：

提供了一套标准化的项目结构；
提供了一套依赖管理机制；
提供了一套标准化的构建流程（编译，测试，打包，发布……）。

1.1 Maven项目结构

一个使用Maven管理的普通的Java项目，它的目录结构默认如下：

项目的根目录a-maven-project是项目名，它有一个项目描述文件pom.xml，存放Java源码的目录是src/main/java，存放资源文件的目录是src/main/resources，存放测试源码的目录是src/test/java，存放测试资源的目录是src/test/resources，最后，所有编译、打包生成的文件都放在target目录里。这些就是一个Maven项目的标准目录结构。

1.2 Maven依赖管理

1.2.1 pom文件

项目描述文件pom.xml描述了项目的结构以及项目所需的依赖，它的内容长得像下面：

<project ...>
	<modelVersion>4.0.0</modelVersion>
	<groupId>com.itranswarp.learnjava</groupId>
	<artifactId>hello</artifactId>
	<version>1.0</version>
	<packaging>jar</packaging>
	<properties>
        ...
	</properties>
	<dependencies>
        <dependency>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
            <version>1.2</version>
        </dependency>
	</dependencies>
</project>

其中，groupId类似于Java的包名，项目组 ID，通常为组织名或公司网址的反写，artifactId类似于Java的类名，通常是项目名称，再加上version，一个Maven工程就是由groupId，artifactId和version作为唯一标识。我们在引用其他第三方库的时候，也是通过这3个变量确定。（坐标）

1.2.2 导入依赖

pom文件设置：
在pom中写入需要导入包的agv
settings文件
在settings文件中配置远程仓库地址（包从那里下载？），本地仓库地址（包下载到哪里？）
IDEA先检查下本地仓库有没有，有则用。没有就会从远程仓库下载或者执行maven命令下载

maven维护的中央仓库：repo1.maven.org、
其实我们使用的大多数第三方模块都是这个用法，例如，我们使用commons logging、log4j这些第三方模块，就是第三方模块的开发者自己把编译好的jar包发布到Maven的中央仓库中。
私有仓库是指公司内部如果不希望把源码和jar包放到公网上，那么可以搭建私有仓库。私有仓库总是在公司内部使用。
找坐标去哪里找：https://mvnrepository.com/
镜像仓库
除了可以从Maven的中央仓库下载外，还可以从Maven的镜像仓库下载。如果访问Maven的中央仓库非常慢，我们可以选择一个速度较快的Maven的镜像仓库。Maven镜像仓库定期从中央仓库同步。

<mirror>
    <id>huaweicloud</id>
    <name>mirror from maven huaweicloud</name>
    <mirrorOf>central</mirrorOf>
    <url>https://repo.huaweicloud.com/repository/maven/</url>
</mirror>

mirrorOf 的取值为 central，表示该配置为中央仓库的镜像，所有对于中央仓库的请求都会转到该镜像url地址。
依赖的特性

传递性
例如，我们的项目依赖abc这个jar包，而abc又依赖xyz这个jar包。当我们声明了abc的依赖时，Maven自动把abc和xyz都加入了我们的项目依赖，不需要我们自己去研究abc是否需要依赖xyz。
继承性
假设一个项目有多个module

如果A模块和B模块的依赖部分是相同的，可以可以提取出共同部分作为parent：

<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>com.itranswarp.learnjava</groupId>
    <artifactId>parent</artifactId>
    <version>1.0</version>
    <packaging>pom</packaging>

    <name>parent</name>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <java.version>11</java.version>
    </properties>

    <dependencies>
   <!--放A和B的共同依赖，不同依赖还是放在各自的pom中-->
   ...

    </dependencies>
</project>

注意到parent的是pom而不是jar，因为parent本身不含任何Java代码。编写parent的pom.xml只是为了在各个模块中减少重复的配置。
A模块的pom可简化为：

<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>
        <groupId>com.itranswarp.learnjava</groupId>
        <artifactId>parent</artifactId>
        <version>1.0</version>
        <relativePath>../parent/pom.xml</relativePath>
    </parent>

    <artifactId>module-a</artifactId>
    <packaging>jar</packaging>
    <name>module-a</name>
</project>

注意可继承依赖、版本等；
在根目录创建一个pom.xml统一编译：

<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>com.itranswarp.learnjava</groupId>
    <artifactId>parent</artifactId>
    <version>1.0</version>
    <packaging>pom</packaging>
	
    <modules>
        <module>module-a</module>
        <module>module-b</module>
        <module>module-c</module>
    </modules>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <java.version>11</java.version>
    </properties>

    <dependencies>
   <!--放A和B的共同依赖，不同依赖还是放在各自的pom中-->
   ...

    </dependencies>
</project>

1.3 Maven构建

1.3.1 生命周期及阶段

Maven 拥有三套标准的生命周期：

clean：用于清理项目
default：用于构建项目
Maven的生命周期由一系列阶段（phase）构成，以内置的生命周期default为例，它包含以下phase：

Maven另一个常用的生命周期是clean，它会执行3个phase：

pre-clean
clean （注意这个clean不是lifecycle而是phase）
post-clean

运行某个phase，它会运行它本身以及之前的所有phase。
在实际开发过程中，经常使用的命令有：

mvn clean：清理所有生成的class和jar；
mvn clean compile：先清理，再执行到compile；
mvn clean package：先清理，再执行到package。打jar包。
mvn clean install：先清理，再执行到install。打jar包并发布到本地仓库，供其它项目使用。

1.3.2 插件

上述maven阶段的执行依赖于插件，插件中有多个方法（goal），调用mvn phase就是在执行这些方法。
maven内置绑定

mvn test是执行测试用例，这里要注意测试类名应该以Test结果，测试方法以test开头，遵循规范，否则test可能执行不到。另外，如果打包或者install不需要test，可以设置跳过。

1.4 Maven私服

1.4.1 介绍

maven私服是部署在局域网上的特殊远程仓库，用来代理外部的远程仓库。
maven下载构件的顺序：
1.从本地仓库下载，本地没有，则从私服下载
2.私服有，则将构件下载到本地，若没有，则从外部远程仓库下载
3.外部远程仓库有，将构件下载并缓存到私服，若远程仓库也没有，则直接报错。

1.4.2 常见的Maven私服产品

JFrog的Artifacatory
Apache的Archiva
Sonatype的Nexus

2 常见问题

Q1：为什么Maven下载包失败后会出现.lastUpdated文件

A：Maven 本地仓库中出现 .lastUpdated 文件时导致下载依赖失败，主要与 Maven 的缓存机制和文件状态判断逻辑有关。
.lastUpdated 文件的作用

临时标记文件：
Maven 在下载依赖过程中，会先创建一个 .lastUpdated 临时文件（如 my-dependency.jar.lastUpdated），用于记录下载操作的开始时间和状态。
下载完成后的处理：
若下载成功，Maven 会删除 .lastUpdated 文件，并将临时文件重命名为正式文件（如 .jar 或 .pom）；若下载失败（如网络中断、仓库无资源），则保留 .lastUpdated 文件作为失败记录

Maven 在后续构建时，发现本地仓库中存在 .lastUpdated 文件，会认为该依赖已经尝试下载但未完成，从而跳过重新下载流程。这种设计是为了避免重复下载失败文件，但会导致依赖缺失时无法自动修复。
Maven 本地仓库中出现 .lastUpdated 文件时导致下载依赖失败，主要与 Maven 的缓存机制和文件状态判断逻辑有关。以下是具体原因及机制解析：

解决方案
(1) 删除 .lastUpdated 文件
手动删除：进入本地仓库目录，搜索并删除所有 .lastUpdated 文件（如通过 find 命令或 Windows 资源管理器搜索）。
脚本批量删除
(2) 强制更新依赖
在 Maven 命令中添加 -U 参数强制更新（即使存在缓存文件）：

mvn clean install -U

posted @ 2023-08-12 16:05 风一样的我1 阅读(88) 评论(0) 收藏举报

刷新页面返回顶部

pengu1998