JERRYSBLOG
Home Technology Life Tags About
JERRYSBLOG

Contents

Contents

Mastering Maven: Advanced Techniques and Best Practices

Jerry avatar  included in  category Technology
   1858 words   9 minutes    views  

This article delves into advanced techniques and best practices for using Maven, a popular build automation tool for Java projects. Topics covered include module development and design, dependency management, aggregation and inheritance, property management, and multi-environment configuration and deployment. Whether you’re a seasoned Maven user or just getting started, this article will provide valuable insights to streamline your development process and improve your project’s overall quality.

image-20230612175146310

image-20230612175345645

image-20230612175744597

  • 📂src.main.java.com.jerry
    • 📂config
      • ☕JdbcConfig
      • ☕MyBatisConfig
      • ☕ServletConfig
      • ☕SpringConfig
      • ☕SpringMvcConfig
      • ☕SpringMvcSupport
    • 📂controller
      • ☕BookController
      • ☕Code
      • ☕ProjectExceptionAdvice
      • ☕Result
    • 📂dao
      • 📂impl
      • ☕BookDao
    • 📂domain
      • ☕Book
    • 📂exception
    • 📂service
      • 📂impl
      • ☕BookService

业务扩张，domain 需要拆分成新的 Module

(所有的功能都可以拆分成新 Module，这里以 domain 为例)

  1. 创建新的 Pojo Module, 并将 SSM Module 的 domain 文件迁移到新 Pojo Module

    • Pojo(Plain Old Java Object): 轻量级的 Java Bean，通常只包含私有属性、getter 和 setter 方法以及无参构造函数
    • 在 SSM 架构中，通常将 POJO 用作数据传输对象（DTO）或持久化对象（PO）
    • 与 POJO 相对应的是领域对象（domain object），也称为实体对象（entity），它代表应用程序的业务实体，通常包含业务逻辑和状态信息

  2. 此时 SSM 项目在所有用到 domain 对象的地方都报错，如：public boolean save(Book book), 需要在 SSM Module 的 pom 文件中引入 Pojo Module

    • 在 SSM pom 文件中引入 Pojo 作为依赖

      <!--SSM pom 依赖-->
<dependency>
    <groupId>com.jerry</groupId>
    <artifactId>pojo_module</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

image-20230613164639347

image-20230613163454510

  • 目前项目中，在 SSM，Pojo 和 Dao 三个Module POM 文件中，SSM 依赖了 Pojo 和 Dao
  • 而 Dao 本身也依赖了 Pojo
  • 根据依赖传递，SSM POM 文件中可以不写 Pojo 依赖

image-20230613170907554

  • 可选依赖指对外隐藏当前所依赖的资源 - 不透明
<dependency>
    <groupId>com.jerry</groupId>
    <artifactId>pojo_module</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!--可选依赖是隐藏当前工程所依赖的资源，隐藏后对应资源将不具有依赖传递-->
    <optional>true</optional>
</dependency>
  • 排除依赖指主动断开依赖的资源，被排除的资源无需指定版本 - 不需要
<dependency>
    <groupId>com.jerry</groupId>
    <artifactId>dao_module</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!--排除依赖是隐藏当前资源对应的依赖关系-->
    <exclusions>
        <exclusion>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
        </exclusion>
    </exclusions>
</dependency>

原始 Module 之间关系，各维护各的，当 Pojo Module 更新时，其他 Module 并没有感知

image-20230615142247181

image-20230615142547871

聚合后的 Module 结构:

  • maven_01_parent(root)
  • maven_02_ssm
  • maven_03_pojo
  • maven_04_dao

聚合工程的开发步骤

  • 步骤1 创建 Maven 模块，设置打包类型为 pom，(maven 工程打包方式默认为 jar, web 工程打包方式为 war)
  • 步骤2 设置当前聚合工程所包含的子模块名称
<groupId>com.jerry</groupId>
<artifactId>maven_01_parent</artifactId>
<version>1.0-SNAPSHOT</version>
<!--最大的区别的是打包方式，pom 表示这是一个聚合工程-->
<packaging>pom</packaging>

<!--设置管理的模块名称-->
<modules>
    <!--不管写什么顺序，complie 时会按照依赖顺序的 complie-->
    <module>../maven_02_ssm</module>
    <module>../maven_03_pojo</module>
    <module>../maven_04_dao</module>
</modules>
  • 问题1 模块依赖重复能不能简化
  • 问题2 如何快速升级所有模块依赖版本

image-20230615173540813

image-20230615173847561

继承工程的开发步骤

  • 步骤1 创建 Maven 模块，设置打包类型为 pom，(maven 工程打包方式默认为 jar, web 工程打包方式为 war)

    <packaging>pom</packaging>

  • 步骤2 在父工程的 pom 文件中配置依赖关系（子工程将沿用父工程中的依赖关系）

    <dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.2.10.RELEASE</version>
    </dependency>
    ...
