Maven项目属性与版本管理

朴灿烈づ我的快乐病毒、 2024-04-01 19:02 81阅读 0赞

本次将介绍两个内容，分别是：

*  属性
 *  版本管理

## 1. 属性 ##

### 1.1 问题分析 ###

我们先来分析一下问题：

前面在父工程中的`dependencyManagement`标签中对项目中所使用的`jar`包版本进行了统一的管理，但是如果在标签中有如下的内容：

![在这里插入图片描述][0b4c99a922f04e7c90360fbd1d12d262.png_pic_center]

你会发现，如果我们现在想更新`Spring`的版本，你会发现我们依然需要更新多个`jar`包的版本，这样的话还是有可能出现漏改导致程序出问题，而且改起来也是比较麻烦。

问题清楚后，我们需要解决的话，就可以参考变量，声明一个变量，在其他地方使用该变量，当变量的值发生变化后，所有使用变量的地方，就会跟着修改，即：

![在这里插入图片描述][43782164a36140e9acd395dbaf94f499.png_pic_center]

### 1.2 解决步骤 ###

#### 步骤1：父工程中定义属性 ####

<properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
            <spring.version>5.2.12.RELEASE</spring.version>
            <javax.servlet.api>3.1.0</javax.servlet.api>
            <mybatis>3.5.10</mybatis>
            <mysql.connector.java>8.0.30</mysql.connector.java>
            <jackson.databind>2.9.8</jackson.databind>
            <mybatis.spring>2.0.7</mybatis.spring>
            <druid>1.2.11</druid>
            <lombok>1.18.24</lombok>
            <junit>4.13.2</junit>
        </properties>

#### 步骤2：修改依赖的`version` ####

<dependencies>
            <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>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-test</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <dependency>
                <groupId>javax.servlet</groupId>
                <artifactId>javax.servlet-api</artifactId>
                <version>${javax.servlet-api.version}</version>
                <scope>provided</scope>
            </dependency>
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>${mybatis.version}</version>
            </dependency>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>${mysql-connector-java.version}</version>
            </dependency>
            <dependency>
                <groupId>com.fasterxml.jackson.core</groupId>
                <artifactId>jackson-databind</artifactId>
                <version>${jackson-databind.version}</version>
            </dependency>
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis-spring</artifactId>
                <version>${mybatis-spring.version}</version>
            </dependency>
    
            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>druid</artifactId>
                <version>${druid.version}</version>
            </dependency>
            <dependency>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>${lombok.version}</version>
                <scope>provided</scope>
            </dependency>
        </dependencies>
    
        
        <dependencyManagement>
            <dependencies>
                <dependency>
                    <groupId>junit</groupId>
                    <artifactId>junit</artifactId>
                    <version>${junit.version}</version>
                    <scope>test</scope>
                </dependency>
            </dependencies>
        </dependencyManagement>

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

<properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
            <spring.version>5.2.12.RELEASE</spring.version>
            <javax.servlet-api.version>3.1.0</javax.servlet-api.version>
            <mybatis.version>3.5.10</mybatis.version>
            <mysql-connector-java.version>8.0.30</mysql-connector-java.version>
            <jackson-databind.version>2.9.8</jackson-databind.version>
            <mybatis-spring.version>2.0.7</mybatis-spring.version>
            <druid.version>1.2.11</druid.version>
            <lombok.version>1.18.24</lombok.version>
            <junit.version>4.13.2</junit.version>
        </properties>

## 2. 配置文件加载属性 ##

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

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

#### 步骤1：父工程定义属性 ####

<properties>
       <jdbc.url>jdbc:mysql://localhost:3306/mybatis</jdbc.url>
        <jdbc.driver>com.mysql.cj.jdbc.Driver</jdbc.driver>
        <jdbc.username>root</jdbc.username>
        <jdbc.password>root</jdbc.password>
    </properties>

#### 步骤2：`jdbc.properties`文件中引用属性 ####

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

jdbc.driver=${jdbc.driver}
    jdbc.url=${jdbc.url}
    jdbc.username=${jdbc.username}
    jdbc.password=${jdbc.password}

#### 步骤3：设置`maven`过滤文件范围 ####

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

