第2章 Maven 的使用

2.1 Maven 的安装

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

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

目前最新版是 apache-maven-3.6.1 版本，我们当时使用的是apache-maven-3.5.2 版本，大家也可以下载最新版本。
Apache-maven-3.5.2 下载地址：http://archive.apache.org/dist/maven/maven-3/
下载后的版本如下:

• 2.1.2 Maven 软件的安装
  Maven 下载后，将 Maven 解压到一个没有中文没有空格的路径下，比如 D:\software\maven 下面。
  解压后目录结构如下：

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

• 2.1.3 JDK 的准备及统一
  本次课程我们所使用工具软件的统一，JDK 使用 JDK8版本

  • 1. JDK 环境:

• 2.1.4 Maven 及 及 JDK 配置
  电脑上需安装 java 环境，安装 JDK1.7 + 版本 （将JAVA_HOME/bin 配置环境变量 path ），我们使用的是JDK8 相关版本配置 MAVEN_HOME ，变量值就是你的 maven 安装 的路径（bin目录之前一级目录）

上面配置了我们的 Maven 软件，注意这个目录就是之前你解压 maven 的压缩文件包在的的目录，最好不要有中文和空格。

• 2.1.5 Maven 软件版本测试
  通过 mvn -v命令检查 maven 是否安装成功，看到 maven 的版本为 3.5.2 及 java 版本为 1.8 即为安装成功。
  找开 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}表示windows 用户目录。

远程仓库：如果本地需要插件或者 jar 包，本地仓库没有，默认去远程仓库下载。远程仓库可以在互联网内也可以在局域网内。
中央仓库 ：在 maven 软件中内置一个远程仓库地址http://repo1.maven.org/maven2 ，它是中央仓库，服务于整个互联网，它是由 Maven 团队自己维护，里面存储了非常全的 jar 包，它包含了世界上大部分流行的开源项目构件。

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

在 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} 指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 仓库/配置本地仓库章节”。