[Maven进阶]属性与版本管理

十八岁讨厌编程

已于 2023-03-10 19:17:59 修改

阅读量1k

点赞数 8

分类专栏： Maven 文章标签： maven java spring

于 2022-07-24 17:05:24 首次发布

本文链接：https://blog.csdn.net/zyb18507175502/article/details/125961253

版权

Maven 专栏收录该内容

8 篇文章 1 订阅

订阅专栏

本文介绍了如何使用Maven的属性管理来统一维护项目中jar包的版本，避免重复修改。通过在父工程定义属性，然后在依赖中引用这些属性，可以方便地更新所有相关版本。此外，还展示了如何配置Maven来处理资源文件，包括从特定目录加载资源、过滤和替换变量，以及解决在web项目中可能出现的问题。最后，讨论了Maven中的版本管理，解释了SNAPSHOT和RELEASE版本的区别以及不同版本的含义。

摘要由CSDN通过智能技术生成

属性

问题引入

前面我们已经在父工程中的dependencyManagement标签中对项目中所使用的jar包版本进行了统一的管理，但是如果在标签中有如下的内容:
在这里插入图片描述
你会发现，如果我们现在想更新Spring的版本，你会发现我们依然需要更新多个jar包的版本，这样的话还是有可能出现漏改导致程序出问题，而且改起来也是比较麻烦。

问题清楚后，我们需要解决的话，就可以参考咱们java基础所学习的变量，声明一个变量，在其他地方使用该变量，当变量的值发生变化后，所有使用变量的地方，就会跟着修改，即:
在这里插入图片描述

解决步骤

步骤1:父工程中定义属性

<properties>
    <spring.version>5.2.10.RELEASE</spring.version>
    <junit.version>4.12</junit.version>
    <mybatis-spring.version>1.3.0</mybatis-spring.version>
</properties>

步骤2:修改依赖的version

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>${spring.version}</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>${spring.version}</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>${spring.version}</version>
</dependency>

此时，我们只需要更新父工程中properties标签中所维护的jar包版本，所有子项目中的版本也就跟着更新。当然除了将spring相关版本进行维护，我们可以将其他的jar包版本也进行抽取，这样就可以对项目中所有jar包的版本进行统一维护，如:

<!--定义属性-->
<properties>
    <spring.version>5.2.10.RELEASE</spring.version>
    <junit.version>4.12</junit.version>
    <mybatis-spring.version>1.3.0</mybatis-spring.version>
</properties>

配置文件加载属性

Maven中的属性我们已经介绍过了，现在也已经能够通过Maven来集中管理Maven中依赖jar包的版本。但是又有新的需求，就是想让Maven对于属性的管理范围能更大些，比如我们之前项目中的jdbc.properties，这个配置文件中的属性，能不能也来让Maven进行管理呢?

答案是肯定的，具体的实现步骤为:

步骤1:父工程定义属性

<properties>
   <jdbc.url>jdbc:mysql://127.1.1.1:3306/ssm_db</jdbc.url>
</properties>

步骤2:jdbc.properties文件中引用属性

在jdbc.properties，将jdbc.url的值直接获取Maven配置的属性

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

步骤3:设置maven过滤文件范围

Maven在默认情况下是从当前项目的src\main\resources下读取文件进行打包。现在我们需要打包的资源文件是在maven_02_ssm下,需要我们通过配置来指定下具体的资源目录。

<build>
    <resources>
        <!--设置资源目录-->
        <resource>
            <directory>../maven_02_ssm/src/main/resources</directory>
            <!--设置能够解析${}，默认是false -->
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

说明：directory路径前要添加../的原因是maven_02_ssm相对于父工程的pom.xml路径是在其上一层的目录中，所以需要添加。

修改完后，注意maven_02_ssm项目的resources目录就多了些东西，如下:

在这里插入图片描述

步骤4:测试是否生效

测试的时候，只需要将maven_02_ssm项目进行打包，然后观察打包结果中最终生成的内容是否为Maven中配置的内容。

在这里插入图片描述

注意：
如果父模块和子模块没有指定打包方式会报错Invalid packaging for parent POM，must be pom but is_jar。
一般MAVEN的工程的父模块的POM.XML的打包方式为pom方式，子模块工程的POM.XML的打包方式为jar包方式，所以应加入如下代码分别到父子POM.XML文件里：
<packaging>pom</packaging>
<packaging>jar</packaging>

上面的属性管理就已经完成，但是有一个问题没有解决，因为不只是maven_02_ssm项目需要有属性被父工程管理，如果有多个项目需要配置，该如何实现呢?

