第二章 Maven 的使用

2.1 Maven 的安装

2.1.1 Maven 软件的下载

为了使用 Maven 管理工具，我们首先要到官网去下载它的安装软件。通过百度搜索“Maven”如下：

点击 Download 链接，就可以直接进入到 Maven 软件的下载页面：

目前最新版是 apache-maven-3.8.1 版本，我们当时使用的是 apache-maven-3.6.3 版本，大家也可以下
载最新版本。Apache-maven-3.8.1 下载地址：https://mirrors.ocf.berkeley.edu/apache/maven/maven-3/3.8.1/binaries/apache-maven-3.8.1-bin.zip
下载后的版本如下:

2.1.2 Maven 软件的安装

Maven 下载后，将 Maven 解压到一个没有中文没有空格的路径下，比如 G:\Develpment 下面。
解压后目录结构如下：

bin:存放了 maven 的命令，比如我们前面用到的 mvn tomcat:run
boot:存放了一些 maven 本身的引导程序，如类加载器等
conf:存放了 maven 的一些配置文件，如 setting.xml 文件
lib:存放了 maven 本身运行所需的一些 jar 包
至此我们的 maven 软件就可以使用了，前提是你的电脑上之前已经安装并配置好了 JDK。

2.1.3 Maven 及 JDK 配置

电脑上需安装 java 环境，安装 JDK1.7 + 版本 （配置 JAVA_HOME 环境变量并将JAVA_HOME/bin 配置环境变量 path ），我们使用的是 JDK16 相关版本配置 MAVEN_HOME，变量值就是你的 maven 安装的路径（bin目录之前一级目录），然后在 path 中引用该路径：%MAVEN_HOME%bin。

2.1.4 Maven 软件版本测试

通过 mvn -v 命令检查 maven 是否安装成功，看到 maven 的版本为 3.6.3 及 java 版本为 16 即为安装成功。打开 cmd 命令，输入 mvn –v 命令，如下图：

我们发现 maven 的版本，及 jdk 的版本符合要求，这样我们的 maven 软件安装就成功了。

2.2 Maven 仓库

2.2.1 Maven 仓库的分类

maven 的工作需要从仓库下载一些 jar 包，如下图所示，本地的项目 A、项目 B 等都会通过 maven 软件从远程仓库（可以理解为互联网上的仓库）下载 jar 包并存在本地仓库，本地仓库就是本地文件夹，当第二次需要此 jar 包时则不再从远程仓库下载，因为本地仓库已经存在了，可以将本地仓库理解为缓存，有了本地仓库就不用每次从远程仓库下载了。下图描述了 maven 中仓库的类型：

• 本地仓库 ：用来存储从远程仓库或中央仓库下载的插件和 jar 包，项目使用一些插件或 jar 包，优先从本地仓库查找默认本地仓库位置在 ${user.dir}/.m2/repository，${user.dir}表示windows 用户目录。
• 远程仓库：如果本地需要插件或者 jar 包，本地仓库没有，默认去远程仓库下载。远程仓库可以在互联网内也可以在局域网内。
• 中央仓库 ：在 maven 软件中内置一个远程仓库地址 http://repo1.maven.org/maven2 ，它是中央仓库，服务于整个互联网，它是由 Maven 团队自己维护，里面存储了非常全的 jar 包，它包
  含了世界上大部分流行的开源项目构件。

2.2.2 Maven 本地仓库的配置

本课程是在无网的状态下学习，需要配置老师提供的本地仓库，将 “repository.rar”解压至自己的电脑上，我们解压在 G:\Develpment\maven_repo 目录下（可以放在没有中文及空格的目录下）。

在 MAVE_HOME/conf/settings.xml 文件中配置本地仓库位置（maven 的安装目录下）：

打开 settings.xml文件，配置如下：

2.2.3 全局 setting 与用户 setting

maven 仓库地址、私服等配置信息需要在 setting.xml 文件中配置，分为全局配置和用户配置。在 maven 安装目录下的有 conf/setting.xml 文件，此 setting.xml 文件用于 maven 的所有 project 项目，它作为 maven 的全局配置。如需要个性配置则需要在用户配置中设置，用户配置的 setting.xml 文件默认的位置在：${user.dir}/.m2/settings.xml 目录中, ${user.dir} 指 windows 中的用户目录。maven 会先找用户配置，如果找到则以用户配置文件为准，否则使用全局配置文件。

2.3 Maven 工程的认识

2.3.1 Maven 工程的目录结构

作为一个 maven 工程，它的 src目录和 pom.xml 是必备的。
进入 src目录后，我们发现它里面的目录结构如下：

src/main/java — 存放项目的 .java 文件
src/main/resources — 存放项目资源文件，如 spring, hibernate 配置文件
src/test/java — 存放所有单元测试.java 文件，如 JUnit 测试类
src/test/resources — 测试资源文件
target — 项目输出位置，编译后的class 文件会输出到此目录
pom.xml — maven 项目核心配置文件
注意：如果是普通的 java 项目，那么就没有webapp 目录。

2.3.2 Maven 工程的运行

进入 maven 工程目录（当前目录有 pom.xml 文件），运行 tomcat:run 命令。

根据上边的提示信息，通过浏览器访问：http://localhost:8080/maven-helloworld/

2.3.3 问题处理

如果本地仓库配置错误会报下边的错误:

分析：
maven 工程运行先从本地仓库找 jar 包，本地仓库没有再从中央仓库找，上边提示 downloading… 表示从中央仓库下载 jar，由于本地没有联网，报错。
解决：
在 maven 安装目录的 conf/setting.xml 文件中配置本地仓库，参考： “maven 仓库/配置本地仓库章节”。