自学内容网 自学内容网

JavaWeb--Maven

1.初始Maven

1.1介绍

Maven 是一款用于管理和构建Java项目的工具,是Apache旗下的一个开源项目 。

1.2Maven的作用

3f3c50a1be3a4b75bedaedb546cb1083.png

2.Maven概述

2.1Maven介绍

Apache Maven是一个项目管理和构建工具,它基于项目对象模型(Project Object Model , 简称: POM)的概念,通过一小段描述信息来管理项目的构建、报告和文档。

2.2Maven模型

  • 项目对象模型 (Project Object Model)

  • 依赖管理模型(Dependency)

  • 构建生命周期/阶段(Build lifecycle & phases)

9768cb53970f4007a1c5d1a516ff3a37.png

以上图中紫色框起来的部分,就是用来完成标准化构建流程 。当我们需要编译,Maven提供了一个编译插件供我们使用;当我们需要打包,Maven就提供了一个打包插件供我们使用等。

86f5da96520d4d14b74dac8867d855bd.png

以上图中紫色框起来的部分属于项目对象模型,就是将我们自己的项目抽象成一个对象模型,有自己专属的坐标,如下图所示是一个Maven项目:

236f06636b3249fbb0b3562561201838.png

坐标,就是资源(jar包)的唯一标识,通过坐标可以定位到所需资源(jar包)位置。

坐标的组成部分:

  • groupId: 组织名

  • arfitactId: 模块名

  • Version: 版本号

3aedeb49478944298787f7c4a768fb68.png

以上图中紫色框起来的部分属于依赖管理模型,是使用坐标来描述当前项目依赖哪些第三方jar包。

c33178b6ff464c638bf4a0b8ed8d39f9.png

之前我们项目中需要jar包时,直接就把jar包复制到项目下的lib目录,而现在我们只需要在pom.xml中配置依赖的配置文件即可。 而这个依赖对应的jar包其实就在我们本地电脑上的maven仓库中。

2.3Maven仓库

仓库:用于存储资源,管理各种jar包

仓库的本质就是一个目录(文件夹),这个目录被用来存储开发中所有依赖(就是jar包)和插件

Maven仓库分为:

  • 本地仓库:自己计算机上的一个目录(用来存储jar包)

  • 中央仓库:由Maven团队维护的全球唯一的。仓库地址:https://repo1.maven.org/maven2/

  • 远程仓库(私服):一般由公司团队搭建的私有仓库

061f34695ea24d5a932cab09ce2b8367.png

当项目中使用坐标引入对应依赖jar包后,

  • 首先会查找本地仓库中是否有对应的jar包

    • 如果有,则在项目直接引用

    • 如果没有,则去中央仓库中下载对应的jar包到本地仓库

  • 如果还可以搭建远程仓库(私服),将来jar包的查找顺序则变为: 本地仓库 --> 远程仓库--> 中央仓库

3.IDEA集成Maven

3.1pom文件详解

POM (Project Object Model) :指的是项目对象模型,用来描述当前的maven项目。

  • 使用pom.xml文件来描述当前项目。 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/xsd/maven-4.0.0.xsd">
    <!-- POM模型版本 -->
    <modelVersion>4.0.0</modelVersion>

    <!-- 当前项目坐标 -->
    <groupId>com.itheima</groupId>
    <artifactId>maven-project01</artifactId>
    <version>1.0-SNAPSHOT</version>
    
    <!-- 项目的JDK版本及编码 -->
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

</project>

pom文件详解:

  • <project> :pom文件的根标签,表示当前maven项目

  • <modelVersion>:声明项目描述遵循哪一个POM模型版本

    • 虽然模型本身的版本很少改变,但它仍然是必不可少的。目前POM模型版本是4.0.0

  • 坐标 :

    • <groupId> <artifactId> <version>

    • 定位项目在本地仓库中的位置,由以上三个标签组成一个坐标

  • <maven.compiler.source> :编译JDK的版本

  • <maven.compiler.target> :运行JDK的版本

  • <project.build.sourceEncoding> : 设置项目的字符集

3.2Maven坐标

  • Maven中的坐标是资源的唯一标识 , 通过该坐标可以唯一定位资源位置

  • 使用坐标来定义项目或引入项目中需要的依赖

