Maven基础知识

生产环境下开发不再是一个项目一个工程，而是每一个模块创建一个工程而多个模块整合在一起就需要使用到像Maven这样的构建工具。

构建过程的几个主要环节

①清理 ：删除以前的编译结果，为重新编译做好准备。
②编译 ：将Java源程序编译为字节码文件。
③测试 ：针对项目中的关键点进行测试，确保项目在迭代开发过程中关键点的正确性。
④报告 ：在每一次测试后以标准的格式记录和展示测试结果。
⑤打包 ：将一个包含诸多文件的工程封装为一个压缩文件用于安装或部署。 Java 工程对应 jar 包， Web工程对应 war 包。
⑥安装 ：在 Maven 环境下特指将打包的结果 jar 包或 war 包安装到本地仓库中。
⑦部署 ：将打包的结果部署到远程仓库或将 war 包部署到服务器上运行。

安装Maven核心程序

① 检查JAVA_HOME环境变量（开启cmd，输入echo %JAVA_HOME%）

1
2
C:\Users\Administrator>echo %JAVA_HOME%
D:\PATH-EN\jdk11

② 解压Maven核心程序压缩包，放在一个非中文无空格路径下
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
PS D:\PATH-EN\Maven_path> pwd

Path
----
D:\PATH-EN\Maven_path


PS D:\PATH-EN\Maven_path> ls


    目录: D:\PATH-EN\Maven_path


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----  2023/2/17 星期五     20:11                apache-maven-3.2.2


PS D:\PATH-EN\Maven_path>

③ 配置Maven相关的环境变量

  • MAVEN_HOME或者是M2_HOME(路径一般是bin文件夹的上一级)

  • 配置Path(路径一般是bin文件夹所在的一级)

④ 验证：运行 mvn -v命令查看

1
2
3
4
5
6
7
8
PS D:\PATH-EN\Maven_path> mvn -v
Apache Maven 3.2.2 (45f7c06d68e745d05611f7fd14efb6594181933e; 2014-06-17T21:51:42+08:00)
Maven home: D:\PATH-EN\Maven_path\apache-maven-3.2.2
Java version: 11.0.2, vendor: Oracle Corporation
Java home: D:\PATH-EN\jdk11
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 10", version: "10.0", arch: "amd64", family: "dos"
PS D:\PATH-EN\Maven_path>

Maven 核心概念

根据坐标创建 Maven 工程

向量说明

  • 使用三个『向量』在『Maven的仓库』中唯一的定位到一个『jar』包。
    • groupId：公司或组织的 id
    • artifactId：一个项目或者是项目中的一个模块的 id
    • version：版本号

三个向量的取值方式

  • groupId：公司或组织域名的倒序，通常也会加上项目名称
    • 例如：cn.jermyn.maven
  • artifactId：模块的名称，将来作为 Maven 工程的工程名
  • version：模块的版本号，根据自己的需要设定
    • 例如：SNAPSHOT 表示快照版本，正在迭代过程中，不稳定的版本
    • 例如：RELEASE 表示正式版本
      1
      2
      3
      4
      举例：
      groupId：cn.jermyn.maven
      artifactId：pro01-jermyn-maven
      version：1.0-SNAPSHOT
      坐标和仓库中 jar 包的存储路径之间的对应关系
      坐标：
      1
      2
      3
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
      上面坐标对应的 jar 包在 Maven 本地仓库中的位置：
      1
      Maven本地仓库根目录\javax\servlet\servlet-api\2.5\1 servlet-api-2.5.jar

实验操作

运行 mvn archetype:generate 命令

调整
Maven 默认生成的工程，对 junit 依赖的是较低的 3.8.1 版本，我们可以改成较适合的 4.12 版本。自动生成的 App.java 和 AppTest.java 可以删除。
自动生成的 pom.xml 解读

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
47
48
49
50
51
52
<!-- 根标签：project 对当前工程进行配置管理-->
<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">
  
  <!-- modeVersion 标签： 从Maven2开始就是固定的4.0.0-->
  <!-- 代表当前pom.xml所采用的标签结构-->
  <modelVersion>4.0.0</modelVersion>

  <!-- 坐标信息 -->
  <!-- groupId 标签：坐标向量之一；代表公司或组织开发的某一个项目 -->
  <groupId>cn.jermyn.maven</groupId>

  <!-- artifactId 标签：坐标向量之一；代表项目下的某一个模块 -->
  <artifactId>pro01-maven-java</artifactId>
  
  <!-- version 标签：坐标向量之一；代表当前模块的版本 -->
  <version>1.0-SNAPSHOT</version>
  
  <!-- packaging 标签：当前Maven工程的打包方式，可选值有下面三种 -->
  <!-- jar：表示这个工程是一个Java工程 -->
  <!-- war：表示这个工程是一个Web工程 -->
  <!-- pom：表示这个工程是“管理其他工程”的工程 -->
  <packaging>jar</packaging>

  <name>pro01-maven-java</name>
  <url>http://maven.apache.org</url>

  <!-- 在Maven中定义属性值 -->
  <properties>

    <!-- 工程构建过程中读取源码时使用的字符集 -->
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>


  <!-- 当前工程所依赖的jar包 -->
  <dependencies>

    <!-- 使用dependency配置一个具体的依赖 -->
    <dependency>

      <!-- 在dependency标签内使用具体的坐标依赖我们需要的一个jar包 -->
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
      
      <!-- scope标签配置依赖的范围 -->
      <scope>test</scope>
    </dependency> 
  </dependencies>
