入门Maven

Maven 笔记

声明：

该笔记基于黑马的 2021-4-22 Maven教程

Maven简介

Maven 是什么

• Maven 的本质是一个项目管理工具，将项目开发和管理过程抽象成一个项目对象模型(POM)
• POM (Project Object Model):项目对象模型

Maven的作用

• 项目构建:提供标准的、跨平台的自动化项目构建方式
• 依赖管理:方便快捷的管理项目依赖的资源(jar包)，避免资源间的版本冲突问题
• 统一开发结构:提供标准的、统一的项目结构

下载与安装

Maven下载

• 官网：http://maven.apache.org/
• 下载地址：http://maven.apache.org/download.cgi

Maven安装

• Maven 属于绿色版软件，解压即安装

Maven 环境变量配置

• 依赖 Java，需要配置 JAVA_HOME
• 设置MAVEN自身的运行环境，需要配置 MAVEN_HOME
• 测试环境配置结果

MVN
1

Maven 基础概念

仓库

• 仓库：用于存储资源,包含各种jar包

• 仓库分类：

  • 本地仓库：自己电脑上存储资源的仓库，连接远程仓库获取资源
  • 远程仓库：非本机电脑上的仓库，为本地仓库提供资源
    • 中央仓库：Maven团队维护，存储所有资源的仓库
    • 私服：部门/公司范围内存储资源的仓库，从中央仓库获取资源

• 私服的作用：

  • 保护具有版权的资源，包含购买或自主研发的jar
    • 中央仓库中的jar都是开源的，不能存储具有版权的资源
  • 一定范围内共享资源，仅对内部开放，不对外共享

坐标

• 什么是坐标？

  • Maven 中的坐标用于描述仓库中资源的位置
  • https://repo1.maven.org/maven2/

• Maven 坐标的主要注册：

  • groupld：定义当前Maven项目隶属组织名称（通常是域名反写，例如:org.mybatis）
  • artifactld：定义当前Maven项目名称（通常是模块名称，例如CRM、SMS)
  • version：定义当前项目版本号
  • packaging：定义该项目的打包方式

• Maven 坐标的作用

  • 使用唯一标识，唯一性定位资源位置，通过该标识可以将资源的识别与下载工作交由机器完成

本地仓库配置

• Maven 启动后，会自动保存下载的资源到本地仓库

• Maven 配置文件位置：

  apache-maven-3.8.4\conf\settings.xml

  

  • 默认位置：

  • <localRepository>${user.home}/.m2/repository</localRepository>
    1

    当前目录位置为登录用户名所在目录下的.m2文件夹中，运行命令 mvn 后会自动生成 .m2 文件夹

  • 自定义位置

  • <localRepository>D:\maven\repository</localRepository>
    1

    当前目录位置为D:\maven\repository文件夹中

镜像仓库配置

因为国外的远程仓库下载较慢，所以可以使用国内的镜像源（比如阿里云的镜像源）

• 在setttings 文件中配置阿里云镜像仓库

阿里云镜像仓库：

<!-- 远程仓库镜像源（阿里云） -->
	<!--配置具体的仓厍的下载镜像-->
	<mirror>
	<!--此镜像的唯一标识符，用来区分不同的mirror元素-->
    <id>alimaven</id>
	<!--对哪种仓库进行镜像，简单说就是替代哪个仓库-->
    <mirrorOf>central</mirrorOf>
	<!--镜像名称-->
    <name>aliyun maven</name>
	<!--镜像URL-->
    <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
1
2
3
4
5
6
7
8
9
10
11

• 配置到 <mirrors> </mirror> 标签里面

全局setting 与 用户setting 区别

• 全局settings定义了当前计算器中Maven的公共配置

​ 直接写在 maven 的 settings.xml 文件中，就是全局 settings

• 用户settings定义了当前用户的配置

  • 如需要个性配置，则需要在用户配置中设置，用户配置的setting.xml文件默认的位置在：

  ${user.dir} /.m2/settings.xml 目录中
  1

  ${user.dir} 指 windows 中的用户目录。

第一个Maven项目(手工制作)

Maven 工程目录结构：

• 在src同层目录下创建 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/maven-	v4_0_0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<groupId>com.itheima</groupId>
	<artifactId>project-java</artifactId>
	<version>1.0</version>
	<packaging>jar</packaging>
	<dependencies>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.12</version>
		</dependency>
	</dependencies>