方式一:

<build>
    <resources>
        <!--设置资源目录，并设置能够解析${}-->
        <resource>
            <directory>../maven_02_ssm/src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
        <resource>
            <directory>../maven_03_pojo/src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
        ...
    </resources>
</build>

可以配，但是如果项目够多的话，这个配置也是比较繁琐

方式二:

<build>
    <resources>
        <!--
			${project.basedir}: 当前项目所在目录,子项目继承了父项目，
			相当于所有的子项目都添加了资源目录的过滤
		-->
        <resource>
            <directory>${project.basedir}/src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

说明：打包的过程中如果报如下错误:

在这里插入图片描述

原因就是Maven发现你的项目为web项目，就会去找web项目的入口web.xml[配置文件配置的方式]，发现没有找到，就会报错。

解决方案1：在maven_02_ssm项目的src\main\webapp\WEB-INF\添加一个web.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
</web-app>

解决方案2: 配置maven打包war时，忽略web.xml检查

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.2.3</version>
            <configuration>
                <failOnMissingWebXml>false</failOnMissingWebXml>
            </configuration>
        </plugin>
    </plugins>
</build>

上面我们所使用的都是Maven的自定义属性，除了${project.basedir},它属于Maven的内置系统属性。

在Maven中的属性分为:

自定义属性（常用）
内置属性
Setting属性
Java系统属性
环境变量属性

在这里插入图片描述

具体如何查看这些属性:

在cmd命令行中输入mvn help:system

在这里插入图片描述

具体使用，就是使用 ${key}来获取，key为等号左边的，值为等号右边的，比如获取红线的值，对应的写法为 ${java.runtime.name}。

maven-resource-plugin插件

这个插件专门用来处理资源文件。我们这里举例说明使用场景。

指定编码

可以选择诸如ASCII，UTF-8或UTF-16之类的字符编码方案来读取和写入文件。

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-resources-plugin</artifactId>
        <version>3.2.0</version>
        <configuration>
          ...
          <encoding>UTF-8</encoding>
          ...
        </configuration>
      </plugin>
    </plugins>
    ...
  </build>

指定resources目录

默认情况下，Maven会从项目的src/main/resources目录下查找资源。很多⽤⼾会需要添加额外的资源⽂件⽬录，这个时候就可以通过配置maven-resources-plugin来实现

<build>
    <resources>
         <resource>
             <directory>[your folder here]</directory>
         </resource>
        <resource>
            <directory>src/main/user_resource_1</directory>
        </resource>
        <resource>
            <directory>src/main/user_resource_2</directory>
        </resource>
    </resources>
</build>

注意maven中的相对路径都是通过项目目录来说的。

过滤/替换

在你的resources中包含变量，这些变量以$ {…}分隔符表示。可以来自系统属性，项目属性，过滤器资源和命令行。

例如：src/main/resources/hello.txt 包含以下内容

Hello ${name}

<!-- POM -->
<project>
  <name>My Resources Plugin Practice Project</name>
  <build>
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
      </resource>
    </resources>
  </build>
</project>

包含/排除

指定资源目录包含的文件/排除的文件

<build>
    <resources>
        <resource>
              <directory>src/my-resources</directory>
              <includes>
                    <include>**/*.txt</include>
                    <include>**/*.rtf</include>
                    <include>[resource file #1]</include>
                    <include>[resource file #2]</include>
              </includes>
              <excludes>
                    <exclude>**/*test*.*</exclude>
                    <exclude>**/*.pdf</exclude>
                    <exclude>[non-resource file #n]</exclude>
              </excludes>
        </resource>
    </resources>
  </build>

版本管理

关于这个版本管理解决的问题是，在Maven创建项目和引用别人项目的时候，我们都看到过如下内容:

在这里插入图片描述

这里面有两个单词，SNAPSHOT和RELEASE，它们所代表的含义是什么呢?

我们打开Maven仓库地址https://mvnrepository.com/

在这里插入图片描述

在我们jar包的版本定义中，有两个工程版本用的比较多:

SNAPSHOT（快照版本）
- 项目开发过程中临时输出的版本，称为快照版本
- 快照版本会随着开发的进展不断更新
RELEASE（发布版本）
- 项目开发到一定阶段里程碑后，向团队外部发布较为稳定的版本，这种版本所对应的构件文件是稳定的
- 即便进行功能的后续开发，也不会改变当前发布版本内容，这种版本称为发布版本

除了上面的工程版本，我们还经常能看到一些发布版本: