Maven学习笔记2:Maven核心概念
阅读原文时间:2023年07月08日阅读:1

一、Maven工程约定目录结构

(说是约定,既是说它是大多数人都遵守的规范,但不是强制的)

这是官网给的例子,可以复制它的pom.xml来修改

第一步:建立项目

按照上图所示的目录结构手动建立一个项目,目录结构如下:

其中pom.xml文件内容如下,注释内容为此处简单理解,后面会xiang'shuo详说:

<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>4.0.0</modelVersion>

  <groupId>com.abc</groupId>        <!--包-->
  <artifactId>Hello</artifactId>     <!--项目名字-->
  <version>1.0-SNAPSHOT</version>   <!--项目版本号-->

</project>

HelloMaven.java文件内容如下:

package com.abc;

public class HelloMaven {
    public static void main(String[] args) {
        int res = add(50,40);
        System.out.println("50 + 40 = " + res);
    }

    public static int add(int a,int b) {
        return a+b;
    }
}

第二步:编译项目

启动cmd,跳转到Hello目录下(要在pom.xml文件所在目录执行),输入mvn compile

回车之后,项目就开始编译,如果是第一次使用的话,他会自动去下载一些包到默认本地仓库,如图所示:

关于这里的几个问题:

  1. 为什么要下载这些东西?

    Maven工具执行的操作需要很多插件来完成,所以需要将这些插件(jar文件)下载到本地

  2. 从哪里下载?

    从网上的仓库下载,随便复制一条语句出来如下:Downloaded from central: https://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-compiler-plugin/3.1/maven-compiler-plugin-3.1.jar (43 kB at 77 kB/s)

    这里的https://repo.maven.apache.org:中央仓库地址

  3. 下载到哪里?

    放到了默认仓库中,默认仓库的位置在C:\Users\Admin\.m2\repository(修改请看上一篇博客)

这里我在编译过程中出现了错误,如下:

在网上找到了解决办法,修改pom.xml文件

所以我们将pom.xml文件修改如下:

<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>4.0.0</modelVersion>

  <groupId>com.abc</groupId>        <!--包-->
  <artifactId>Hello</artifactId>     <!--项目名字-->
  <version>1.0-SNAPSHOT</version>   <!--项目版本号-->

  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

</project>

其实这个在官网给的示例中是有这个的,我嫌麻烦给删掉了,就导致了这个错误,我用的jdk是1.8的所以就改为1.8

之后再进行编译,就成功了

此时可以看到Hello目录下多了一个target目录,这个就是编译生成的结果目录

HelloMaven.java编译后的HelloMaven.class文件在此目录下:

在target/classes目录下执行java指令运行程序,就可以看到运行结果了

二、仓库

仓库就是用来存放Maven使用的各种插件(jar包)以及我们项目中使用到的第三方工具(jar包)的一个目录

  1. 本地仓库:存在个人计算机上的文件夹,为本机上所有Maven工程提供服务

  2. 远程仓库:存在于互联网上,使用网络才能使用的仓库

    中央仓库:(中央仓库地址)最权威的,所有开发人员都共享使用的一个集中的仓库

    中央仓库镜像:就是中央仓库的备份,在各大洲,重要的城市都是使用镜像

    私服:在公司内部,在局域网中使用的,不是对外使用的

Maven仓库的使用过程不需要人为参与的

比如:我们需要mysql驱动,Maven会按照这样的顺序去查找,直到找到为止:

本地--->私服--->镜像--->中央仓库

三、pom文件

即Project Object Model项目对象模型。Maven把一个项目的结构和内容抽象成一个模型,在xml文件中进行声明,以方便进行构建和描述,它是Maven的灵魂,Maven环境搭建好之后,所有的学习和操作都是关于pom.xml的

基本信息

modelVersion

Maven模型的版本,对于Maven2和 Maven3来说,它只能是4.0.0

groupId

组织id,一般是公司域名的倒写。格式可以为:
1.域名倒写。例如 com.baidu
2.域名倒写+项目名。例如 com.baidu.appolo

