Maven：基础知识

概念图

• 依赖管理
• 构建项目
• Maven 的底层核心实现项目的构建和管理必须通过插件完成，但插件本身并不包含在其核心程序当中。

生命周期

在 Maven 中，它拥有三套标准的生命周期，分别为CleanLifeCycle、DefaultLifeCycle 和 SiteLifeCycle 。每一套生命周期互相独立、互不影响。另外，每套生命周期包含一系列的构建阶段，这些阶段是有顺序的，会按照顺序执行（即执行后面的阶段会先自动执行前面的阶段）。

• CleanLifeCycle：清理的生命周期
• DefaultLifeCycle：默认的生命周期
• SiteLifeCycle：站点的生命周期

目录

在 Maven 中，所有文件的存放目录都有明确的约定。标准目录结构如下：

目录名	含义
项目根/	项目目录根
pom.xml	项目对象模型（Project Object Model），Maven项目中的文件
src/	源代码目录根
main/	项目主体目录根
java	源代码目录
resources	所需资源目录
filters	资源过滤文件目录
assembly	Assembly descriptors
config	配置文件目录根
test/	项目测试目录根
java	测试代码目录
resources	测试所需资源目录
filters	测试资源过滤文件目录
site	与site相关的资源目录
target/	输出目录根
classes	项目主体输出目录
test-classes	项目测试输出目录
site	项目site输出目录

工程创建

创建的工程分为两类：一是Java项目，二是Web项目。创建命令如下：

<1>. Java项目：

mvn archetype:generate -DgroupId=JavaProjectPackage -DartifactId=JavaProjectName -DarchetypeArtifactId=maven-archetype-quickstart

<2>. Web项目：

mvn archetype:generate -DgroupId=WebProjectPackage -DartifactId=WebProjectName -DarchetypeArtifactId=maven-archetype-webapp

其中，属性含义：
-DgroupId：包名
-DartifactId: 项目名
-DarchetypeArtifactId: 项目类型
注： 一定要按照标准目录结构来构建工程。

测试

我们先使用命令行窗口在桌面上对 Maven 项目进行创建。步骤如下：

打开命令行窗口，进入桌面，输入命令：

//1.Java项目
mvn archetype:generate -DgroupId=cn.edu.MavenStudy -DartifactId=MavenJavaProjectTest -DarchetypeArtifactId=maven-archetype-quickstart//2.Web项目
mvn archetype:generate -DgroupId=cn.edu.MavenStudy -DartifactId=MavenWebProjectTest -DarchetypeArtifactId=maven-archetype-webapp

若是第一次创建，需要耐心等待 Maven 下载相应资源到本地仓库上（repository 文件）。如图：

所需的资源，如图：

再创建Web项目，如图：

常用命令

命令	作用
mvn compile	编译，将源代码编译成字节码文件（.class）
mvn clean	清除，删除编译的目标文件target
mvn test	测试，运行test包下的单元测试类（其方法名约定为XxxxTest）
mvn package	将项目打包，文件存储在项目根目录的target目录中（Java项目打包成 jar文件，Web项目打包成 war文件）
mvn install	将一个工程打包成 jar文件，存储在本地仓库里
mvn deploy	若有私服，打包后上传到私服
mvn source:jar	源码打包
mvn dependency:sources	下载 jar包的源代码
mvn site	查看报告和操作流程

COMPILATION ERROR : 不再支持目标选项 5。请使用 7 或更高版本。

在使用命令过程中，遇到了错误，如图：

原因：JDK版本不匹配。

问题解决

首先，打开命令行窗口，输入命令：java -version ，查看版本信息。如图：

找到 Maven/apache-maven-3.8.6/conf 目录下的 settings.xml 文件进行修改配置：

//根据本机JDK版本，添加以下配置：
<profile>  <id>jdk-16.0.2</id><activation><activeByDefault>true</activeByDefault><jdk>16</jdk></activation><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><maven.compiler.source>16</maven.compiler.source><maven.compiler.target>16</maven.compiler.target><maven.compiler.compilerVersion>16</maven.compiler.compilerVersion></properties>  
</profile>

如图：

再次使用命令，成功执行。如图：

pom.xml文件

pom.xml为当前Maven项目配置文件，定义项目的基本信息，用于描述项目的maven坐标，依赖关系等。

一般情况下，Maven是通过groupId、artifactId、version这三个元素值（俗称坐标）来检索该构件， 然后引入工程。若要引用项目（已开发完毕并发布到远程仓库），则在pom.xml文件中新建一个dependency节点，将本项目的groupId、artifactId、version写入， Maven便会把jar包下载到本地 。接下来，简单介绍pom.xml文件。