</project>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

Maven项目构建命令

mvn compile 	# 编译

mvn clean 		# 清理

mvn test		# 测试

mvn package		# 打包

mvn install		# 安装到本地仓库

mvn package		# 包含一系列过程： validate -->compile-->test-->package Maven 根据pom文件里packaging 的 配置，决定是生成jar文件还是war文件，并放到target目录下。 此 命令 需要在项目 的 根目录 (也就是pom.xml文件所在 的 目录)下运行， Maven 才知道打包哪个项目。

mvn verify		#  运行任何检查，验证包是否有效且达到质量标准。 mvn generate-sources 产生应用需要的任何额外的源代码，如xdoclet。 mvn常用命令2 mvn -v 显示版本 mvn help:describe -Dplugin=help 使用 help 插件的 describe 目标来输出 Maven Help 插件的信息。

mvn site		# 自动生成站点信息

mvn deploy		# 命令完成了项目编译、单元测试、打包功能，同时把打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库和远程maven私服仓库
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

使用插件自动创建工程目录

• 创建工程

mvn archetype:generate
	-DgroupId={project-packaging} 
	-DartifactId={project-name} 
	-DarchetypeArtifactId=maven-archetype-quickstart
	-DinteractiveMode=false
1
2
3
4
5

• 创建 Java 工程

mvn archetype:generate -DgroupId=com.itheima -DartifactId=java-project -
DarchetypeArtifactId=maven-archetype-quickstart -Dversion=0.0.1-snapshot -
DinteractiveMode=false
1
2
3

• 创建 Web 工程

mvn archetype:generate -DgroupId=com.itheima -DartifactId=web-project -
DarchetypeArtifactId=maven-archetype-webapp -Dversion=0.0.1-snapshot -
DinteractiveMode=false 
1
2
3

Java工程与Web工程的区别

在IDEA里面使用Maven

在IDEA里面配置Maven

在IDEA里面创建Maven工程

Maven 工程目录

• 在 test 底下新建 resources 文件夹后就是一个完整的 Maven 项目了

在 pom.xml 中导入 jar 包

配置：

<dependencies>
        <dependency>
            <groupId>junit</groupId>  <!-- 包名 -->
            <artifactId>junit</artifactId>	<!-- 名字 -->
            <version>4.12</version>   	<!-- 版本号 -->
        </dependency>
    </dependencies>
1
2
3
4
5
6
7

如果报红则稍等一下，因为 idea 在远程仓库下载 jar 包

idea里面执行命令

分别对应每个命令，关于命令上面有详细的 maven 命令以及作用

IDEA添加Maven快捷命令

快捷 Maven 命令可以用来调试 Maven 项目

使用模板创建

这里的 org.apache.maven.archetypes:maven-archetype-quickstart 代表 java 项目

web 项目模板：org.apache.cocoon:cocoon-22-archetype-webapp

这里面提供了很多的模板

java项目模板

使用模板创建出来的目录结构如下：

可以手动创建出 resources 目录

Maven 添加 tomcat 插件

在这里面找到对应的 tomcat 坐标 https://mvnrepository.com/

在 pom.xml 中添加

然后在右边就可以找到对应的 tomcat 插件以及命令（run运行）

也可以修改端口号，路径等信息：

依赖管理

依赖传递

• 依赖具有传递性
  • 直接依赖： 在当前项目中通过依赖配置建立的依赖关系
  • 间接依赖： 被资源的资源如果依赖其他资源，当前项目间接依赖其他资源

依赖传递冲突问题

• 路径优先： 当依赖中出现相同的资源时，层级越深，优先级越低，层级越浅，优先级越高
• 声明优先： 当资源在相同层级被依赖时，配置顺序靠前的覆盖配置顺序靠后的
• 特殊优先： 当同级配置了相同资源的不同版本，后配置的覆盖先配置的

可选依赖

• 可选依赖指对外隐藏当前所依赖的资源――不透明

<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<optional>true</optional> <!-- true 或者 false -->
</dependency>
1
2
3
4
5
6

排除依赖

• 排除依赖指主动断开依赖的资源，被排除的资源无需指定版本——不需要