artifactId

项目名称,也是模块名称,对应 groupId中项目中的子项目。

version

项目的版本号。如果项目还在开发中,是不稳定版本,通常在版本后带-SNAPSHOT
version使用三位数字标识,例如1.1.0

packaging

项目打包的类型,可以使jar、war、rar、ear、pom,默认是jar

依赖

dependencies和dependency

Maven的一个重要作用就是管理jar包,为了一个项目可以构建或运行,项目中不可避免的,会依赖很多其他的jar包,在 Maven中,这些jar就被称为依赖,使用标签dependency来配置。而这种依赖的配置正是通过坐标来定位的,由此我们也不难看出,maven把所有的jar包也都视为项目存在了。

配置属性

properties

properties是用来定义一些配置属性的,例如project.build.sourceEncoding (项目构建源码编码方式),可以设置为UTF-8,防止中文乱码,也可定义相关构建版本号,便于日后统一升级。

构建

build

build表示与构建相关的配置,例如设置编译插件的jdk版本

继承

parent

在Maven中,如果多个模块都需要声明相同的配置,例如: groupId、version、有相同的依赖、或者相同的组件配置等,也有类似Java 的继承机制,用parent声明要继承的父工程的pom配置。

聚合

modules

在Maven的多模块开发中,为了统一构建整个项目的所有模块,可以提供一个额外的模块,该模块打包方式为pom,并且在其中使用modules聚合的其它模块,这样通过本模块就可以一键自动识别模块间的依赖关系来构建所有模块,叫Maven的聚合。

四、坐标

Maven 把任何一个插件都作为仓库中的一个项目进行管理,用一组(三个)向量组成的坐标来表示。坐标在仓库中可以唯一定位一个Maven 项目。

  1. groupld:组织名,通常是公司或组织域名倒序+项目名
  2. artifactld:模块名,通常是工程名
  3. version:版本号

需要特别指出的是,项目在仓库中的位置是由坐标来决定的: groupld、artifactld和 version 决定项目在仓库中的路径,artifactld和 version决定jar包的名称。

用于搜索的中央仓库的使用

如何按照坐标去查找mysql驱动?

Maven用于搜索使用的中央仓库www.mvnrepository.com,使用groupId或者artifactId作为搜索条件

输入mysql,点击search

点击第一个

选择一个版本点击进去

五、依赖

依赖就类似于java中的import

在pom.xml中导入一个依赖示例:

<dependencies>
    <!-- log4j:日志依赖 -->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>

    <!-- https://mvnrepository.com/artifact/junit/junit -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.11</version>
        <scope>test</scope>
    </dependency>

    <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.37</version>
    </dependency>

</dependencies>

导入多个依赖就在<dependencies>中导入多个<dependency>

六、Maven的生命周期

对项目的构建是建立在生命周期模型上的T它明确定义项目生命周期各个阶段,并且对于每一个阶段提供相对应的命令,对开发者而言仅仅需要掌握一小堆的命令就可以完成项目各个阶段的构建工作。

构建项目时按照生命周期顺序构建,每一个阶段都有特定的插件来完成。不论现在要执行生命周期中的哪个阶段,都是从这个生命周期的最初阶段开始的。

对于我们程序员而言,无论我们要进行哪个阶段的构建,直接执行相应的命令即可,无需担心它前边阶段是否构建,Maven都会自动构建。这也就是Maven这种自动化构建工具给我们带来的好处。

七、Maven常用命令

Maven对所有的功能都提供相对应的命令,要想知道maven都有哪些命令,那要看maven有哪些功能。

maven三大功能:管理依赖、构建项目、管理项目信息。

管理依赖,只需要声明就可以自动到仓库下载。管理项目信息其实就是生成一个站点文档,maven功能的主体其实还是项目构建。

Maven提供一个项目构建的模型,把编译、测试、打包、部署等都对应成一个个的生命周期阶段,并对每一个阶段提供相应的命令,程序员只需要掌握一小堆命令,就可以完成项目的构建过程。

