Maven教程

骑猪看日落 2023-10-14 17:23 42阅读 0赞

## 1.Maven是什么？ ##

Maven是一个基于Java的项目管理和构建工具。它提供了一种标准化的项目结构和构建过程，可以自动化项目的构建、依赖管理和文档生成等任务。Maven使用XML文件来描述项目的配置信息，通过定义项目的依赖关系和构建过程，可以方便地管理项目的开发和发布。Maven还提供了一系列插件和扩展，使开发人员能够更灵活地定制和扩展构建过程。

> Maven 翻译为"专家"、"内行"，是 Apache 下的一个纯 Java 开发的开源项目。基于项目对象模型（缩写：POM）概念，Maven利用一个中央信息片断能管理一个项目的构建、报告和文档等步骤。
> 
> Maven 是一个项目管理工具，可以对 Java 项目进行构建、依赖管理。
> 
> Maven 也可被用于构建和管理各种项目，例如 C\#，Ruby，Scala 和其他语言编写的项目。Maven 曾是 Jakarta 项目的子项目，现为由 Apache 软件基金会主持的独立 Apache 项目。

## 2.Maven的特点 ##

>  *  项目设置遵循统一的规则。
>  *  任意工程中共享。
>  *  依赖管理包括自动更新。
>  *  一个庞大且不断增长的库。
>  *  可扩展，能够轻松编写 Java 或脚本语言的插件。
>  *  只需很少或不需要额外配置即可即时访问新功能。
>  *  **基于模型的构建** − Maven能够将任意数量的项目构建到预定义的输出类型中，如 JAR，WAR 或基于项目元数据的分发，而不需要在大多数情况下执行任何脚本。
>  *  **项目信息的一致性站点** − 使用与构建过程相同的元数据，Maven 能够生成一个网站或PDF，包括您要添加的任何文档，并添加到关于项目开发状态的标准报告中。
>  *  **发布管理和发布单独的输出** − Maven 将不需要额外的配置，就可以与源代码管理系统（如 Subversion 或 Git）集成，并可以基于某个标签管理项目的发布。它也可以将其发布到分发位置供其他项目使用。Maven 能够发布单独的输出，如 JAR，包含其他依赖和文档的归档，或者作为源代码发布。
>  *  **向后兼容性** − 您可以很轻松的从旧版本 Maven 的多个模块移植到 Maven 3 中。
>  *  子项目使用父项目依赖时，正常情况子项目应该继承父项目依赖，无需使用版本号，
>  *  **并行构建** − 编译的速度能普遍提高20 - 50 %。
>  *  **更好的错误报告** − Maven 改进了错误报告，它为您提供了 Maven wiki 页面的链接，您可以点击链接查看错误的完整描述。

## 3.Maven POM ##

POM( Project Object Model，项目对象模型 ) 是 Maven 工程的基本工作单元，是一个XML文件，包含了项目的基本信息，用于描述项目如何构建，声明项目依赖，等等。

执行任务或目标时，Maven 会在当前目录中查找 POM。它读取 POM，获取所需的配置信息，然后执行目标。

POM 中可以指定以下配置：

*  项目依赖
 *  插件
 *  执行目标
 *  项目构建 profile
 *  项目版本
 *  项目开发者列表
 *  相关邮件列表信息

## 4.Maven 构建生命周期 ##

Maven 构建生命周期定义了一个项目构建跟发布的过程。

一个典型的 Maven 构建（build）生命周期是由以下几个阶段的序列组成的：

![d5ca62c53bc3c9eb91c1990fbdd42582.png][]