<?xml version="1.0" encoding="UTF-8"?><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/xsd/maven-4.0.0.xsd"><!-- 基本配置 --><!-- 声明pom文件遵循POM模型的某个版本（必不可少，且对于Maven2与Maven3只能是4.0.0）--><modelVersion>4.0.0</modelVersion><!-- 定义当前项目隶属的实际项目组 --><groupId>cn.edu.MavenProject</groupId><!-- 定义当前项目的名称，主要区分一个groupId的多个项目 --><artifactId>MavenJavaProject</artifactId><!-- 定义当前项目所处的版本号（SNAPSHOT：测试版本；RELEASE：发布版本）--><version>1.0.0-SNAPSHOT</version><!-- 定义打包的类型（默认为jar，jar：Java项目；war：Web项目；pom：父级项目 ）--><packaging>jar</packaging><!-- 定义pom常量，便于在pom中的直接引用 --><properties><demo.version>4.11</demo.version></properties><!-- 定义构件输出的附属构件，有时需要加上classifier才能唯一的确定该构件，否则会报错查找不到 --><classifier>...</classifier><!-- 定义当前项目的依赖关系 --><dependencies><!-- 每个dependency对应着一个jar包 --><dependency><!-- 坐标信息 --><groupId>org.apache.commons</groupId> <!-- 组织名称 --><artifactId>commons-lang3</artifactId> <!-- jar包名称 --><version>3.8.1</version> <!-- 版本号 --><!-- 定义Jar包的使用范围 --><scope>test</scope><!-- 设置指依赖是否可选，默认为false --><optional>false</optional><!-- 屏蔽依赖关系 --><exclusions><exclusion><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId></exclusion></exclusions></dependency></dependencies><!-- 构建配置 --><build><!-- 构件的文件名，默认值为${artifactId}-${version} --><finalName>ProjectName</finalName><!-- 统一管理插件 --><pluginManagement><!-- 使用插件的列表 --><plugins><plugin><artifactId>maven-clean-plugin</artifactId><version>3.1.0</version>           <!-- 指定构建生命周期的阶段执行插件的配置 --><executions><execution><!-- 执行目标的标识符，用于标识构建过程中的目标或匹配继承过程中需要合并的执行目标 --><id>execution-id</id><!-- 指定目标的构建生命周期阶段，默认为目标被绑定到源数据里配置的阶段 --><phase>package</phase><!-- 配置的执行目标 --><goals><goal>demo-goal</goal></goals><!-- 配置是否被子POM继承 --><inherited>false</inherited></execution></executions><!-- 是否从该插件下载Maven扩展 --><extensions></extensions></plugin></plugins></pluginManagement></build><!-- 分发配置 --><!-- 执行mvn deploy，将项目生成的构件分发到远程Maven仓库，分发到远程Maven仓库之后，所有能访问该仓库的用户都能使用你的构件。 --><distributionManagement>    <!-- 项目生成的构件到远程仓库所需的信息 --><repository>		  <!-- 是否设置唯一版本号（由时间戳和构建流水号组成） --><uniqueVersion>true</uniqueVersion><!-- 目标仓库的id --><id>repository-id</id> <!-- 目标仓库的名字 --><name>repository-name</name><!-- 目标仓库的网址 --><url>file://${basedir}/target/deploy</url> </repository><!-- 测试版仓库 --><snapshotRepository><uniqueVersion/><id/>  <name/>   <url/>   </snapshotRepository> </distributionManagement> <!-- 仓库配置 --><!-- 远程仓库列表 --><repositories><!-- 连接远程仓库的信息 --><repository><!-- 处理远程仓库 正式发布版本 的下载 --><release><!-- 是否下载某种类型构件 --><enabled/><!-- 指定更新的频率 --><updatePolicy/><!-- Maven验证构件失败的处理 --><checksumPolicy/></release><!-- 处理远程仓库 快照版本 的下载（快照是一种特殊的版本，指定了某个当前的开发进度的副本） --><snapshots><enabled/><updatePolicy/><checksumPolicy/>  </snapshots><!-- 远程仓库唯一标识符，可以匹配settings.xml文件的远程仓库 --><id>repository-id</id>			<!-- 远程仓库名称 --><name>repository-name</name><!-- 远程仓库网址（形式为protocol://hostname/path） --><url>repository-url</url><!-- 指定仓库布局类型（default:默认，legacy:遗留） --><layout></layout></repository></repositories>
</project>

properties配置示例

<!-- 定义pom常量，便于在pom中的直接引用 -->
<!-- 示例 -->
<properties><demo.version>4.11</demo.version>
</properties>
<dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>${demo.version}</version><scope>test</scope>
</dependency>

scope配置详解

maven认为，程序对外部的依赖会随着程序的所处阶段和应用场景而变化，所以maven中的依赖关系有作用域(scope)的限制。
scope值如下：

• compile（编译范围）：默认值，表示被依赖项目需要参与项目的编译、测试、运行、打包、发布。
• runtime（运行时范围）：表示被依赖项目不参与项目的编译。
• test（测试范围）：表示被依赖项目仅参与项目测试相关的工作（包括测试代码的编译和执行，但不会被打包和部署）。
• provided（已提供范围）：表示被依赖项目参与项目的编译、测试和运行，而其他依赖由JDK或容器提供。
• system（系统范围）：与 provided 相似，但不依赖Maven仓库，而是必须使用systemPath属性指定本地文件系统获取。