我对maven有话说系列（三）版本管理

在使用maven管理依赖时，如何优雅地管理版本，一个很容易被忽视的问题，接下来把常见的几种方式大致介绍一下。

（一）直接将版本显示的定义在依赖里

pom.xml文件中示例

<dependencies>
   <dependency>
  		 <groupId>io.springfox</groupId>
  		 <artifactId>springfox-swagger2</artifactId>
   	     <version>2.9.2</version>
   </dependency>
</dependencies>

以上方式就是我们使用maven管理依赖时最初级的方式。
【缺点】
1: 当需要进行依赖版本更新时，你需要从众多的依赖里定位到相应的依赖，查找不便。

2: 如果依赖了多个关联依赖（通常它们的groupId相同），当对这类依赖升级时，你需要更改多处。
pom.xml文件中示例

<dependencies>
     <dependency>
   		 <groupId>io.springfox</groupId>
   		 <artifactId>springfox-swagger2</artifactId>
    	 <version>2.9.2</version>
	</dependency>
	<dependency>
   		 <groupId>io.springfox</groupId>
   		 <artifactId>springfox-swagger-ui</artifactId>
    	 <version>2.9.2</version>
	</dependency>
<dependencies>

针对第二点有什么好的解决方案呢？当然有，接下来需要介绍的将解决这类问题。

（二）定义property，依赖里使用${artifactId.version}，在单项目里能优雅的管理依赖版本

<properties>
  <springfox-swagger.version>2.9.2</springfox-swagger.version>
</properties>
<dependencies>
     <dependency>
   		 <groupId>io.springfox</groupId>
   		 <artifactId>springfox-swagger2</artifactId>
    	 <version>${springfox-swagger.version}sion>
	</dependency>
	<dependency>
   		 <groupId>io.springfox</groupId>
   		 <artifactId>springfox-swagger-ui</artifactId>
    	 <version>${springfox-swagger.version}</version>
	</dependency>
<dependencies>

【优点】
1: 你可以将所有依赖的的版本集中一处统一管理，一目了然，修改操作方便。

【缺点】
1: 当你的多个项目的依赖都大同时，你肯定也希望这些依赖在不同的项目里也使用统一的版本号，避免因版本差异带来的问题，而目前你的解决方式就是不假思索的复制粘贴properties块的内容。

有什么好的解决方案呢？也就是说如何集中式地管理通用依赖，保证多个项目都可以轻松地依赖相同的版本。

（三）定义公共的父依赖

定义公共的父依赖，如何理解呢？其实，我们现在每天使用的SpringBoot、SpringCloud体系已经通过这种方式很好的管理了与之关联的依赖簇。

SpringBoot通过定义spring-boot-dependencies的pom，SpringCloud通过定义spring-cloud-dependencies的pom统一的管理相关依赖。

我们自己该如何实现呢？很简单，参考下它们你也可以快速的实现，主要通过在< properties>定义中property元素，在< dependencyManagement>定义依赖。

pom.xml示例

<?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>

    <!--  父项目信息  -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.5.RELEASE</version>
        <relativePath/>
    </parent>

    <!--  项目信息  -->
    <groupId>com.xyz</groupId>
    <artifactId>parent</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>
    <name>com-xyz-parent</name>
    <description>Custom Parent Dependency</description>

    <!--  定义依赖版本属性  -->
    <properties>
        <springfox-swagger2.version>2.9.2</springfox-swagger2.version>
        <springfox-swagger2-ui.version>2.9.2</springfox-swagger2-ui.version>
   </properties>

    <!--  定义依赖管理  -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger2</artifactId>
                <version>${springfox-swagger2.version}</version>
            </dependency>
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger-ui</artifactId>
                <version>${springfox-swagger2-ui.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <!--  自有依赖部署仓库地址  -->
    <distributionManagement>
        <snapshotRepository>
            <id>xyz-snapshots</id>
            <name>snapshots</name>
            <url>http://a.b.c.d:8081/repository/xyz-snapshots/</url>
        </snapshotRepository>
        <repository>
            <id>xyz-releases</id>
            <name>releases</name>
            <url>http://a.b.c.d:8081/repository/xyz-releases/</url>
            <uniqueVersion>true</uniqueVersion>
        </repository>
    </distributionManagement>

    <!-- 依赖仓库地址  -->
    <repositories>
        <repository>
            <id>xyz-public</id>
            <url>http://a.b.c.d:8081/repository/xyz-public/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>
    </repositories>

    <!--  插件仓库地址  -->
    <pluginRepositories>
        <pluginRepository>
            <id>xyz-public</id>
            <url>http://a.b.c.d:8081/repository/xyz-public/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </pluginRepository>
    </pluginRepositories>
</project>

针对以上示例pom.xml作几点解释。

1: < distributionManagement> 定义了自定义依赖的发布管理，通过子元素< snapshotRepository>指定SNAPSHOT版本（快照版本）的的发布位置信息，通过< repository>指定release版本（正是版本）的发布位置信息。

version定义中带有SNAPSHOT的就是快照版本，没有的就是正式版。

2: < repositories>元素定义了依赖的仓库信息，快照版与正式版是否可以下载。

3: < pluginRepositories>元素定义了插件依赖的仓库信息，快照版与正式版是否可以下载。

不管自定义依赖的上传，还是依赖的下载，因为依赖在自己的私服里，通常都有权限限制上传下载，所有还需与settings.xml文件结合，在其中定义相关配置。

  <servers>
    <server>    
      <id>xyz-snapshots</id>  
      <username>admin</username>  
      <password>admin123</password>  
    </server>
    <server>
        <id>stl-releases</id>  
        <username>admin</username>  
        <password>admin123</password>  
    </server>    
  </servers>
  <mirrors>
    <mirror>
     <id>xyz-public</id>
     <mirrorOf>*</mirrorOf>
     <url>http://a.b.c.d:8081/repository/xyz-public/</url>
    </mirror>
  </mirrors>

总结

关于版本管理的介绍就到这里了，如果你管理单项目，方式二是合适的；如果你管理了多个项目，显然方式三是合适的。选择合适自己的，才是最好的！