命令

mvn clean

清理(会删除原来编译和测试的目录,即 target目录,但是已经install到仓库里的包不会删除)

mvn compile

编译主程序(会在当前目录下生成一个target,里边存放编译主程序之后生成的字节码文件)

mvn test-compile

编译测试程序(会在当前目录下生成一个target,里边存放编译测试程序之后生成的字节码文件)

mvn test

测试(会生成一个目录surefire-reports,保存测试结果)

mvn package

打包主程序(会编译、编译测试、测试、并且按照pom.xml配置把主程序打包生成jar包或者war包)

mvn install

安装主程序(会把本工程打包,并且按照本工程的坐标保存到本地仓库中)

mvn deploy

部署主程序(会把本工程打包,按照本工程的坐标保存到本地库中,并且还会保存到私服仓库中。还会自动把项目部署到 web容器中)。

注意:执行以上命令必须在命令行进入pom.xml所在目录!

Maven就是Maven构建项目的过程,包括清理、编译、测试、报告等

Maven命令就是Maven独立使用的时候,通过Maven命令完成Maven生命周期的执行

Maven命令执行时,真正做事是Maven插件

插件可以在自己的项目中设置,最常使用的是maven编译插件。设置项目使用的jdk版本时通过编译插件指定。pom.xml文件<build>中设置。

<build>
  <!-- 配置插件 -->
      <plugins>
          <!-- 配置具体的插件 -->
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <!-- 插件名称 -->
              <artifactId>maven-compiler-plugin</artifactId>
              <!-- 插件版本 -->
              <version>3.8.1</version>
              <!-- 配置插件信息 -->
              <configuration>
                  <!-- 告诉Maven此代码是在jdk1.8上编译的 -->
                  <source>1.8</source>
                  <!-- 程序应该运行在jdk1.8上 -->
                  <target>1.8</target>
              </configuration>
          </plugin>
      </plugins>
</build>

一个例子:

使用junit进行单元测试(测试方法):

junit是一个专门测试的框架(工具)

测试内容:

测试的是类中的方法,每一个方法都是独立测试的,方法是测试的基本单位

测试步骤:

  1. 在pom.xml中加入单元测试依赖

    junit junit 4.11 test

  2. 在maven项目中的src/test/java目录下,创建测试程序。

    推荐的创建类和方法的提示:

    1.测试类的名称是Test +你要测试的类名

    2.测试的方法名称是:Test +方法名称

例如:要测试HelloMaven

创建测试类TestHelloMaven

创建测试方法:

@test
public void testAdd(){
    //测试HelloMaven的add方法是否正确
}

其中testAdd叫做测试方法,它的定义规则

1.方法是public的,必须的

2.方法没有返回值,必须的

3.方法名称是自定义的,推荐是Test +方法名称

4.在方法的上面加入@Test

对于上面的例子:

我们在test/com/abc目录下添加如下代码:

package com.abc;
import org.junit.Assert;
import org.junit.Test;

public class TestHelloMaven {
    @test
    public void testAdd(){
        System.out.println("testAdd");
        int res = HelloMaven.add(50,40);
        //期望值,实际值
         Assert.assertEquals(90,res);
    }
}

回到Hello目录下,执行mvn clean

可以看到Hello下的target目录被删除了,接下来执行mvn compilemvn test-compile编译源代码和测试代码

这里需要说明的是:测试代码编译后放在target/test-classes/com/abc中

接着执行mvn test,进行代码测试,

执行完这一步之后,会在target文件夹下生成测试报告

与上面控制台显示的测试结果一样

将代码故意改错,让测试不通过观察一下现象:

如上,报告测试不通过信息

接下来执行mvn package

打包之后在target下产生jar文件

接下来执行mvn install安装项目

我的本地仓库中就有了我刚才打包后的项目,如果别人可以访问我的仓库的话,他就可以使用我的这个jar了