Maven项目管理工具的介绍和使用 maven项目结构图

在我们的项目开发过程中，常常会使用maven作为依赖，来快速地引入依赖进行开发。很多人都知道maven或者使用的次数也非常多，今天我们就来了解一下maven，系统地介绍一下。

1、Maven的基本概念

Maven是跨平台的项目管理工具。主要服务于基于Java平台的项目构建，依赖管理和项目信息管理。接下来我们就来介绍一下项目构建和依赖管理。

1.1、项目构建

项目构建过程包括【清理项目】→【编译项目】→【测试项目】→【生成测试报告】→【打包项目】→【安装项目】→【部署项目】这几个步骤，这几个步骤就是一个项目的完整构建过程，我们在项目开发过程中不一定需要使用所有的步骤，往往只需要使用到其中几个关键步骤。

[1] 清理clean：将以前编译得到的旧文件class字节码文件删除，为下一次编译做准备；

[2] 编译compile：将java源程序编译成class字节码文件；

[3] 测试test：自动测试，自动调用junit程序；

[4] 报告report：测试程序执行的结果；

[5] 打包package：动态Web工程打War包，java工程打jar包；

[6] 安装install：Maven特定的概念—–将打包得到的文件复制到“仓库”中的指定位置；

[7] 部署deploy：将动态Web工程生成的war包复制到Servlet容器下，使其可以运行；

相关的maven命令：

• mvn clean：清理；
• mvn compile：编译主程序；
• mvn test-compile：编译测试程序；
• mvn test：执行测试；
• mvn package：打包；
• mvn install：安装jar到本地仓库；
• mvn deploy：将最终的包复制到远程的仓库，以让其它开发人员与项目共享；
• mvn site：生成项目站点信息；
• mvn clean install：组合命令，告诉Maven clean在每个模块中执行install阶段；

1.2、依赖管理

依赖指的是jar包之间的相互依赖，比如我们搭建一个Struts2的开发框架时，如果只有struts2-core.jar这个jar包是不行的，struts2-core.jar还依赖其它的jar包，依赖管理指的就是使用Maven来管理项目中使用到的jar包，Maven管理的方式就是“自动下载项目所需要的jar包，统一管理jar包之间的依赖关系”。

2、Maven安装

2.1、安装或者查看环境

首先要确保开发环境已经安装了JDK，配置好JDK的环境变量，使用如下的两个命令检查检查JDK安装的情况。

① Echo %JAVA_HOME%

② Java –version

2.2、下载maven

到官网maven.apache.org下载对应操作系统的版本，比如我是windows系统，我会选择下载apache-maven-3.8.6-bin.zip，下载之后对zip压缩文件进行解压。如果是linux操作系统，可以下载后缀是gz格式的压缩包。

2.3、设置系统环境变量

桌面“我的电脑”->右键打开“属性”->“高级系统设置”->"环境变量" 中设置 MAVEN_HOME，设置为maven的解压缩目录。小编之前已经安装了3.8.1版本，而不是最新的3.8.6版本，后续以此版本截图说明。

2.4、设置环境变量Path

将%MAVEN_HOME%\bin加入Path中，一定要注意要用分号；与其他值隔开。%MAVEN_HOME%\bin代表的就是"D:\install\apache-maven-3.8.1\bin"目录（这是我的安装目录，每个人这里对应的自己的安装目录）。

2.5、验证Maven安装是否成功

打开cmd窗口，输入"mvn –v"命令 查看Maven的相关信息。会显示maven的版本、jdk的版本信息以及操作信息的相关信息。

3、Maven的简单使用

3.1、Maven项目的目录约定

3.2、maven的配置文件setting.xml

我们先来了解一下setting.xml 配置文件格式和内容。

上面这个例子看起来比较复杂，但我们在实际使用中往往只关注两个方面，一个是配置本地仓库的路径，一个是设置下载依赖的来源。

<!--本地仓库。该值表示构建系统本地仓库的路径。其默认值为~/.m2/repository。 -->  
<localRepository>E:\mavenRepository\repository</localRepository>
<!--为仓库列表配置的下载镜像列表。 -->  
<mirror>
		<id>nexus-aliyun</id>
		<mirrorOf>central</mirrorOf>
		<name>Nexus aliyun</name>
		<url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>

配置好setting.xml 配置文件，然后就可以在开发工具中引入，我以IntelliJ IDEA为例。

4、Maven坐标

maven项目，跟maven相关的最重要的文件就是pom.xml文件了，我们来了解一下。