Maven坐标主要组成:

  • groupId:定义当前Maven项目隶属组织名称(通常是域名反写,例如:com.itheima)

  • artifactId:定义当前Maven项目名称(通常是模块名称,例如 order-service、goods-service)

  • version:定义当前项目版本号

    • SNAPSHOT: 功能不稳定、尚处于开发中的版本,即快照版本

    • RELEASE: 功能趋于稳定、当前更新停止,可以用于发行的版本

如下图就是使用坐标表示一个项目:

4de9f713d3184562a0e2576e8eb6139f.png

注意:

  • 上面所说的资源可以是插件、依赖、当前项目。

  • 我们的项目如果被其他的项目依赖时,也是需要坐标来引入的。

4.依赖管理

4.1依赖配置

4.1.1基本配置

依赖:指当前项目运行所需要的jar包。一个项目中可以引入多个依赖:

例如:在当前工程中,我们需要用到logback来记录日志,此时就可以在maven工程的pom.xml文件中,引入logback的依赖。具体步骤如下:

  1. 在pom.xml中编写<dependencies>标签

  2. <dependencies>标签中使用<dependency>引入坐标

  3. 定义坐标的 groupIdartifactIdversion

<dependencies>
    <!-- 依赖 : spring-context -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>6.1.4</version>
    </dependency>
</dependencies>
  1. 点击刷新按钮,引入最新加入的坐标

刷新依赖:保证每一次引入新的依赖,或者修改现有的依赖配置,都可以加入最新的坐标

23d3609f83d7464e8230b2fb2e16f585.png

注意事项:

  1. 如果引入的依赖,在本地仓库中不存在,将会连接远程仓库 / 中央仓库,然后下载依赖(这个过程会比较耗时,耐心等待)

  2. 如果不知道依赖的坐标信息,可以到mvn的中央仓库(https://mvnrepository.com/)中搜索

4.1.2依赖传递

我们上面在pom.xml中配置了一项依赖,就是spring-context,但是我们通过右侧的maven面板可以看到,其实引入进来的依赖,并不是这一项,有非常多的依赖,都引入进来了。我们可以看到如下图所示:

6e3753f2e70f49de8974f7ca8b7c7b25.png

为什么会出现这样的现象呢? 那这里呢,就涉及到maven中非常重要的一个特性,那就是Maven中的依赖传递

所谓maven的依赖传递,指的就是如果在maven项目中,A 依赖了B,B依赖了C,C依赖了D,那么在A项目中,也会有C、D依赖,因为依赖会传递。

那如果,传递下来的依赖,在项目开发中,我们确实不需要,此时,我们可以通过Maven中的排除依赖功能,来将这个依赖排除掉。

4.1.3排除依赖

  • 排除依赖:指主动断开依赖的资源,被排除的资源无需指定版本。

  • 配置形式如下:

  • <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>6.1.4</version>
    
        <!--排除依赖, 主动断开依赖的资源-->
        <exclusions>
            <exclusion>
                <groupId>io.micrometer</groupId>
                <artifactId>micrometer-observation</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

    依赖排除示例:

  • 默认通过maven的依赖传递,传递下来了 micrometer-observation 的依赖。

93bed3eb681d439c9adac2144f7f5586.png

4.2生命周期

4.2.1介绍

Maven的生命周期就是为了对所有的构建过程进行抽象和统一。 描述了一次项目构建,经历哪些阶段。

在Maven出现之前,项目构建的生命周期就已经存在,软件开发人员每天都在对项目进行清理,编译,测试及部署。虽然大家都在不停地做构建工作,但公司和公司间、项目和项目间,往往使用不同的方式做类似的工作。

Maven从大量项目和构建工具中学习和反思,然后总结了一套高度完美的,易扩展的项目构建生命周期。这个生命周期包含了项目的清理,初始化,编译,测试,打包,集成测试,验证,部署和站点生成等几乎所有构建步骤。

Maven对项目构建的生命周期划分为3套(相互独立):

d777cb2379454e61af68686670f60fa6.png

  • clean:清理工作。

  • default:核心工作。如:编译、测试、打包、安装、部署等。

  • site:生成报告、发布站点等。

三套生命周期又包含哪些具体的阶段呢, 我们来看下面这幅图:

ef45a96d52a94d0980e04d4ca6843411.png

每套生命周期包含一些阶段(phase),阶段是有顺序的,后面的阶段依赖于前面的阶段。

我们看到这三套生命周期,里面有很多很多的阶段,这么多生命周期阶段,其实我们常用的并不多,主要关注以下几个:

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

  • compile:编译项目源代码

  • test:使用合适的单元测试框架运行测试(junit)

  • package:将编译后的文件打包,如:jar、war等

  • install:安装项目到本地仓库

Maven的生命周期是抽象的,这意味着生命周期本身不做任何实际工作。在Maven的设计中,实际任务(如源代码编译)都交由插件来完成。

d28e857ff84e490cb16edf679576843f.png

IDEA工具为了方便程序员使用maven生命周期,在右侧的maven工具栏中,已给出快速访问通道。

ebf8cfca1481467d85e588a83a4b1e50.png

  • 生命周期的顺序是:clean --> validate --> compile --> test --> package --> verify --> install --> site --> deploy

  • 我们需要关注的就是:clean --> compile --> test --> package --> install

说明:在同一套生命周期中,我们在执行后面的生命周期时,前面的生命周期都会执行。

思考:当运行package生命周期时,clean、compile生命周期会不会运行?

clean不会运行,compile会运行。 因为compile与package属于同一套生命周期,而clean与package不属于同一套生命周期。

4.2.2执行

在日常开发中,当我们要执行指定的生命周期时,有两种执行方式:

  1. 在idea工具右侧的maven工具栏中,选择对应的生命周期,双击执行

  2. 在DOS命令行中,通过maven命令执行(略)

在idea中执行生命周期

  • 选择对应的生命周期,双击执行

c6fbc029f5dd458c85e4d1323b564672.png

其他的生命周期都是类似的道理,双击运行即可。

5.单元测试

5.1介绍

测试:是一种用来促进鉴定软件的正确性、完整性、安全性和质量的过程。

阶段划分:单元测试、集成测试、系统测试、验收测试。

12c729f3570c47fea18db373f53bce32.png

1). 单元测试

  • 介绍:对软件的基本组成单位进行测试,最小测试单位。

  • 目的:检验软件基本组成单位的正确性。

  • 测试人员:开发人员