<table> 
 <thead> 
  <tr> 
   <th>阶段</th> 
   <th>处理</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>验证 validate</td> 
   <td>验证项目</td> 
   <td>验证项目是否正确且所有必须信息是可用的</td> 
  </tr> 
  <tr> 
   <td>编译 compile</td> 
   <td>执行编译</td> 
   <td>源代码编译在此阶段完成</td> 
  </tr> 
  <tr> 
   <td>测试 Test</td> 
   <td>测试</td> 
   <td>使用适当的单元测试框架（例如JUnit）运行测试。</td> 
  </tr> 
  <tr> 
   <td>包装 package</td> 
   <td>打包</td> 
   <td>创建JAR/WAR包如在 pom.xml 中定义提及的包</td> 
  </tr> 
  <tr> 
   <td>检查 verify</td> 
   <td>检查</td> 
   <td>对集成测试的结果进行检查，以保证质量达标</td> 
  </tr> 
  <tr> 
   <td>安装 install</td> 
   <td>安装</td> 
   <td>安装打包的项目到本地仓库，以供其他项目使用</td> 
  </tr> 
  <tr> 
   <td>部署 deploy</td> 
   <td>部署</td> 
   <td>拷贝最终的工程包到远程仓库中，以共享给其他开发人员和工程</td> 
  </tr> 
 </tbody> 
</table>

为了完成 default 生命周期，这些阶段（包括其他未在上面罗列的生命周期阶段）将被按顺序地执行。

Maven 有以下三个标准的生命周期：

*  **clean**：项目清理的处理
 *  **default(或 build)**：项目部署的处理
 *  **site**：项目站点文档创建的处理

### 构建阶段由插件目标构成 ###

一个插件目标代表一个特定的任务（比构建阶段更为精细），这有助于项目的构建和管理。这些目标可能被绑定到多个阶段或者无绑定。不绑定到任何构建阶段的目标可以在构建生命周期之外通过直接调用执行。这些目标的执行顺序取决于调用目标和构建阶段的顺序。

例如，考虑下面的命令：

clean 和 pakage 是构建阶段，dependency:copy-dependencies 是目标

mvn clean dependency:copy-dependencies package

这里的 clean 阶段将会被首先执行，然后 dependency:copy-dependencies 目标会被执行，最终 package 阶段被执行。

## 5.Maven 仓库 ##

在 Maven 的术语中，仓库是一个位置（place）。

Maven 仓库是项目中依赖的第三方库，这个库所在的位置叫做仓库。

在 Maven 中，任何一个依赖、插件或者项目构建的输出，都可以称之为构件。

Maven 仓库能帮助我们管理构件（主要是JAR），它就是放置所有JAR文件（WAR，ZIP，POM等等）的地方。

Maven 仓库有三种类型：

*  本地（local）
 *  中央（central）
 *  远程（remote）

### 本地仓库 ###

Maven 的本地仓库，在安装 Maven 后并不会创建，它是在第一次执行 maven 命令的时候才被创建。

运行 Maven 的时候，Maven 所需要的任何构件都是直接从本地仓库获取的。如果本地仓库没有，它会首先尝试从远程仓库下载构件至本地仓库，然后再使用本地仓库的构件。

默认情况下，不管Linux还是 Windows，每个用户在自己的用户目录下都有一个路径名为 .m2/repository/ 的仓库目录。

### 中央仓库 ###

Maven 中央仓库是由 Maven 社区提供的仓库，其中包含了大量常用的库。

中央仓库包含了绝大多数流行的开源Java构件，以及源码、作者信息、SCM、信息、许可证信息等。一般来说，简单的Java项目依赖的构件都可以在这里下载到。

中央仓库的关键概念：

*  这个仓库由 Maven 社区管理。
 *  不需要配置。
 *  需要通过网络才能访问。

要浏览中央仓库的内容，maven 社区提供了一个 URL：[Maven Central Repository Search][]。使用这个仓库，开发人员可以搜索所有可以获取的代码库。

### 远程仓库 ###

如果 Maven 在中央仓库中也找不到依赖的文件，它会停止构建过程并输出错误信息到控制台。为避免这种情况，Maven 提供了远程仓库的概念，它是开发人员自己定制仓库，包含了所需要的代码库或者其他工程中用到的 jar 文件。

