[Java]maven从入门到进阶

介绍

apache旗下的开源项目,用于管理和构建java项目的工具

官网: Welcome to The Apache Software Foundation!

1.依赖管理

通过简单的配置, 就可以方便的管理项目依赖的资源(jar包), 避免版本冲突问题

优势: 基于项目对象模型(POM),通过一小段描述信息来管理项目的构建

2.统一目录结构

提供标准, 统一的项目结构

3.项目构建

标准跨平台(linux/windows/MacOs)的自动化项目构建方式

POM

仓库

用来管理和存储jar包

1.本地仓库

本机的仓库, 计算机上的一个目录
项目中使用的依赖会先在本地仓库中查找

2.远程仓库

公司/团队维护的仓库
需要配置,不配置就直连中央仓库
下载流程

本地仓库中不存在的依赖再来远程仓库查找
依赖存在直接下载使用
依赖不存在去中央仓库下载

好处

连接中央的仓库的速度较慢, 因为要访问外网
使用中央仓库可以方便其他同事复用依赖
提高团队整体的依赖下载速度

3.中央仓库

官方维护的仓库

依赖查找循序: 本地仓库->远程仓库(私服)->中央仓库

下载

安装

单独安装Maven, Maven的安装包是一个绿色软件, 解压即可使用

说明:

测试: nvm -v

集成Maven

IEDA中集成Maven有两种方式, 可以配置当前项目, 比较繁琐, 也可以全局配置Maren, 比较推荐

1.当前项目

选择IDEA中的File -> Settings -> Build, Execution, Deployment -> Build Tools -> Mwven
设置IEAC使用本地安装的Maven, 并修改配置文件以及本地仓库路径

2.全局配置

使用

创建Maven项目

1.先创建空项目

2.创建模块,选择Maven,选择JDK,点击Next

3.填写模块名称,坐标信息,点击finish,创建完成

目录结构

1.基本信息

项目基本信息存放在pom.xml配置文件中

<!-- 项目坐标 -->
<groupId>itheima.com</groupId>
<artifactId>maven_helloworld</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>

2.Maven坐标

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

作用: 使用坐标来定义项目或引入项目的依赖

组成:

groupld: 定义当前项目隶属的组织名称, 一般为域名倒写

artifactId: 定义当前Maven项目名称, 一般是模块名称

version: 定义当前项目版本号

3.src根目录

main: 项目资源

java: 源代码
resources: 配置文件

test: 测试资源

java: 源代码
resources: 配置文件(使用较少,默认不创建)

target: 编译后的字节码文件

4.HelloWord

1.连包带类创键文件

2.helloworld代码

导入Maven项目

方式1

展开右侧Maven面板->选择+号 ->选择到pom.xml文件 ->导入

方式2

通过IDEA导入Maven项目, 注意要选到 pom.xml 文件

移除Maven项目

这里的移除只是在IDEA中移除maven模块, 资源还存在于文件夹中

依赖管理

依赖配置

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

编写<dependencies></dependencies>标签
嵌套<dependency></dependency>标签
定义依赖坐标
<dependencies> <dependency> //组织名 <groupId>junit</groupId> //模块名 <artifactId>junit</artifactId> //版本号 <version>4.12</version> </dependency> </dependencies>
坐标信息查询: https://mvnrepository.com/
添加坐标后,不会立即生效, 点击刷新的按钮即可 (如果没有刷新按钮可以手动刷新)

查看依赖以及依赖版本

如果引入的依赖, 本地仓库不存在, 将会连接远程仓库/中央仓库下载, 这个过程比较耗时

依赖传递

Maven项目中的依赖具有传递性, 项目中配置的依赖是直接依赖, 项目依赖的依赖就是间接依赖

查看依赖关系

方法1: 通过maven面板查看

方法2: 打开pom.xml文件, 右键选择Diagrams -> show Dependencies

排除依赖

A依赖B, B依赖C, 默认A就会依赖C, 不想让A依赖C, 就可以使用依赖排除, 主动断开依赖的资源, 被排除的资源无需指定版本