2). 集成测试

  • 介绍:将已分别通过测试的单元,按设计要求组合成系统或子系统,再进行的测试。

  • 目的:检查单元之间的协作是否正确。

  • 测试人员:开发人员

3). 系统测试

  • 介绍:对已经集成好的软件系统进行彻底的测试。

  • 目的:验证软件系统的正确性、性能是否满足指定的要求。

  • 测试人员:测试人员

4). 验收测试

  • 介绍:交付测试,是针对用户需求、业务流程进行的正式的测试。

  • 目的:验证软件系统是否满足验收标准。

  • 测试人员:客户/需求方

测试方法:白盒测试、黑盒测试 及 灰盒测试。

bb112fb917b74f0da90055a1ca1948a1.png

1). 白盒测试

清楚软件内部结构、代码逻辑。

用于验证代码、逻辑正确性。

2). 黑盒测试

不清楚软件内部结构、代码逻辑。

用于验证软件的功能、兼容性、验收测试等方面。

3). 灰盒测试

结合了白盒测试和黑盒测试的特点,既关注软件的内部结构又考虑外部表现(功能)。

4b07f57855ef407087411d785ae2a042.png

5.2Junit入门

5.2.1单元测试

  • 单元测试:就是针对最小的功能单元(方法),编写测试代码对其正确性进行测试。

  • JUnit:最流行的Java测试框架之一,提供了一些功能,方便程序进行单元测试(第三方公司提供)。

在之前的课程中,我们进行程序的测试 ,都是main方法中进行测试 。如下图所示:

dcd29a97686547319b99e344def1d887.png

通过main方法是可以进行测试的,可以测试程序是否正常运行。但是main方法进行测试时,会存在如下问题:

  1. 测试代码与源代码未分开,难维护。

  2. 一个方法测试失败,影响后面方法。

  3. 无法自动化测试,得到测试报告。