4.1、Maven坐标主要组成

1. groupId：组织标识（包名）；
2. artifactId：项目名称；
3. version：项目的当前版本；
4. packaging：项目的打包方式，最为常见的jar和war两种。

<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.4.1</version>
		<relativePath />
</parent>

<groupId>com.bianchengxia.springboot</groupId>
<artifactId>springboot</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>springboot</name>
<packaging>jar</packaging> <!-- jar或者war -->

4.2、依赖管理

我们在标签对dependencies内，引入项目所需要的依赖。

<dependencies>
      <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
      </dependency>
      <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-autoconfigure</artifactId>
      </dependency>
      <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.1.2</version>
      </dependency>
      <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
      </dependency>
      <!--切面日志 -->
      <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-aop</artifactId>
      </dependency>
      <!--mybatis -->
      <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.3</version>
      </dependency>
      <!-- mysql依赖jar -->
            <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.22</version>
      </dependency>
      <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
      </dependency>
      <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
      </dependency>
</dependencies>

4.3、添加外部依赖

正常的我们引入远程仓库的依赖，直接可以是使用上面的方式，但是如果我们需要引入项目里面的依赖，比如一个开源的项目有一个私有的依赖包，我们下载下来之后需要引入才能正常运行或者打包。那我们就可以使用下面的方式：除了引入依赖之外，再添加配置，设置includeSystemScope为true。

<build>
 <plugins>
  <plugin>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-maven-plugin</artifactId>
   <configuration>
   <!--打包时将外部引入的jar包打包，不加此配置，本地可以运行，但服务器上jar中是没有的-->
   <includeSystemScope>true</includeSystemScope>
   </configuration>
  </plugin>
 </plugins>
</build>

5、Maven仓库

maven仓库的分类：本地仓库和远程仓库。其中远程仓库包括中央仓库、私服和其他公共库。

5.1、远程仓库

（1）中央仓库：Maven默认的远程仓库，中央仓库是远程仓的核心。中央仓库包含了绝大多数流行开源Java构件，以及源码、作者信息、SCM、信息、许可证信息等。如果中央仓库慢可以用mirrors来替换它，它的id是central。

<!-- 中央仓库 -->
<repositories>
 <repository>
  <id>central</id>
  <name>Central Repository</name>
  <url>http://repo.maven.apache.org/maven2</url>
  <layout>default</layout>
  <snapshots>
    <enabled>false</enabled>
  </snapshots>
 </repository>
</repositories>

（2）私服：是一种特殊的远程仓库，maven私服是指私有服务器，是针对局域网而言的，目的是代理远程仓库及部署第三方构建，很多公司会搭建自己的私服。有了私服之后，当 Maven 需要下载构件时，直接请求私服，私服上存在则下载到本地仓库；否则，私服请求外部的远程仓库，将构件下载到私服，再提供给本地仓库下载。

（3）其他公共库：默认的远程仓库也就是中央仓库往往下载比较慢，所以很多公司会搭建私服，但是搭建私服也比较麻烦，这个时候有人就想，能不能使用“拿来主义”直接使用别人搭建好的仓库呢？当然可以，这就是其他公共库，对外开放，我们可以直接使用。比如我们在上面的setting.xml 配置文件里面<mirror>标签对里面设置的仓库，就是阿里云开放的公共仓库。

5.2、本地仓库

maven在本地存储构件的路径，一般本地仓库地址可以在settings.xml里边指定。我们在上面介绍settings.xml文件时也说明了，设置localRepository元素的值为本地仓库路径。

6、maven模块聚合和继承

6.1、顶级pom文件配置

6.2、模块聚合配置

6.3、继承配置代码

继承代码过程中，可以定义属性，例如：

<!--属性定义-->
<properties>
  <!--项目构建基本配置-->
  <spring.version>3.2.0.RELEASE</spring.version>
  <struts.version>2.3.15.1</struts.version>
  <servlet.version>3.0.1</servlet.version>
  <urlrewriter.version>4.0.4</urlrewriter.version>
</properties>

访问属性的方式为${junit.version}，例如：

<dependency>
  <groupId>junit</groupId>
  <artifactId>junit</artifactId>
  <version>${junit.version}</version>
  <scope>test</scope>
</dependency>

父模块用dependencyManagement进行管理：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.tydic.framework</groupId>
      <artifactId>frameworkbase</artifactId>
      <version>${framework.version}</version>
    </dependency>
  </dependencies>
<dependencyManagement>