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{@Testpublic 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>