Maven学习笔记（三）——Maven仓库（Repositories）、基础命令（二）&自动构建项目

比眉伴天荒 2022-08-04 11:53 200阅读 0赞

# 前言 #

上篇blog介绍了maven最基础的一些核心概念，包括maven项目约定的目录结构、maven核心配置文件——pom.xml文件的解析以及3个基本的maven命令（compile、test、package），本篇blog将继续介绍剩余的maven命令，还会涉及到maven最重要的概念之一——Maven仓库，最后会学习如何通过maven自动构建java项目/javaweb项目以及自动构建可供选择的项目骨架。

# Maven仓库（Repositories） #

本来打算继续学习剩余的maven命令，但有一个最常用的基础命令mvn install，它的作用是将我们的maven项目编译打包并安装到我们的本地Maven仓库，既然这里提到了仓库的概念，那么有必要优先学习一下它，况且它也是Maven中最核心的一个概念。首先看一下官方的介绍：

![Center][]

在Maven中仓库被用于保存和创建各种类型的artifacts（模块）以及依赖。简单来讲，仓库主要就是用于存放我们项目中用到的各种各样的jar包了，我们在pom.xml中声明的所有依赖jar包，其实都是来自本地仓库的引用。在上图中我们可以看到Maven有两种仓库，分别是local（本地）仓库和remote（远程）仓库，我们在使用Maven的过程中，比如运行一些Maven命令可以发现命令行的Downloading字样的信息：

![Center 1][]

其实就是Maven自动的从远程仓库去下载我们需要的依赖和库到Maven本地仓库。本地仓库的默认路径是~/.m2/repository，如下图所示：

![Center 2][]

图中就是Maven的本地仓库目录，可以看到许多已经下载好的依赖文件了。Maven本地仓库的默认路径在C盘，但通常我们不喜欢把文件存放在C盘，例如重装系统文件会丢失，或者占用C盘空间会影响操作系统运行速度等等原因，我们更愿意自定义仓库的目录，其实也很简单，找到Maven的全局配置文件（Maven安装目录下的conf/settings）文件，我们找到localRepository元素修改为本地路径即可：

<localRepository>E:\apache-maven-3.3.3\repo</localRepository>

如上图所示我们将本地仓库的路径放在了Maven安装路径的根目录下的repo目录下，再次使用Maven的时候我们可以发现自动下载的依赖包都会保存在我们新指定的本地仓库路径下了：

![Center 3][]

说完了本地仓库，再回头看看上面黑窗口的那张图，Downloading后面的用红色线条标出的下载地址，那个就是Maven官方的全球远程仓库的地址了，我们可以在浏览器中尝试访问一下，发现会自动跳转到另一个地址：

![Center 4][]

这里可以看到许多我们认识的库了，比如android中常用的httpclint，还有spring中aop会用到的aopalliance等等。这个Maven中央仓库包含了绝大多数开源构件、源码以及作者信息等等，下面推荐2个主流的提供Maven搜索服务的站点，可用于查询某个具体的库的坐标信息：