</dependencies>

  • 步骤3 在父工程的 pom 文件中配置子工程中可选的依赖

    <dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba</groupId>
            <arrifactId>druid</arrifactId>
            <version>1.1.16</version>
        </dependency>
        ...
    </dependencies>
</dependencyManagement>

  • 步骤4 在子工程中配置当前工程所继承的父工程

    <parent>
    <groupId>com.jerry</groupId>
	<artifactId>maven_01_parent</artifactId>
	<version>1.0-SNAPSHOT</version>
    <relativePath>../maven_parent/pom.xml</relativePath>
</parent>

  • 步骤5 在子工程中配置使用父工程中的可选依赖的坐标，（只配群组 id 和项目 id，无需提供版本，版本由父工程统一提供）

    <dependencies>
    <dependency>
        <groupId>com.alibaba</groupId>
        <arrifactId>druid</arrifactId>
    </dependency>
</dependencies>

image-20230615175920629

image-20230616104217837

  • 步骤一：定义属性

    <properties>
    <spring.version>5.2.10.RELEASE</spring.version>
    <junit.version>4.12</junit.version>
    <jdbc.url>jdbc:mysql://127.0.0.1:3306/ssm_db</jdbc.url>
</properties>

  • 步骤二：配置文件中引用属性

    jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=${jdbc.url}
jdbc.username=root
jdbc.password=root

  • 步骤三：(最重要) 开启资源文件目录加载属性的过滤器

    <build>
    <resources>
        <resource>
            <directory>${project.basedir}/src/main/resources</directory>
        	<filtering>true</filtering>
        </resource>
    </resources>
</build>

  • 步骤四：(了解) 配置 maven 打 war 包时，忽略 web.xml 检查

    <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <version>3.2.3</version>
    <configration>
        <failOnMissingWebXml>false</failOnMissingWebXml>
    </configration>
</plugin>
属性分类引用格式示例
自定义属性${自定义属性名}${spring.version}
内置属性${内置属性名}${basedir} ${version}
Setting 属性${setting.属性名}${settings.localRepository}
Java 系统属性${系统属性分类.系统属性名}${user.home}
环境变量属性${evn.环境变量属性名}${env.JAVA_HOME}

image-20230616111425539

image-20230616111547100

image-20230616111756641

  • 步骤一：定义多环境

    <!--配置多环境-->
<profiles>
    <profile>
        <id>env_dep</id>
        <properties>
            <jdbc.url>jdbc:mysql://127.1.1.1:3306/ssm_db</jdbc.url>
        </properties>
        <!--设定默认启动环境-->
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
    </profile>

    <profile>
        <id>env_pro</id>
        <properties>
            <jdbc.url>jdbc:mysql://127.2.2.2:3306/ssm_db</jdbc.url>
        </properties>
    </profile>

    <profile>
        <id>env_test</id>
        <properties>
            <jdbc.url>jdbc:mysql://127.3.3.3:3306/ssm_db</jdbc.url>
        </properties>
    </profile>
</profiles>

  • 步骤二：构建过程

    mvn 指令 -P 定义环境id

    范例：

    mvn install -P pro_env

image-20230616113112811

image-20230616113357140

image-20230616113511499

image-20230616114314058

image-20230616114800517

仓库类别Name功能关联操作
宿主仓库hosted保存自主研发 + 第三方资源上传
代理仓库proxy代理连接中央仓库下载
仓库组group为仓库编组简化下载操作下载

image-20230616134600068

  • 步骤一：配置位置（Maven setting.xml 文件中）

    <servers>
    <server>
        <id>jerry-release</id>
        <username>admin</username>
        <password>admin</password>
    </server>
    <server>
        <id>jerry-snapshots</id>
        <username>admin</username>
        <password>admin</password>
    </server>
</servers>

  • 步骤二：配置私服地址（Maven setting.xml 文件中）

    <mirrors>
    <mirror>
        <id>nexus-jerry</id>
        <mirrorOf>*</mirrorOf>
        <url>http://localhost:8081/repository/maven-public</url>
    </mirror>
</mirrors>

  • 步骤三：配置发布管理（工程 pom 文件中）

    <distributionManagement>
    <repository>
        <id>jerry-release</id>
        <url>http://localhost:8081/repository/maven-release</url>
    </repository>
    <snapshotRepository>
        <id>jerry-snapshots</id>
        <url>http://localhost:8081/repository/maven-snapshots</url>
    </snapshotRepository>
</distributionManagement>

    发布命令

    mvn deploy

Related Content

Automated Deployment with Jenkins and Docker

Exploring JDK 21 New Feature: Virtual Threads

Comprehensive Guide to Integrating Swagger with Spring

Spring Boot Introduction

Spring Java Basic Conception Sharing

Updated on 2023-02-12
 Java, Spring, Maven
 | Home