</project>

Maven核心概念：POM

含义:POM：Project Object Model，项目对象模型。和 POM 类似的是：DOM（Document ObjectModel），文档对象模型。它们都是模型化思想的具体体现。
模型化思想:
POM 表示将工程抽象为一个模型，再用程序中的对象来描述这个模型。这样我们就可以用程序来管理项目了。我们在开发过程中，最基本的做法就是将现实生活中的事物抽象为模型，然后封装模型相关的数据作为一个对象，这样就可以在程序中计算与现实事物相关的数据。
对应的配置文件:POM 理念集中体现在 Maven 工程根目录下 pom.xml 这个配置文件中。所以这个 pom.xml 配置文件就
是 Maven 工程的核心配置文件。其实学习 Maven 就是学这个文件怎么配置，各个配置有什么用。

Maven核心概念：约定的目录结构

约定目录结构的意义:Maven 为了让构建过程能够尽可能自动化完成，所以必须约定目录结构的作用。例如：Maven 执行编译操作，必须先去 Java 源程序目录读取 Java 源代码，然后执行编译，最后把编译结果存放在 target 目录。
约定大于配置:Maven 对于目录结构这个问题，没有采用配置的方式，而是基于约定。这样会让我们在开发过程中非常方便。如果每次创建 Maven 工程后，还需要针对各个目录的位置进行详细的配置，那肯定非常麻烦。目前开发领域的技术发展趋势就是：约定大于配置，配置大于编码。

在 Maven 工程中编写代码

1、主体程序


主体程序指的是被测试的程序，同时也是将来在项目中真正要使用的程序。

1
2
3
4
5
6
7
8

package cn.jermyn.maven;

public class Calculator {
	public int sum(int i, int j){
		return i + j;
	}
}

2、测试程序


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
package cn.jermyn.maven;

import org.junit.Test;
import cn.jermyn.maven.Calculator;

// 静态导入的效果是将Assert类中的静态资源导入当前类
// 这样一来，在当前类中就可以直接使用Assert类中的静态资源，不需要写类名
import static org.junit.Assert.*;

public class CalculatorTest{
	@Test
	public void testSum(){
		
		// 1.创建Calculator对象
		Calculator calculator = new Calculator();
		
		// 2.调用Calculator对象的方法，获取到程序运行实际的结果
		int actualResult = calculator.sum(5, 3);
		
		// 3.声明一个变量，表示程序运行期待的结果
		int expectedResult = 8;
		
		// 4.使用断言来判断实际结果和期待结果是否一致
		// 如果一致：测试通过，不会抛出异常
		// 如果不一致：抛出异常，测试失败
		assertEquals(expectedResult, actualResult);
	}
}

执行 Maven 的构建命令

1、要求:

运行 Maven 中和构建操作相关的命令时，必须进入到pom.xml所在的目录。如果没有在 pom.xml 所在的目录运行 Maven 的构建令，那么会看到下面的错误信息：

1
The goal you specified requires a project to execute but there is no POM in this directory

mvn -v 命令和构建操作无关，只要正确配置了 PATH，在任何目录下执行都可以。而构建相关的命令要在 pom.xml 所在目录下运行——操作哪个工程，就进入这个工程的 pom.xml 目录。

2、清理操作

mvn clean
效果：删除 target 目录

3、编译操作

主程序编译：mvn compile

测试程序编译：mvn test-compile

主体程序编译结果存放的目录：target/classes
测试程序编译结果存放的目录：target/test-classes

4、测试操作

mvn test
测试的报告存放的目录：target/surefire-reports

5、打包操作

mvn package
打包的结果——jar 包，存放的目录：target