而如果我们使用了JUnit单元测试框架进行测试,将会有以下优势:

  1. 测试代码与源代码分开,便于维护。

  2. 可根据需要进行自动化测试。

  3. 可自动分析测试结果,产出测试报告。

c525b0b4e8234c078641677ed3bcf503.png

5.2.2入门程序

需求:使用JUnit,对UserService中的业务方法进行单元测试,测试其正确性。

1.在pom.xml中,引入JUnit的依赖。

<!--Junit单元测试依赖-->
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>5.9.1</version>
    <scope>test</scope>
</dependency>

2.在test/java目录下,创建测试类,并编写对应的测试方法,并在方法上声明@Test注解。

测试类
package com.itheima;

import java.time.LocalDate;
import java.time.Period;
import java.time.format.DateTimeFormatter;

public class UserService {

    /**
     * 给定一个身份证号, 计算出该用户的年龄
     * @param idCard 身份证号
     */
    public Integer getAge(String idCard){
        if (idCard == null || idCard.length() != 18) {
            throw new IllegalArgumentException("无效的身份证号码");
        }
        String birthday = idCard.substring(6, 14);
        LocalDate parse = LocalDate.parse(birthday, DateTimeFormatter.ofPattern("yyyyMMdd"));
        return Period.between(parse, LocalDate.now()).getYears();
    }

    /**
     * 给定一个身份证号, 计算出该用户的性别
     * @param idCard 身份证号
     */
    public String getGender(String idCard){
        if (idCard == null || idCard.length() != 18) {
            throw new IllegalArgumentException("无效的身份证号码");
        }
        return Integer.parseInt(idCard.substring(16,17)) % 2 == 1 ? "男" : "女";
    }

}

    @Test
    public void testGetAge() {
        UserService userService =new UserService();
        Integer age = userService.getAge("100000200401101011");
        System.out.println(age);
    }

    @Test
    public void testGetGender() {
        UserService userService =new UserService();
        String gender = userService.getGender("100000200401101011");
        System.out.println(gender);
    }

3.运行单元测试 (测试通过:绿色;测试失败:红色)

  • 测试通过显示绿色

f5e53d5bf9864181b9b4186862f7a736.png

  • 测试失败显示红色

e68ec9a1f9154475995e250a5dc62adc.png

注意:

  • 测试类的命名规范为:XxxxTest

  • 测试方法的命名规定为:public void xxx(){...}

5.3断言

JUnit提供了一些辅助方法,用来帮我们确定被测试的方法是否按照预期的效果正常工作,这种方式称为断言

7b52280e16bd4ee39025dad76d573102.png

package com.itheima;

import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;

public class UserServiceTest {
//    @Test
//    public void testGetAge() {
//        UserService userService =new UserService();
//        Integer age = userService.getAge("100000200401101011");
//        System.out.println(age);
//    }
//
//    @Test
//    public void testGetGender() {
//        UserService userService =new UserService();
//        String gender = userService.getGender("100000200401101011");
//        System.out.println(gender);
//    }

/**
 * 断言
 */
    //assertEquals
    @DisplayName("assertEquals")
    @Test
    public void testGenderWithAssert(){
        UserService userService =new UserService();
        String gender = userService.getGender("100000200401101011");
        Assertions.assertEquals("男",gender,"性别不对");
    }

    //assertNotEquals
    @DisplayName("assertNotEquals")
    @Test
    public void testGenderWithAssert3() {
        UserService userService = new UserService();
        String gender = userService.getGender("100000200401101011");
        Assertions.assertNotEquals("女",gender,"性别不对");
    }

    //assertThrows
    @DisplayName("assertThrows")
    @Test
    public void testGenderWithAssert2() {
        UserService userService = new UserService();
        Assertions.assertThrows(IllegalArgumentException.class, () -> {
                    userService.getGender(null);
                }
        );
    }

    //assertTrue
    @DisplayName("assertTrue")
    @Test
    public void testGenderWithAssert4() {
        UserService userService = new UserService();
        String gender = userService.getGender("100000200401101011");
        Assertions.assertTrue(gender.equals("男"),"性别不对");
    }