<dependency>
   <groupId>junit</groupId>
     <artifactId>junit</artifactId>
     <version>4.12</version>
     <!--依赖排除-->
     <exclusions>
       <exclusion>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
     </exclusion>
     <!--依赖排除-->
   </exclusions>
</dependency>

依赖范围

依赖的jar包, 默认情况下, 在任何地方都可以使用, 可以通过<scoped></scoped>标签设置其作用范围

  <dependency>
     <groupId>junit</groupId>
     <artifactId>junit</artifactId>
     <version>4.12</version>
     <scope>text</scope>
  </dependency>

可选参数

生命周期

Maven的生命周期就是为了对所有的maven项目构建过程进行抽象和统一

执行顺序

在同一套生命周期中, 当运行后面的阶段时, 前面的阶段都会运行

双击执行install周期, 但是test等周期默认也会执行
如果需要的话, 可以指定禁用周期

执行

执行maven指定的生命周期有两种方式

1.命令执行

在项目所在目录使用命令行工具, 执行指定命令, 执行maven的声明周期

mvn clean
mvn compile
mvn package
mvn test

2.双击执行

在idea中使用maven工具栏, 双击生命周期执行

3.执行原理

maven本身不执行任何操作, 所有的操作都是通过绑定的插件进行的, 所以maven的本质是一个插件集合

当我们双击生命周期阶段,运行程序时
实际上是与生命周期绑定的插件在工作

分模块设计

将项目按照功能拆分成若干个子模块, 方便项目的管理和维护, 也方便模块间的相互调用, 资源共享

需求: 完成tlias项目的模块拆分

拆分实体类Pojo

目标: 创建maven 模快 tlias-pojo, 存放实体类

1.新建模块: new Module -> Maven -> Next

2.转移实体类: 连包带类一起复制到新模块中

3.在新模块中引入实体类需要的依赖, 以解决报错

    <dependencies>
        <!-- lombok依赖  -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.24</version>
        </dependency>
    </dependencies>

4.引入模块: 在原始的项目中引入拆出去的模块

   <!--  拆分的tlias-pojo模块 -->
   <dependency>
        <groupId>com.itheima</groupId>
        <artifactId>tlias-pojo</artifactId>
        <version>1.0-SNAPSHOT</version>
    </dependency>

拆分工具类Utils

目标: 创建maven 模块 tlias-utils, 存放相关工具类

步骤: 与拆分实体类的步骤一致

注意: 引入web起步依赖时, 由于没有父工程限制, 需要指定版本, 版本与项目工程中的保持一致

继承

继承关系

继承描述的是两个工程间的关系, 子工程可以继承父工程中的配置信息, 常见于依赖关系的继承

1.作用: 简化依赖配置, 统一管理依赖

2.继承关系: 子工程继承父工程, 父工程继承spring-boot-stater-parent工程

3.目录结构: 两种工程结构都可以, 但是嵌套的父子结构看上去更清晰

需求: 改造tlias项目

1.创建父工程

创建maven模块tlias-parent, 该工程为父工程, 设置打包方式为pom(默认jar)

父工程不写具体逻辑代码,可以把src删掉

让父工程设置继承官方工程

<?xml version="1.0" encoding="UTF-8"?>

  //1.继承官方工程 
  <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      // 注意版本号
      <version>3.2.3</version>
      <relativePath/> <!-- lookup parent from repository -->
  </parent>

  <groupId>com.itheima</groupId>
  <artifactId>tlias-parent</artifactId>
  <version>1.0-SNAPSHOT</version>
  <!--   2.设置打包方式为pom -->
  <packaging>pom</packaging>

  <dependencies>
      <!-- lombok依赖  -->
      <dependency>
          <groupId>org.projectlombok</groupId>
          <artifactId>lombok</artifactId>
          <version>${lombok.version}</version>
      </dependency>
  </dependencies>

</project>

2.子工程继承父工程: pom.xml文件中