<build>
            <resources>
                
                <resource>
                    <directory>../maven_02_ssm/src/main/resources</directory>
                    
                    <filtering>true</filtering>
                </resource>
            </resources>
        </build>

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

修改完后，注意maven\_02\_ssm项目的`resources`目录就多了些东西，如下：

![在这里插入图片描述][78a35eea72974dd39453db4611d30f48.png_pic_center]

#### 步骤4：测试是否生效 ####

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

![在这里插入图片描述][4fa366d64cb7486c94655cc37082ea12.png_pic_center]

![在这里插入图片描述][1340b823d47042a9bb2a674c1a0c9978.png_pic_center]

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

方式一:

<build>
        <resources>
            
            <resource>
                <directory>../maven_02_ssm/src/main/resources</directory>
                <filtering>true</filtering>
            </resource>
            <resource>
                <directory>../maven_03_ssm_pojo/src/main/resources</directory>
                <filtering>true</filtering>
            </resource>
            ...
        </resources>
    </build>

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

方式二：

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

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

![在这里插入图片描述][03e75042a8c24f5e8c6698f4bcb5d5ae.png_pic_center]

原因就是`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系统属性
 *  环境变量属性

<table> 
 <thead> 
  <tr> 
   <th align="center">属性分类</th> 
   <th align="center">引用格式</th> 
   <th align="center">示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="center">自定义属性</td> 
   <td align="center">${自定义属性名}</td> 
   <td align="center">${spring.version}</td> 
  </tr> 
  <tr> 
   <td align="center">内置属性</td> 
   <td align="center">${内置属性名}</td> 
   <td align="center">${basedir}、${version}</td> 
  </tr> 
  <tr> 
   <td align="center">Setting属性</td> 
   <td align="center">${Setting.属性名}</td> 
   <td align="center">${settings.localRepository}</td> 
  </tr> 
  <tr> 
   <td align="center">Java系统属性</td> 
   <td align="center">${系统属性分类.系统属性名}</td> 
   <td align="center">${user.home}</td> 
  </tr> 
  <tr> 
   <td align="center">环境变量属性</td> 
   <td align="center">${env.环境变量属性}</td> 
   <td align="center">${env.JAVE_HOME}</td> 
  </tr> 
 </tbody> 
</table>

具体如何查看这些属性：

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

![在这里插入图片描述][448c41f548e9458c8a5c526c61da1126.png_pic_center]

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

## 3. 版本管理 ##

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

![在这里插入图片描述][ff9faf0674954d4097d041b338d04042.png_pic_center]

![在这里插入图片描述][f3211df3e9af495488c66d72e529e85f.png_pic_center]

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

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

![在这里插入图片描述][f1db8595794e4d299b14d810d9721242.png_pic_center]

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

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

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

*  `alpha版`：内测版，bug多不稳定内部版本不断添加新功能
 *  `beta版`：公测版，不稳定（比`alpha`稳定些），bug相对较多不断添加新功能
 *  纯数字版

## 项目代码 ##

*  [gitee 代码下载][gitee]
 *  [github 代码下载][github]

[0b4c99a922f04e7c90360fbd1d12d262.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/186fdbc185bb4c07b68ae8a4ad75accb.png
[43782164a36140e9acd395dbaf94f499.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/c489d36b22a0483d99f54ba48f8bfa7d.png
[78a35eea72974dd39453db4611d30f48.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/183028af6f2349e79583c74a7911a78a.png
[4fa366d64cb7486c94655cc37082ea12.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/e123e77745694a7f97a1c07d0590d930.png
[1340b823d47042a9bb2a674c1a0c9978.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/c06b9ccbc8954728a91eee73e27e09af.png
[03e75042a8c24f5e8c6698f4bcb5d5ae.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/5c22454230894fdfa5daf4d43c22177f.png
[448c41f548e9458c8a5c526c61da1126.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/96083685e2bb4d17a57c40aeda4988d1.png
[ff9faf0674954d4097d041b338d04042.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/1a8db9d85110484c99abe1f0be09fab6.png
[f3211df3e9af495488c66d72e529e85f.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/5c447a02a9b34d738af471f130f697bd.png
[f1db8595794e4d299b14d810d9721242.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/297db5adeb024d2ab6a87640badc6f13.png
[gitee]: https://gitee.com/DchuangDB/Maven
[github]: https://github.com/dcbut/Maven