创建Maven版的Java工程
Maven工程的坐标
数学中使用x、y、z三个向量可以在空间中唯一的定位一个点, Maven中也可以使用groupId,artifactId,version
三个向量在Maven的仓库中唯一的定位到一个jar包
groupId
: 公司或组织域名的倒序, 通常也会加上项目名称代表公司或组织开发的一个项目,如com.atguigu.mavenartifactId
: 一个项目或者是项目下的一个模块的名称,将来作为Maven工程的工程名,如pro01-atguigu-mavenversion
: 当前模块的版本号,根据自己的需要设定 , 如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>