### 6.Maven 依赖搜索顺序 ###

当我们执行 Maven 构建命令时，Maven 开始按照以下顺序查找依赖的库：

每个生命周期中都包含着一系列的阶段(phase)。这些 phase 就相当于 Maven 提供的统一的接口，然后这些 phase 的实现由 Maven 的插件来完成。

我们在输入 mvn 命令的时候 比如 mvn clean，clean 对应的就是 Clean 生命周期中的 clean 阶段。但是 clean 的具体操作是由 **maven-clean-plugin** 来实现的。

所以说 Maven 生命周期的每一个阶段的具体实现都是由 Maven 插件实现的。

Maven 实际上是一个依赖插件执行的框架，每个任务实际上是由插件完成。Maven 插件通常被用来：

*  **步骤 1** － 在本地仓库中搜索，如果找不到，执行步骤 2，如果找到了则执行其他操作。
 *  **步骤 2** － 在中央仓库中搜索，如果找不到，并且有一个或多个远程仓库已经设置，则执行步骤 4，如果找到了则下载到本地仓库中以备将来引用。
 *  **步骤 3** － 如果远程仓库没有被设置，Maven 将简单的停滞处理并抛出错误（无法找到依赖的文件）。
 *  **步骤 4** － 在一个或多个远程仓库中搜索依赖的文件，如果找到则下载到本地仓库以备将来引用，否则 Maven 将停止处理并抛出错误（无法找到依赖的文件）。
 *  ## 7.Maven 插件 ##
    
    Maven 有以下三个标准的生命周期：
 *  **clean**：项目清理的处理
 *  **default(或 build)**：项目部署的处理
 *  **site**：项目站点文档创建的处理
 *  创建 jar 文件
 *  创建 war 文件
 *  编译代码文件
 *  代码单元测试
 *  创建工程文档
 *  创建工程报告

## 8.Maven 构建 Java 项目 ##

Maven 使用原型 **archetype** 插件创建项目。要创建一个简单的 Java 应用，我们将使用 **maven-archetype-quickstart** 插件。

在下面的例子中，我们将在 C:\\MVN 文件夹下创建一个基于 maven 的 java 应用项目。

命令格式如下：

mvn archetype:generate "-DgroupId=com.companyname.bank" "-DartifactId=consumerBanking" "-DarchetypeArtifactId=maven-archetype-quickstart" "-DinteractiveMode=false"

参数说明：

*  **-DgroupId**: 组织名，公司网址的反写 + 项目名称
 *  **-DartifactId**: 项目名-模块名
 *  **-DarchetypeArtifactId**: 指定 ArchetypeId，maven-archetype-quickstart，创建一个简单的 Java 应用
 *  **-DinteractiveMode**: 是否使用交互模式
 *  <table> 
     <thead> 
      <tr> 
       <th>文件夹结构</th> 
       <th>描述</th> 
      </tr> 
     </thead> 
     <tbody> 
      <tr> 
       <td>consumerBanking</td> 
       <td>包含 src 文件夹和 pom.xml</td> 
      </tr> 
      <tr> 
       <td>src/main/java contains</td> 
       <td>java 代码文件在包结构下（com/companyName/bank）。</td> 
      </tr> 
      <tr> 
       <td>src/main/java test</td> 
       <td>测试代码文件在包结构下（com/companyName/bank）。</td> 
      </tr> 
      <tr> 
       <td>src/main/resources</td> 
       <td>包含了 图片 / 属性 文件（在上面的例子中，我们需要手动创建这个结构）。</td> 
      </tr> 
     </tbody> 
    </table>

[d5ca62c53bc3c9eb91c1990fbdd42582.png]: https://img-blog.csdnimg.cn/img_convert/d5ca62c53bc3c9eb91c1990fbdd42582.png
[Maven Central Repository Search]: http://search.maven.org/#browse