03在命令行环境中创建Maven版的Java工程,了解pom.xml文件的结构,了解Java工程的目录结构并编写代码,执行Maven相关的构建命令

创建Maven版的Java工程

Maven工程的坐标

数学中使用x、y、z三个向量可以在空间中唯一的定位一个点, Maven中也可以使用groupId,artifactId,version三个向量在Maven的仓库中唯一的定位到一个jar包

• groupId: 公司或组织域名的倒序, 通常也会加上项目名称代表公司或组织开发的一个项目,如com.atguigu.maven
• artifactId: 一个项目或者是项目下的一个模块的名称,将来作为Maven工程的工程名,如pro01-atguigu-maven
• version: 当前模块的版本号，根据自己的需要设定 , 如1.0-SNAPSHOT(SNAPSHOT表示快照版本,即正在迭代过程中不稳定的版本)

根据jar包的坐标可以确定它在Maven本地仓库中存储的位置

<!--jar包在Maven本地仓库中的位置: Maven本地仓库根目录\javax\servlet\servlet-api\2.5\servlet-api-2.5.jar-->
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>

使用命令生成Java工程

第一步: 任意创建一个目录作为本地的工作空间,例如D:\maven-workspace\space

第二步: 在Maven的本地工作空间目录下打开命令行窗口,运行mvn archetype:generate命令根据提示操作

> Choose a number or apply filter (format: \[groupId:\]artifactId, case sensitive contains): 7【直接回车,7是默认值表示快速开始】
> Define value for property 'groupId': com.atguigu.maven[创建项目的名称]
> Define value for property 'artifactId': pro01-maven-java[创建项目的模块的名称]
> Define value for property 'version' 1.0-SNAPSHOT: :【直接回车，使用默认值】
> Define value for property 'package' com.atguigu.maven: :【直接回车，使用默认值】
> Confirm properties configuration: 
	groupId: com.atguigu.maven 
	artifactId: pro01-maven-java 
	version: 1.0-SNAPSHOT 
	package: com.atguigu.maven 
	Y::【直接回车表示确认。如果前面有输入错误，想要重新输入则输入N再回车】

第三步: 配置Maven工程自动生成的pom.xml文件 , 对创建好的Java工程的依赖信息做一点调整

• Maven默认生成的工程对junit依赖的是较低的3.8.1版本(不支持注解),建议改成较适合的4.12版本, 另外自动生成的App.java和AppTest.java也可以删除

<!--dependencies复数标签：里面包含dependency单数标签-->
<dependencies>
	<!--dependency单数标签：配置一个具体的依赖-->
	<dependency>
		<!--通过坐标来依赖其他jar包-->
		<groupId>junit</groupId>
		<artifactId>junit</artifactId>
		<version>4.12</version>
		<!-- 依赖的范围 -->
		<scope>test</scope>
	</dependency>
</dependencies>

Maven中POM文件的结构

POM(Project Object Model)是项目对象模型 , 类似DOM(Document Object Model)文档对象模型 , 它们都是模型化思想的具体体现

• POM表示将工程抽象为一个模型，再用程序中的对象来描述这个模型, 这样我们就可以用程序来管理项目了
• 将现实生活中的事物抽象为模型，然后封装模型相关的数据作为一个对象，这样就可以在程序中计算与现实事物相关的数据

POM理念集中体现在Maven工程根目录下的Maven核心配置文件pom.xml中 , 学习Maven就是学习如何配置这个文件

• 配置当前Maven工程的坐标
• 配置当前Maven工程的打包方式: jar(当前是Java工程), war(当前是Web工程),pom(当前工程是管理其他工程的工程)
• 配置当前Maven工程依赖的jar包

<?xml version="1.0" encoding="UTF-8"?>
<!--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">
    <!--modelVersion标签:代表当前pom.xml所采用的标签结构,从Maven2开始就固定是4.0.0-->
    <modelVersion>4.0.0</modelVersion>
    
    <!--当前Maven工程的坐标-->
    <groupId>com.atguigu.maven</groupId>
    <artifactId>pro01-maven-java</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!--当前Maven工程的打包方式-->
    <packaging>jar</packaging>
	
    <!--当前Maven工程的名字,可省略-->
    <name>pro01-maven-java</name>
    <!--maven的官网地址,可省略-->
    <url>http://maven.apache.org</url>

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

    <!--当前工程所依赖的jar包的坐标-->
    <dependencies>
        <!--使用dependency配置一个具体的依赖-->
        <dependency>
            <!--要导入哪个jar包就配置它的坐标信息即可-->
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <!--4.0以下的版本不支持注解-->
            <version>4.12</version> 
            <!--配置依赖的范围-->
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

Maven规定Java工程目录结构

Maven为了让构建过程能够尽可能自动化完成,所以必须约定目录结构的作用(在超级pom.xml中已经定义好了目录结构)

• Maven执行编译操作时必须先去知道Java源程序在哪才能执行编译,最后把编译结果存放在规定的target目录(专门存放构建操作输出的结果)

目前开发领域的技术发展趋势就是约定大于配置,配置大于编码

• Maven对于目录结构这个问题，没有采用配置的方式而是基于约定 , 若每次创建Maven工程后，还需要针对各目录的位置进行详细配置，那肯定非常麻烦

在Java工程中编写代码

主体程序

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

package com.atguigu.maven;
	
public class Calculator {
	public int sum(int i, int j){
		return i + j;
	}
}

测试程序

测试程序所在的包结构一般要求和被测试程序的包结构对应

package com.atguigu.maven;
import org.junit.Test;
import com.atguigu.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的构建命令

执行构建命令时必须知道要操作的是哪个工程,所以在Maven中运行和构建操作相关的命令时,必须进入到pom.xml文件所在的目录,否则会报错

• 只有mvn -v命令和构建操作无关，只要正确配置了PATH在任何目录下执行都可以

#错误提示
The goal you specified requires a project to execute but there is no POM in this directory

Maven生命周期的体现: 执行某一个命令时其前面的命令默认都会执行一遍, 另外命令还可以组合起来按照先后顺序执行

• 如执行测试命令中会提前自动执行编译命令，测试成功就说明编译也是成功的

命令名	作用
mvn clean	清理操作, 删除target目录
mvn compile	编译操作, 主程序编译(生成target目录, 主体程序编译结果存放在target/classes目录)
mvn test-compile	编译操作,测试程序编译(生成target目录, 测试程序编译结果存放在target/test-classes目录)
mvn test	测试操作,调用测试程序的测试方法 (测试的报告存放在target/surefire-reports目录) ,
mvn package	打包操作, 打包后的jar包(不含测试程序)存放在target目录 ,jar包的名字由模块名称-模块版本号组成
mvn install	安装操作

安装操作有两个效果

• 将本地构建过程中生成的jar包存入Maven本地仓库(在Maven仓库中的路径是根据它的坐标生成的)
• 将pom.xml文件转换为 XXX.pom文件一起存入本地仓库 , 只是名字变成了模块名称-模块版本号.pom，本质上它们是同一个文件

<!--jar包在仓库中生成的路径: Maven本地仓库根目录\com\atguigu\maven\pro01-maven-java\1.0-SNAPSHOT\pro01-maven-java-1.0-SNAPSHOT.jar--> 
<groupId>com.atguigu.maven</groupId>
<artifactId>pro01-maven-java</artifactId>
<version>1.0-SNAPSHOT</version>