<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<exclusions>
<exclusion>
<groupId>org.hamcrest</groupId>	<!-- 指定排除的 groupId -->
<artifactId>hamcrest-core</artifactId>	<!-- 指定排除的 artifactId -->
</exclusion>
</exclusions>
</dependency>
1
2
3
4
5
6
7
8
9
10
11

依赖范围

• 依赖的jar默认情况可以在任何地方使用，可以通过 scope 标签设定其作用范围
• 作用范围：
  • 主程序范围有效（main文件夹范围内）
  • 测试程序范围有效（test文件夹范围内）
  • 是否参与打包（package指令范围内）

依赖范围传递性

• 带有依赖范围的资源在进行传递时，作用范围将受到影响

生命周期与插件

项目构建生命周期

• Maven构建生命周期描述的是一次构建过程经历经历了多少个事件

• Maven 对项目构建的生命周期划分为3套
  • clean： 清理工作
  • default： 核心工作，例如编译，测试，打包，部署等
  • site： 产生报告，发布站点等

clean生命周期

• pre-clean 执行一些需要在clean之前完成的工作

• clean 移除所有上一次构建生成的文件

• post-clean 执行一些需要在clean之后立刻完成的工作

site构建生命周期

⚫ pre-site 执行一些需要在生成站点文档之前完成的工作

⚫ site 生成项目的站点文档

⚫ post-site 执行一些需要在生成站点文档之后完成的工作，并且为部署做准备

⚫ site-deploy 将生成的站点文档部署到特定的服务器上

1
2
3
4
5
6
7
8

default构建生命周期

⚫ validate（校验） 校验项目是否正确并且所有必要的信息可以完成项目的构建过程。

⚫ initialize（初始化） 初始化构建状态，比如设置属性值。

⚫ generate-sources（生成源代码） 生成包含在编译阶段中的任何源代码。

⚫ process-sources（处理源代码） 处理源代码，比如说，过滤任意值。

⚫ generate-resources（生成资源文件） 生成将会包含在项目包中的资源文件。

⚫ process-resources （处理资源文件） 复制和处理资源到目标目录，为打包阶段最好准备。

⚫ compile（编译） 编译项目的源代码。

⚫ process-classes（处理类文件） 处理编译生成的文件，比如说对Java class文件做字节码改善优化。

⚫ generate-test-sources（生成测试源代码） 生成包含在编译阶段中的任何测试源代码。

⚫ process-test-sources（处理测试源代码） 处理测试源代码，比如说，过滤任意值。

⚫ generate-test-resources（生成测试资源文件） 为测试创建资源文件。

⚫ process-test-resources（处理测试资源文件） 复制和处理测试资源到目标目录。

⚫ test-compile（编译测试源码） 编译测试源代码到测试目标目录.

⚫ process-test-classes（处理测试类文件） 处理测试源码编译生成的文件。

⚫ test（测试） 使用合适的单元测试框架运行测试（Juint是其中之一）。

⚫ prepare-package（准备打包） 在实际打包之前，执行任何的必要的操作为打包做准备。

⚫ package（打包） 将编译后的代码打包成可分发格式的文件，比如JAR、WAR或者EAR文件。

⚫ pre-integration-test（集成测试前） 在执行集成测试前进行必要的动作。比如说，搭建需要的环境。

⚫ integration-test（集成测试） 处理和部署项目到可以运行集成测试环境中。

⚫ post-integration-test（集成测试后） 在执行集成测试完成后进行必要的动作。比如说，清理集成测试环境。

⚫ verify （验证） 运行任意的检查来验证项目包有效且达到质量标准。

⚫ install（安装） 安装项目包到本地仓库，这样项目包可以用作其他本地项目的依赖。

⚫ deploy（部署） 将最终的项目包复制到远程仓库中与其他开发者和项目共享。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

插件

• 插件与生命周期内的阶段绑定，在执行到对应生命周期时执行对应的插件功能
• 默认maven在各个生命周期上绑定有预设的功能
• 通过插件可以自定义其他功能

<build>
	<plugins>
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-source-plugin</artifactId>
			<version>2.2.1</version>
			<executions>
				<execution>
					<goals>
						<goal>jar</goal>
					</goals>
					<phase>generate-test-resources</phase>
				</execution>
			</executions>
		</plugin>
	</plugins>
</build>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18