当前位置: 首页 > article >正文

Maven 使用指南:基础 + 进阶 + 高级用法

目录

前言

        Maven 是 Java 生态中最流行的项目管理和构建工具之一。它通过 pom.xml 文件管理项目的依赖、构建生命周期和插件配置。本文将从基础到高级,全面复习 Maven 的用法,并提供详细的代码示例和注意事项。同时,我们将深入探讨 dependencyManagement 标签的作用,并解释 Maven 中所有重要标签的用法。

1. 基础用法

1.1 Maven 安装与配置

1.3 pom.xml 基础配置

1.4 常用命令

2. 进阶用法

2.1 依赖管理

2.2 插件配置

2.3 多模块项目

3. 高级用法

3.1 自定义生命周期

3.2 使用 Profile

3.3 依赖管理 ( )

3.4 使用自定义仓库

4. Maven 标签详解

4.1 核心标签

4.2 代码示例

5. 注意事项


前言

        Maven 是 Java 生态中最流行的项目管理和构建工具之一。它通过 pom.xml 文件管理项目的依赖、构建生命周期和插件配置。本文将从基础到高级,全面复习 Maven 的用法,并提供详细的代码示例和注意事项。同时,我们将深入探讨 dependencyManagement 标签的作用,并解释 Maven 中所有重要标签的用法。

1. 基础用法

1.1 Maven 安装与配置

  1. 下载 Maven
    • 从 Maven 官网 下载最新版本。
  2. 配置环境变量
    • 将 Maven 的 bin 目录添加到系统的 PATH 环境变量中。
    • 示例(Linux/Mac):
export PATH=$PATH:/path/to/maven/bin
    • 示例(Windows):
      • 在系统环境变量中添加 PATH,值为 C:\path\to\maven\bin
  1. 验证安装
mvn -v

 出现版本号信息即安装配置成功。

1.3 pom.xml 基础配置

pom.xml 是 Maven 的核心配置文件。以下是一个简单的示例:

<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.example</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0-SNAPSHOT</version>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.2</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

1.4 常用命令

命令描述
mvn clean清理项目,删除 target 目录。
mvn compile编译项目源代码。
mvn test运行单元测试。
mvn package打包项目(如生成 JAR 文件)。
mvn install将项目安装到本地仓库。
mvn deploy将项目部署到远程仓库。

2. 进阶用法

2.1 依赖管理

  1. 添加依赖: 在 pom.xml 的 <dependencies> 部分添加依赖项。例如:
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>2.7.0</version>
    </dependency>
</dependencies>
  1. 依赖范围 (<scope>)
    • compile:默认值,编译、测试和运行时都可用。
    • provided:编译和测试时可用,运行时由容器提供。
    • runtime:测试和运行时可用,编译时不可用。
    • test:仅在测试时可用。
  2. 排除传递依赖: 使用 <exclusions> 排除不需要的传递依赖:
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.7.0</version>
    <exclusions>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2.2 插件配置

Maven 插件用于扩展构建功能。以下是一个编译插件的配置示例:

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>
    </plugins>
</build>

2.3 多模块项目

  1. 父 pom.xml
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>parent-project</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>
    <modules>
        <module>module1</module>
        <module>module2</module>
    </modules>
</project>

子模块 pom.xml

<project>
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>parent-project</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <artifactId>module1</artifactId>
</project>

3. 高级用法

3.1 自定义生命周期

Maven 的生命周期包括 cleandefaultsite。可以通过插件自定义生命周期阶段。例如:

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-antrun-plugin</artifactId>
            <version>3.0.0</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>run</goal>
                    </goals>
                    <configuration>
                        <tasks>
                            <echo>Custom task during package phase</echo>
                        </tasks>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

3.2 使用 Profile

Profile 用于根据环境(如开发、测试、生产)配置不同的构建选项。例如:

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <env>development</env>
        </properties>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
    </profile>
    <profile>
        <id>prod</id>
        <properties>
            <env>production</env>
        </properties>
    </profile>
</profiles>

激活 Profile:

mvn clean install -Pprod

3.3 依赖管理 (<dependencyManagement>)

<dependencyManagement> 用于统一管理依赖版本,避免版本冲突。它不会实际引入依赖,而是为子模块或依赖项提供版本管理。例如:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.7.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

在子模块中使用时,无需指定版本:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

3.4 使用自定义仓库

如果默认仓库无法满足需求,可以配置自定义仓库:

<repositories>
    <repository>
        <id>custom-repo</id>
        <url>https://example.com/maven-repo</url>
    </repository>
</repositories>

4. Maven 标签详解

4.1 核心标签

标签描述
<project>根标签,定义 POM 文件。
<modelVersion>POM 模型版本,通常为 4.0.0
<groupId>项目组 ID,通常为组织或公司名称。
<artifactId>项目名称。
<version>项目版本。
<packaging>项目打包方式(如 jarwarpom)。
<dependencies>定义项目依赖。
<dependency>定义单个依赖项。
<scope>定义依赖项的作用范围(如 compiletest)。
<exclusions>排除传递依赖。
<build>定义构建配置。
<plugins>定义插件。
<plugin>定义单个插件。
<properties>定义项目属性。
<profiles>定义构建 Profile。
<profile>定义单个 Profile。
<modules>定义多模块项目的子模块。
<parent>定义父项目。
<dependencyManagement>统一管理依赖版本。

4.2 代码示例

<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.2</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

5. 注意事项

  1. 依赖冲突
    • 使用 mvn dependency:tree 查看依赖树,解决冲突。
  2. 构建性能
    • 避免引入不必要的依赖,减少构建时间。
  3. 版本管理
    • 使用 <dependencyManagement> 统一管理依赖版本。
  4. 插件兼容性
    • 确保插件版本与 Maven 版本兼容。


http://www.kler.cn/a/576329.html

相关文章:

  • 【JavaWeb】Web基础概念
  • 嵌入式中Type-C 与快充相关知识详解
  • let、const和var的区别是什么?
  • Unity自定义区域UI滑动事件
  • 【第19节】C++设计模式(行为模式)-Command(命令)模式
  • ECharts中yAxisIndex的作用
  • Java面试第十山!《Mybatis框架》
  • 鸿蒙应用开发深度解析:API 14核心特性与实战指南
  • 低空经济快速发展,无人机人才培养及校企实验室共建技术详解
  • Java UDP 通信:实现简单的 Echo 服务器与客户端
  • c#结合IL(中间语言)分析Try-Catch的内部机制及其对性能的影响
  • 信奥赛CSP-J复赛集训(模拟算法专题)(4):P1046 [NOIP 2005 普及组] 陶陶摘苹果
  • 小程序事件系统 —— 32 事件系统 - 事件分类以及阻止事件冒泡
  • 物联网 铁路“一杆一档”管理模式
  • v-code-diff 配置
  • HTML 属性详解:为网页元素赋予更多功能
  • 设计模式--单例模式(Singleton)【C++】
  • 分布式存储学习——HBase概述
  • linux上安装redis[从0到1]
  • Jenkins在Windows上的使用(二):自动拉取、打包、部署