// 配置继承关系
<parent>
    <groupId>com.itheima</groupId>
    <artifactId>tlias-parent</artifactId>
    <version>1.0-SNAPSHOT</version>
    // 指定父工程相对位置
    <relativePath>../tlias-parent/pom.xml</relativePath>
</parent>

3.管理共有依赖

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

    <dependencies>
        <!-- lombok依赖  -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.24</version>
        </dependency>
    </dependencies>

</project>

在父工程中配置子工程共有的依赖, 子工程会自动继承父工程的依赖
若父子工程都配置了同一个依赖的不同版本, 最终以子工程为准

版本锁定

在Maven中, 可以在父工程的pom文件中, 通过 <dependencyManagement> 来统一管理依赖版本

<!--  版本锁定  -->
<dependencyManagement>
    <dependencies>
        <!--JWT令牌生成-->
        <dependency>
          <groupId>io.jsonwebtoken</groupId>
          <artifactId>jjwt</artifactId>
          <version>0.9.1</version>
        </dependency>       
   </dependencies>
</dependencyManagement>

<dependencies>
    <!-- JWT令牌依赖-->
    <dependency>
        <groupId>io.jsonwebtoken</groupId>
        <artifactId>jjwt</artifactId>
    </dependency>
</dependencies>

通过版本锁定, 分散在子工程的依赖版本由父工程统一管理
版本锁定只管理版本, 子程序还是需要引入依赖的, 只是不需要指定版本了

自定义属性: 父工程统一管理依赖版本后, 可以使用自定义属性, 集中定义依赖版本, 无需上下翻找

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

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

        <!--  自定义属性 -->
        <!--  格式: 自定义属性名.version -->
        <lombok.version>1.18.24</lombok.version>
        <mybatis.version>3.0.3</mybatis.version>
        <pagehelper.version>1.4.6</pagehelper.version>
        <fastjson.version>1.2.76</fastjson.version>
        <aliyunsdkoss.version>3.15.1</aliyunsdkoss.version>
        <jaxbapi.version>2.3.1</jaxbapi.version>
        <activation.version>1.1.1</activation.version>
        <jaxbruntime.version>2.3.3</jaxbruntime.version>
        <jjwt.version>0.9.1</jjwt.version>
    </properties>

    <dependencies>
        <!-- lombok依赖  -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            //  属性引用 
            <version>${lombok.version}</version>
        </dependency>
    </dependencies>

    <!--  版本锁定  -->
    <dependencyManagement>
        <dependencies>
            <!--  mybatis起步依赖  -->
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter</artifactId>
                <version>${mybatis.version}</version>
            </dependency>
            ... ...
        </dependencies>
    </dependencyManagement>
</project>

dependencies是直接依赖, 在父工程中配置了依赖, 子工程就会直接继承下来
dependencyManagement是版本管理, 只管理依赖的版本, 使用时子工程仍然需要引入依赖坐标

聚合

项目开发完成后需要打包, 分模块开发时, 打包前需要手动安装其他模块, 保证本地仓库中存在该模块, 才能打包成功, 否则可能会找不到相关模块, 造成打包失败

概念: 聚合就是把多个模块作为一个整体进行项目构建, 简化项目打包过程

聚合工程: 一个不具有业务功能的工程(有且只有一个pom文件),
最佳实践: 通常情况下, 聚合工程和继承中的父工程共用一个
实际作用: 构建项目直接在聚合工程上构建, 无需手动构建依赖关系

实现: maven中可以通过<modules>设置当前聚合工程所包含的子模块名称

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

    <!--聚合其他模块-->
    <modules>
        <module>../tlias-pojo</module>
        <module>../tlias-utils</module>
        <module>../tlias_web_management</module>
    </modules>

   ... ...
</project>

打包: 在聚合工程中聚合其他模块, 然后再聚合工程上构建项目
执行: 聚合工程中所包含的模块, 在构建时, 会自动根据模块间的依赖关系设置构建顺序, 与书写顺序无关