实战讲解Maven安装及基本使用详解
前言
Apache Maven，是一个跨平台的软件项目管理及自动构建工具，由Apache软件基金会所提供。Maven主要服务于基于Java平台的项目构建、依赖管理和项目信息管理。Maven的目标是能够让开发者在最短的时间内了解项目开发工作的完整状态，主要包括以下几个方面：
•简化项目构建过程
•提供一个统一的项目构建系统
•通过POM(project object model)提供一个项目的重要信息
•为最佳项目开发实践提供一个指导方针
接下来本文就通过Maven的安装、基本的指令使用和一个实际的小例子来带你对Maven的使用有一个大体的认识。此外，本文的样例基于JDK1.8和Maven3。
环境准备
在安装Maven之前，首先要确保本地已安装JDK并配置好了JAVA_HOME环境变量，可以在cmd通过以下命令进行验证：
echo %JAVA_HOME% # 输出 JAVA_HOME 环境变量值 java -version # 输出 Java 版本信息
如果正常输出了JDK的安装路径及java的版本信息，那么就可以开始进行下一步了，否则，你可能需要先到官网下载一个JDK，并按照下图所示配置好环境变量：
安装Maven
在确认本地已安装好了JDK并配置了环境变量后，我们就可以开始安装Maven了，首先找到官网，然后找到安装包下载即可，本文以 3.6.3 版本为例：
在下载完成后，解压到本地文件夹即可，以我为例，我解压在 D 盘：
在解压完毕后，我们先进行环境变量的配置，配置一个名为M2_HOME的环境变量，对应值为个人的Maven文件夹位置：
然后在Path系统变量中配置%M2_HOME%\bin即可：
在配置完成并保存后，重新打开cmd，输入以下命令进行验证，如果均得到正确信息，便表明已经安装成功：
echo %M2_HOME% # 输出 Maven 的安装位置 mvn -v # 输出 Maven 的版本信息
注意
你可能会疑惑为什么我们下载了Maven3却要配置一个名为M2_HOME的环境变量，这主要是因为在Maven1时环境变量配置为MAVEN_HOME，在Maven2时改为了M2_HOME，而在Maven3则继续沿用了这个命名，不过在Maven3.5.0以后，官方也舍弃了M2_HOME，因此我们现在其实只需要在Path中配置D:\apache-maven-3.6.3\bin即可，不过本文依旧沿用了M2_HOME。
安装目录介绍
在正式讲解Maven的使用之前，我们先熟悉一下Maven的安装目录中各个文件夹的内容及作用（基于Maven3.6.3版本）：
bin
该文件夹下包含了mvn运行的脚本，这些脚本用来配置Java命令，准备好classpath和相关的Java系统属性，然后执行Java命令。其中mvn是基于UNIX平台的shell脚本，mvn.cmd是基于Windows平台的下的运行脚本。当我们在命令行中输入一条mvn命令时，其实就是在调用这些脚本。此外该文件夹中还包含了mvnDebug和mvnDebug.cmd这两个文件，该脚本包含了mvn脚本所有的功能，只是多了一条MAVEN_DEBUG_OPTS的配置，用于调试Maven。除此之外，该文件夹内还包含了m2.conf和mvnyjp文件，其中m2.conf是classworlds的配置文件，而mvnyjp则是为了配合Yourkit profiler的使用，关于classworlds和Yourkit profiler，本文不做介绍，感兴趣可以自行查找资料。
boot
该文件夹下只有一个plexus-classworlds的jar包和其相关的license文件，plexus-classworlds是一个类加载框架，Maven使用该框架来加载自己的类库。
conf
该文件下包含了一个我们以后接触最多的settings.xml文件，主要用于配置代理、镜像和插件等。
此外还包含了一个toolchains.xml配置文件和一个logging文件夹，其中toolchains.xml主要是为了方便我们指定项目所使用的JDK版本，需要配置maven-toolchains-plugin插件一起使用，而logging文件夹（内含一个名为simplelogger.properties的配置文件）则用于配置我们在使用Maven时的日志。
lib
该文件夹下包含了所有Maven在运行时所需要的一些库文件，这里就不做具体介绍了。
其它
此外还有LICENSE、NOTICE、README.txt用于说明开源协议和简单介绍的文件。
实战演练
下面我们就开始通过一个实际小案例来说明Maven的基本使用，为了加深对Maven中配置文件和基本指令的学习，我们就不使用IDEA等集成Maven的IDE了，直接使用VS CODE来进行接下来案例的讲解。
首先，我们先创建一个名为maven的文件夹，然后通过VS CODE打开，新建一个名为pom.xml的文件夹，并在其中输入以下内容：
<?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>com.butterfly.maven</groupId>
<artifactId>demo</artifactId>
<version>1.0-SNAPSHOT</version>
<!-- 可选 -->
<name>a demo maven project</name>
</project>
下面对该文件中的内容进行简单介绍：
文件的第一行是XML头，就像HTML中也有<!DOCTYPE html>头为了告诉标准通用标记语言解析器如何解析文档一般，在XML这里主要是为了指定文档的版本和编码方式。紧接着是project，主要声明了一些POM相关的命名空间和xsd元素，可以方便我们在使用IDE时编辑XML文档。在project这个根元素下还有四个同级的元素，下面再一一介绍：
- modelVersion：制定了当前POM模型的版本，对于Maven2和Maven3来说，这个值固定为 4.0.0。
- groupId：定义了项目属于哪个组，一般都是对应公司或组织的域名反写并加上项目名，例如公司域名为abc.com，项目名为demo，那么groupId就是com.abc.demo。
- artifactId：定义了在当前Maven项目中的唯一的ID，当项目包含多个子项目时，我们就需要特别注意命名方式。
- version：指定了当前项目的版本，SNAPSHOT意思是快照，即代表当前项目属于不稳定的版本。
- name：声明了一个让用户更容易理解的项目名称，改元素属于可选项。
然后，我们就开始正式编写项目的主代码，我们首先按照Maven规范，在maven文件夹下创建一个src/main/java目录，然后在该目录下再根据我们在XML中groupId和artifactId的命名，创建文件：com/butterfly/maven/demo/Sum.java，并写入以下内容：
package com.butterfly.maven.demo;
public class Sum {
private static int sum(int[] arr) {
int sum = 0;
for (int val : arr) {
sum += val;
}
return sum;
}
public static void main(String[] args) {
System.out.println(sum(new int[]{1, 3, 5, 7, 9}));
}
}
然后在项目的根目录下执行mvn clean compile命令进行编译，可以得到以下输出（第一次执行会下载很多插件依赖，下面输出中省略了这些下载输出）：
[INFO] Scanning for projects... [INFO] [INFO] ----------------------< com.butterfly.maven:demo >---------------------- [INFO] Building a demo maven project 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ demo --- [INFO] Deleting D:\Temp\maven\target [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ demo --- [INFO] skip non existing resourceDirectory D:\Temp\maven\src\main\resources [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ demo --- [INFO] Changes detected - recompiling the module! [INFO] Compiling 1 source file to D:\Temp\maven\target\classes [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 1.975 s [INFO] Finished at: 2020-10-02T21:27:55+08:00 [INFO] ------------------------------------------------------------------------
其中clean用于告诉Maven清理输出目录target/，compile告诉Maven编译项目主代码，从上面的输出中也可以看出Maven首先执行了maven-clean-plugin:2.5:clean进行删除了target目录，然后执行了maven-resources-plugin:2.6:resources，由于项目中不存在resources文件，因此跳过了，最后执行了maven-compiler-plugin:3.1:compile对主代码进行编译，并将编译的结果放到target/classes目录下，如下图所示：
接下来，我们再编写测试的代码，首先我们依旧按照Maven规范，在src/目录下继续创建test/java目录，然后在编写正式的测试代码之前，让我们先引入JUnit的依赖，我们需要将pom.xml进行如下修改：
<!-- 添加在 project 根元素下 -->
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
<scope>test</scope>
</dependency>
</dependencies>
然后我们就可以编写我们的测试代码了，我们在src/test/java/目录下，创建demo/SumTest.java文件，并写入以下内容：
package demo;
import org.junit.Test;
import static com.butterfly.maven.demo.Sum.sum;
import static org.junit.Assert.assertEquals;
public class SumTest {
@Test
public void testSum() {
assertEquals(10, sum(new int[]{1, 2, 3, 4}));
}
}
然后我们在根目录下开启终端，并运行mvn clean test指令（第一次运行同样会下载一些插件，这里也省略了这些下载输出），可以在终端中得到以下信息：
[INFO] Scanning for projects... [INFO] [INFO] ----------------------< com.butterfly.maven:demo >---------------------- [INFO] Building a demo maven project 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ demo --- [INFO] Deleting D:\Temp\maven\target [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ demo --- [INFO] skip non existing resourceDirectory D:\Temp\maven\src\main\resources [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ demo --- [INFO] Changes detected - recompiling the module! [INFO] Compiling 1 source file to D:\Temp\maven\target\classes [INFO] [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ demo --- [INFO] skip non existing resourceDirectory D:\Temp\maven\src\test\resources [INFO] [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ demo --- [INFO] Changes detected - recompiling the module! [INFO] Compiling 1 source file to D:\Temp\maven\target\test-classes [INFO] [INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ demo --- [INFO] Surefire report directory: D:\Temp\maven\target\surefire-reports ------------------------------------------------------- T E S T S ------------------------------------------------------- Running demo.SumTest Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.091 sec Results : Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 3.166 s [INFO] Finished at: 2020-10-02T22:17:30+08:00 [INFO] ------------------------------------------------------------------------
根据输出可以发现，执行mvn clean test同样也执行了mvn clean compile中的clean、resources、compile这三个指定，不同的是，这里还多了对测试包中进行的三个操作，分别是testResources、testCompile和test，随后打印了执行单元测试后的输出，可以发现执行了一个测试（即为我们建立的testSum测试方法），并且没有失败的测试。
注意
对于不同版本的Maven，在第一次执行上述操作的时候，可能会有关于JDK版本方面的报错，提示我们编译版本过低，这时就需要在pom.xml中添加如下配置：
<!-- 添加在 project 根元素下 --> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> </plugins> </build>
此外，由于Maven在安装依赖时，默认是从国外网址下载，因此为了加快下载速度，我们需要配置国内的镜像，这时我们就需要对settings.xml文件进行修改，这里建议在修改之前做一个备份。打开settings.xml后，通过查找找到mirrors标签，然后在内部添加如下配置即可：
<mirror> <id>alimaven</id> <name>aliyun maven</name> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <mirrorOf>central</mirrorOf> </mirror>
还有一点需要注意的是，所有的依赖包默认下载的位置是~/.m2/repository，这里的~代表的个人的用户目录，对我而言就是对应C:/Users/zjw/.m2/repository。因此，如果不想将jar包放在 C 盘，就需要和mirrors同级，然后加入以下配置：
<localRepository>D:/jar</localRepository>
这样，所有的依赖都会保存在D:/jar目录下了。
打包及运行
在Maven里，我们只要通过mvn clean package命令就可以对项目进行打包了（默认打包类型为jar），我们在cmd中输入以上指令，可以得到下面的输出（省略了和以上指令中相同的前几个输出）：
[INFO] [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ demo --- [INFO] Building jar: D:\Temp\maven\target\demo-1.0-SNAPSHOT.jar [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS
执行完毕后，我们就可以在target/目录下发现我们生成的jar包了。此外，如果我们想要像引用其它jar包一样，在其它的项目中引入我们自己的jar包也是可以的，但是如果每次都要将jar包一个一个地复制到其他项目中是非常麻烦的，但是通过Maven，我们只需要一个mvn clean install命令就可以将当前项目的jar包安装到本地仓库：
可以发现和mvn clean package相比，又多了如下几行输出：
[INFO] --- maven-install-plugin:2.4:install (default-install) @ demo --- [INFO] Installing D:\Temp\maven\target\demo-1.0-SNAPSHOT.jar to D:\jar\com\butterfly\maven\demo\1.0-SNAPSHOT\demo-1.0-SNAPSHOT.jar [INFO] Installing D:\Temp\maven\pom.xml to D:\jar\com\butterfly\maven\demo\1.0-SNAPSHOT\demo-1.0-SNAPSHOT.pom
按照信息，我们可以知道，我们生成的jar包被保存在了D:/jar/com/butterfly/maven/demo/1.0-SNAPSHOT/目录下，我们可以打开文件资源管理器进行验证：
这样，我们就可以在其它项目中，通过以下配置来引用我们自己的jar包了：
<dependency> <groupId>com.butterfly.maven</groupId> <artifactId>demo</artifactId> <version>1.0-SNAPSHOT</version> </dependency>
不过，到目前为止，我们仍然没有运行主代码中的main函数部分，由于默认生成的jar包中缺少manifest配置，因此上文生成的jar包并没有办法直接运行，为了生成能够执行的jar包，我们还需要在pom.xml加入以下配置：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>1.2.1</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<transformers>
<transformer implementation="org.apache.maven.plugins.
shade.resource.ManifestResourceTransformer">
<mainClass>com.butterfly.maven.demo.Sum</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
再次执行mvn clean install命令，可以发现target/目录下有两个jar包：
其中orgin开头的jar包则对用我们之前无法直接执行的jar包，另外一个则是可以直接执行的，我们可以进行测试：
大功告成！
总结
本文简单介绍了Maven，并讲解了Maven的安装和几个基本的命令的使用，在之后我还会继续讲解Maven其他方面的知识，希望能够对你有所帮助。
参考资料
《Maven 实战》
https://maven.apache.org/what-is-maven.html
到此这篇关于实战讲解Maven安装及基本使用详解的文章就介绍到这了,更多相关Maven安装及基本使用内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！
相关推荐
-
详解Maven私服Nexus的安装与使用
本文介绍了详解Maven私服Nexus的安装与使用,分享给大家,具体如下: 1.安装 1.1 安装docker并加速 yum update && yum install docker sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://y7u9p3i0.mirror.aliyuncs.com"
-
详解Maven安装教程及是否安装成功
一.准备工作 1.确定电脑上已经成功安装jdk7.0以上版本 2.win10操作系统 3.maven安装包 下载地址:http://maven.apache.org/download.cgi 二.解压Maven安装包 在上述地址中下载最新的Maven版本,解压到指定目录(此处根据自己的需要),本人解压到了D:\install\maven\apache-maven-3.5.0目录下,里面有bin.libconf等文件夹. 三.配置Maven环境变量 在我的电脑-------属性-------高级系
-
maven的安装配置以及在IDEA中的配置图文教程
一.下载maven: 1.maven官网:http://maven.apache.org/download.cgi 二.安装配置 1.下载后解压到本地目录,如图 2.配置环境变量:我的电脑右键->属性->高级系统设置->环境变量 系统变量中新建一个名字为MAVEN_HOME的变量, MAVEN_HOME=D:\Java\apache-maven-3.5.2 然在path中加入 %MAVEN_HOME%\bin; 配置完成. 打开 cmd,在里面敲:mvn -version 如果能打印如上
-
Maven安装及MyEclipse中使用Maven
本文主要为大家分享了MyEclipse中安装使用Maven的方法,供大家参考,具体内容如下 Step1:下载mavenhttp://maven.apache.org/download.cgi,下载好后解压到一个路径中 Step2:配置环境变量, 新建变量名:MAVEN_HOME 变量值:D:\Maven\apache-maven-3.3.9 编辑变量名:Path 在最前面加上:%MAVEN_HOME%\bin;(分号作为分隔符,必须) Step3:检测是否安装成功 在命令行中输入mvn -ver
-
Maven 安装目录的详细介绍
Maven 安装目录的详细介绍 前言: Maven 作为一款优秀的构建工具.依赖管理工具和项目管理工具,已经被业界广泛应用,我们可以利用 Maven 对项目进行清理.测试.构建.打包.部署等操作.在此,我们就 Maven 的安装目录,进行解读. 正文 从 Apache Maven 官网下载 Maven 的安装包并解压之后,进入安装目录,我们会看到如下内容: bin boot conf lib LICENSE.txt NOTICE.txt README.txt 接下来,分别解读以上目录的内容及功能
-
window下安装和配置maven环境
本文实例为大家分享了安装和配置maven环境的具体步骤,供大家参考,具体内容如下 下载maven: 1.进入官网下载:http://maven.apache.org/download.cgi 注意事项:(截至目前2015年12月1日)最新版本的Maven3.3.9必须在JDK1.7版本以上运行. 2.下载后复制到我们自己心仪的目录解压即可. 配置maven的环境变量: 1.计算机-鼠标右键选择属性-高级系统设置-环境变量,然后新建一个变量名为M2_HOME,变量值为maven安装目录,确定保存.
-
Maven安装与配置图文教程
本文为大家分享了Maven安装与配置教程,供大家参考,具体内容如下 一.需要准备的东西 1. JDK 2. Eclipse 3. Maven程序包 二.下载与安装 1. 前往这里下载最新版的Maven程序: 2. 将文件解压到D:\Program Files\Apache\maven目录下: 3. 新建环境变量MAVEN_HOME,赋值D:\Program Files\Apache\maven 4. 编辑环境变量Path,追加%MAVEN_HOME%\bin\; 5. 至此,maven已经完成了
-
将本地jar包安装进入maven仓库(实现方法)
实际项目中pom.xml依赖写法: <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context-support</artifactId> <version>3.1.0.RELEASE</version> </dependency> Maven 安装 JAR 包的命令是: mvn install:install-fi
-
实战讲解Maven安装及基本使用详解
前言 Apache Maven,是一个跨平台的软件项目管理及自动构建工具,由Apache软件基金会所提供.Maven主要服务于基于Java平台的项目构建.依赖管理和项目信息管理.Maven的目标是能够让开发者在最短的时间内了解项目开发工作的完整状态,主要包括以下几个方面: •简化项目构建过程 •提供一个统一的项目构建系统 •通过POM(project object model)提供一个项目的重要信息 •为最佳项目开发实践提供一个指导方针 接下来本文就通过Maven的安装.基本的指令使用和一个实际
-
教你安装eclipse2021并配置内网maven中心仓库的图文详解
下载Eclipse2021并运行安装包,选择Eclipse IDE for Java Developers 默认安装路径 ,点击 INSTALL进行安装 安装 中... 安装完成,点击LAUNCH启动Eclipse2021 选择默认工作空间 启 动并加载插件中... 成功启动并显示IDE界面 下面是内网Maven仓库 登陆内网仓库 并复制中心仓库地址: 添加maven路径 添加前提是你先安装好maven,这里安装的是maven 3.8.1 点击Finish完成添加 添加成功后会显示如下 添加m
-
Mac下安装tomcat的教程详解
1.到 apache官方主页 http://tomcat.apache.org 下载 Mac 版本的完整 tar.gz文件包.解压拷贝到 /Library 目录下,并命名为Tomcat,其他目录也可以,我这就以/Library做讲解. 2.打开终端,直接输入 sudo chmod 755 /Library/Tomcat/bin/*.sh ,按回车键之后可能会提示输入密码,请输入管理员密码,这是修改bin目录下的*.sh文件的权限 cd 到/LibraryTomcat/bin目录下,输入:sudo
-
基于Maven的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/maven-v4_0_0.xsd "> <!-- 父项
-
java 中maven pom.xml文件教程详解
maven 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/maven-v4_0_0.x
-
maven 环境变量的配置详解
我的电脑是win10_64位的. 一.安装,我使用的是免安装版的,直接解压缩就可以使用. 二.配置环境变量. 1. 打开环境变量配置.右键计算机→属性→高级系统设置→高级→环境变量,在系统变量中配置. 2. 配置MAVEN_HOME.在系统变量中新建,变量名MAVEN_HOME,变量值,maven文件夹路径,我的路径是F:\Wab\资料\maven\资料\apache-maven-3.2.3,最好不要有中文,我比较懒,不想改,保存. 3.配置path,找到path系统变量,点开,新建,输入%MA
-
Python干货实战之八音符酱小游戏全过程详解
目录 导语
-
Java 实战项目之疫情人员流动管理系统详解
一.项目简述 本系统主要实现的功能有: 社区疫情流动人员管理系统,住户管理,出入管理,访客管理,体温录入,高风险警示等等. 二.项目运行 环境配置: Jdk1.8 + Tomcat8.5 + mysql + Eclispe(IntelliJ IDEA,Eclispe,MyEclispe,Sts都支持) 项目技术: Springboot+ SpringMVC + MyBatis + Jsp + Html+ JavaScript + JQuery + Ajax + maven等等 系统用户后台管理代
-
Python实战项目刮刮乐的实现详解流程
目录 导语 正文 1)环境安装 2)正式敲代码 2.1定义必要常量 2.2设置随机读取图片 2.3主程序 3)效果图展示 3.1 part 随机图一 3.2 part 随机图二 3.3 part 随机图三 总结 导语 在CSDN学习的过程中,遇到了爆火的文章是关于刮刮卡的! 大家猜猜看是谁写的? 我看这文章都特别火,我也感觉挺好玩的,那就寻思用 Python肯定也能做呀! 这不?今天还有时间,那就带大家写一款刮刮乐的小程序吧~ 正文 1)环境安装 准备好Python3.Pycharm.Pygam
-
Mysql免安装版设置密码教程详解
方法1: 用SET PASSWORD命令 MySQL -u root mysql> SET PASSWORD FOR 'root'@'localhost' = PASSWORD('newpass'); 方法2:用mysqladmin mysqladmin -u root password "newpass" 如果root已经设置过密码,采用如下方法 mysqladmin -u root password oldpass "newpass" 方法3: 用UPDA