    //assertFalse
    @DisplayName("assertFalse")
    @Test
    public void testGenderWithAssert5() {
        UserService userService = new UserService();
        String gender = userService.getGender("100000200401101011");
        Assertions.assertFalse(gender.equals("女"),"性别不对");
    }

    //assertNotNull
    @DisplayName("assertNotNull")
    @Test
    public void testGenderWithAssert7() {
        UserService userService = new UserService();
        String gender = userService.getGender("100000200401101011");
        Assertions.assertNotNull(gender,"性别不对");
    }

}

5.4常见注解

在JUnit中还提供了一些注解,还增强其功能,常见的注解有以下几个:

演示 @BeforeEach@AfterEach@BeforeAll@AfterAll 注解:

public class UserServiceTest {

    @BeforeEach
    public void testBefore(){
        System.out.println("before...");
    }

    @AfterEach
    public void testAfter(){
        System.out.println("after...");
    }

    @BeforeAll //该方法必须被static修饰
    public static void testBeforeAll(){ 
        System.out.println("before all ...");
    }

    @AfterAll //该方法必须被static修饰
    public static void testAfterAll(){
        System.out.println("after all...");
    }

    @Test
    public void testGetAge(){
        Integer age = new UserService().getAge("110002200505091218");
        System.out.println(age);
    }
    
    @Test
    public void testGetGender(){
        String gender = new UserService().getGender("612429198904201611");
        System.out.println(gender);
    }
 }   

输出结果如下:

演示 @ParameterizedTest @ValueSource@DisplayName 注解:

package com.itheima;

import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
@DisplayName("测试-学生业务操作")
public class UserServiceTest {
    @DisplayName("测试-获取年龄")
    @Test
    public void testGetAge(){
        Integer age = new UserService().getAge("110002200505091218");
        System.out.println("测试-获取年龄"+age);
    }

    @DisplayName("测试-获取性别")
    @Test
    public void testGetGender(){
        String gender = new UserService().getGender("612429198904201611");
        System.out.println("测试-获取性别"+gender);
    }

    @DisplayName("测试-获取性别3")
    @ParameterizedTest
    @ValueSource(strings = {"612429198904201611","612429198904201631","612429198904201626"})
    public void testGetGender3(String idcard){
        String gender = new UserService().getGender(idcard);
        System.out.println("测试-获取性别3"+gender);
    }

}

输出结果如下:

思考: 在maven项目中,test目录存放单元测试的代码,是否可以在main目录中编写单元测试呢 ? 可以,但是不规范

5.5依赖范围

依赖的jar包,默认情况下,可以在任何地方使用,在main目录下,可以使用;在test目录下,也可以使用。

在maven中,如果希望限制依赖的使用范围,可以通过 <scope>…</scope> 设置其作用范围。

​​​​​​​作用范围:

  • 主程序范围有效。(main文件夹范围内)

  • 测试程序范围有效。(test文件夹范围内)

  • 是否参与打包运行。(package指令范围内)

可以在pom.xml中配置 <scope></scope> 属性来控制依赖范围。

如果对Junit单元测试的依赖,设置了scope为 test,就代表,该依赖,只是在测试程序中可以使用,在主程序中是无法使用的。所以我们会看到如下现象:

如上图所示,给junit依赖通过scope标签指定依赖的作用范围。 那么这个依赖就只能作用在测试环境,其他环境下不能使用。

scope的取值常见的如下:

6.Maven常见问题

  • 问题现象:Maven项目中添加的依赖,未正确下载,造成右侧Maven面板中的依赖报红,再次reload重新加载也不会再下载。

  • 产生原因:由于网络原因,依赖没有下载完整导致的,在maven仓库中生成了xxx.lastUpdated文件,该文件不删除,不会再重新下载。

解决方案:

  1. 根据maven依赖的坐标,找到仓库中对应的 xxx.lastUpdated 文件,删除,删除之后重新加载项目即可。

  2. 通过命令 (del /s *.lastUpdated) 批量递归删除指定目录下的 xxx.lastUpdated 文件,删除之后重新加载项目即可。

  3. 重新加载依赖,依赖下载了之后,maven面板可能还会报红,此时可以关闭IDEA,重新打开IDEA加载此项目即可。


原文地址:https://blog.csdn.net/2303_80261946/article/details/143572361

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!