[http://mvnrepository.com/][http_mvnrepository.com]

[http://search.maven.org/][http_search.maven.org]

对了，这里提到了坐标，这个概念也需要学习一下，虽然很简单但是也是Maven中很重要的概念之一。

Maven的坐标指的就是用来标识某个唯一的构件的规范，一个坐标通常由三部分组成，分别是：

*  groupId
 *  artifactId
 *  version

例如：

<dependency>
    	<groupId>junit</groupId>
    	<artifactId>junit</artifactId>
    	<version>3.8.1</version>
    </dependency>

Maven中拥有大量的各种各样的构件，所以我们需要拥有这种统一的规范来标识每一个构件的唯一性。

学习了上面这些概念之后，我们就可以继续上一篇blog学习剩余的几个重要的Maven命令了。

# 清理（clean）、安装（install） #

首先来看一下clean命令，这个命令很简单，作用就是清理编辑结果，即：删除target文件夹以及内容。

![Center 5][]

可以看到clean之前target文件夹是存在的，即maven在compile之后为我们生成的用于存放编译结果的目标文件夹，现在我们执行clean命令：

![Center 6][]

可以看到当我们执行了clean命令之后，显示了Deleting F:/MavenTest02/target，即删除了target文件夹，最后显示了BUILD SUCCESS字样即执行成功。

接下来我们再看一下install命令，同样的进入MavenTest02目录，运行mvn install命令：

![Center 7][]

可以看到上图中标出的信息，Installing F:/MavenTest02/pom.xml to E:/apache-maven-3.3.3/repo...

不难发现我们的MavenTest02已经成功打包并作为一个普通的构件安装到了我们本地的Maven仓库中。这样当我们在其他的Maven项目如果需要用到MavenTest02中的类时，就可以将它作为普通的依赖导入到pom.xml中即可，例如这样：

<dependency>
    	<groupId>com.wl</groupId>
    	<artifactId>MavenHelloDemo</artifactId>
    	<version>SNAPSHOT-0.0.1</version>
    </dependency>

mvn install是所有Maven命令中最常用的命令之一。

# 自动构建项目&项目骨架 #

在这之前我们都是手动的去创建目录文件夹，在实际开发中显然是不可取的，实际开发肯定是通过IDE去创建项目，而IDE也无法自动创建，而是间接的调用了Maven的项目构建命令，那么接下来就学习一下构建命令的提供者——Archetypes插件，首先看一下官网的介绍：

![Center 8][]

可以在官网的这段简介中看到，使用archetype插件可以创建Maven项目，而且一个archetype会提供许多项目模板（骨架），上图中的代码也给出了archetype插件的使用命令和参数名。通常情况下我们使用mvn archetype:generate命令即可，如官方文档中Introdution to Archetypes中介绍的一样，

![Center 9][]

下面我们在命令行实际操作一下试试看，切换到F:/MavenTest04（空目录）后，输入mvn archetype:generate，

![Center 10][]

如果是第一次运行这个命令则会需要一些时间去自动下载jar包，最后我们可以看到Choose a number or apply filter，Maven的Archetype插件为我们提供了多达1393个项目模板可供选择，我们可以输入模板编号来选择，或者输入过滤器进行过滤，过滤器也很简单，比如我们需要创建web项目，那么输入“web+回车”就会筛选出所有web项目骨架了。当然我们如果不知道选择什么，也可以什么也不输入直接敲回车，就会选择默认的模板，其实就是一个普通java项目了。

接下来我们根据提示需要依次输入版本号、groupId、artifactId、version、package并输入“Y”来确认之后，我们就会在指定的目录下成功创建这个默认骨架的Maven项目了：

![Center 11][]

如上图所示，我们可以看到在F:/MavenTest04目录下成功创建了maven04-model这个项目：

![Center 12][]

最后我们直接安装并运行一下这个项目，通过mvn install将我们这个项目编译打包并安装到本地仓库，并通过java命令去运行jar包：

![Center 13][]

可以看到当我们将目录切换到MavenTest04/maven04-model目录下之后并执行mvn install命令，我们的项目正常编译打包并安装到了我们本地的Maven仓库，那么我们这个项目的jar包应该在target的根目录下，我们尝试执行一下：

![Center 14][]

成功输出了Hello World！没有任何问题，这就是我们的Archetype插件创建的项目了。

我们还可以通过指定参数名的方式去创建指定的某种骨架的项目，在上面的“How do I make my first Maven Project”的截图中我们可以看到官方提供的几个参数，分别是\-DarchetypeGroupId、\-DgroupId、\-DartifactId。比如依旧创建上面的那个默认项目的话，我们可以直接运行这个命令：

mvn archetype:generate -DgroupId=com.wl.maven04 -DartifactId=maven04-model -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

这样就避免了我们去选择，而直接创建默认的骨架——maven-archetype-quickstart的项目了。我们在之前运行mvn archetype:generate命令时也看到了这个插件为我们提供的骨架有1393之多，即使我们使用了filter也很难选择，不过没关系，官方给我们提供了几个最常用的骨架以供选择：

![Center 15][]

如上图所示，可以看到有web project的骨架，simple maven project的骨架等等，我们根据需要自行选择即可，再补充一个很常用的骨架：maven-archetype-webapp，我们在创建web项目的时候更多的应该会选择这个骨架。下面我们就用这个骨架创建一个web项目并在浏览器Hello World！首先创建一个新的目录MavenWebTest，在命令行中切换到该目录并输入命令：

![Center 16][]

可以看到我们输入了命令并指定参数之后，成功在我们的F:/MavenWebTest目录下创建了mavenweb-model这个web项目，创建完成后我们把这个项目导入到MyEclipse中看一下目录结构（注意MyEclipse的话需要通过maven插件提供的导入来导入maven项目，具体下篇blog会介绍）：

![Center 17][]

可以发现src/main下多了一个webapp目录，而这个目录其实就和我们普通web项目的webroot或webcontent是一样的了，我们的web相关文件（js、jsp、css）等都应该放在这个目录下了，下面再看一下这个自动生成的maven web项目的pom文件吧：

<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">
      <modelVersion>4.0.0</modelVersion>
      <groupId>com.wl.mavenwebtest</groupId>
      <artifactId>mavenweb-model</artifactId>
      <packaging>war</packaging>
      <version>1.0-SNAPSHOT</version>
      <name>mavenweb-model Maven Webapp</name>
      <url>http://maven.apache.org</url>
      <dependencies>
        <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>3.8.1</version>
          <scope>test</scope>
        </dependency>
      </dependencies>
      <build>
        <finalName>mavenweb-model</finalName>
      </build>
    </project>

注意一下packaging元素，它的值是war，也就说明我们执行mvn package打包项目的时候会在target目录下生成一个war包：

![Center 18][]

如上图所示，确实如此。我们把这个war包拷贝到tomcat的webapps目录并启动tomcat：

![Center 19][]

访问一下看看：

![Center 20][]

没问题，成功显示了Hello World！

# 总结 #

本篇blog介绍了仓库的概念、clean和install命令以及maven用于自动构建项目的archetype插件，到目前为止我们都没有使用IDE进行开发，而在实际开发环境中我们一般也不会通过命令行去创建项目，所以下篇blog会陆续学习如何将maven集成到我们的Eclipse和MyEclipse中去，需要什么样的插件，需要如何配置等等，学完下一篇blog才算真正进入maven学习的门槛，继续加油~Raito！

[Center]: /images/20220731/3bfc7dd3b7b249b39ba3dbd187a8da44.png
[Center 1]: /images/20220731/b4d010ff166d41a189c0412e8140b223.png
[Center 2]: /images/20220731/8046371c4c6b402794d5d1522e9fc668.png
[Center 3]: /images/20220731/6e07bfb0557c4ba19347c416e127e313.png
[Center 4]: /images/20220731/3c2ffb1042144648bf7fa489ff4e99bf.png
[http_mvnrepository.com]: http://mvnrepository.com/
[http_search.maven.org]: http://search.maven.org/
[Center 5]: /images/20220731/d57dc65d4e6448608ac99fd6c9236fa7.png
[Center 6]: /images/20220731/f1357e89620449f1a505818b02b2e3db.png
[Center 7]: /images/20220731/4c1af2c10cc1448ab647308628de6d66.png
[Center 8]: /images/20220731/71ae21210e4445ae9bf8a9ee7a778479.png
[Center 9]: /images/20220731/983e561031654f0c9ad949bd5a53d289.png
[Center 10]: /images/20220731/986fab86cce54b35bbd22bdb0701fb0c.png
[Center 11]: /images/20220731/d6a58af4bb8a4b0b842422015c2bad8e.png
[Center 12]: /images/20220731/43865680b9ab45a3823809f6159552b5.png
[Center 13]: /images/20220731/88611a8bbdaf433f836ee59b6ff9cbc1.png
[Center 14]: /images/20220731/39e8db8edadd4d4fbec64c4837785163.png
[Center 15]: /images/20220731/7ac525107ab74d95887911a18c03e473.png
[Center 16]: /images/20220731/5e4e3a0813c24d58aed58b4060ad1cd4.png
[Center 17]: /images/20220731/48108c642d784cf0904d60bc7fad84cd.png
[Center 18]: /images/20220731/4319e7eca5824484b261d8ad36dfd6c8.png
[Center 19]: /images/20220731/5b072e1ed9584679afed7aed26f8135d.png
[Center 20]: /images/20220731/6a60d50e0e454e9ea2f01e8d20c6a4d6.png