通过maven使用本地jar包

Posted 2021-04-30 海涛技术漫谈

个人博客：http://blog.csdn.net/zhanht

Maven 作为当下流行的构建工具，在开发中得到了广泛的使用，开发人员可以方便的通过Maven将依赖的jar包从私服上拉取到本地。但日常开发中，经常会遇到需要使用本地jar包的情况：

jar包提供方开发还在进行中，版本还没稳定，还不具备上传至私服的条件，因此系统间的开发合作可能是通过本地打个jar包，然后将jar文件发送给依赖方，依赖方使用这个本地jar包进行开发。

下面分几种常见情景，分别介绍怎么通过maven使用本地jar包：

1.  服务提供方P(provider)和依赖方C(consumer)两个系统同一开发人员

这种情况是最简单的，只要在系统A上，通过maven 的 install命令，将jar包构建至本地仓库，系统B就能正常使用这个新构建的jar包了。

2.  P和C在不同开发人员中，但是jar包是非快照版本(非SNAPSHOT)

这种情况也较简单，根据pom文件的groupId,artifactId和version在本地仓库中找到相应的目录(没有的话，就新建)，将P提供的jar包放置于此，并将jar包内的pom.xml文件拿出，重命名为何jar包一样的名字，后缀一 .pom结尾，就好了。

3.  P和C在不同开发人员中，jar包是快照版本

3.1  对于快照版本的jar包，如果jar包的版本号，私服没有，这比较简单，和情况2一样处理就行。

3.2  但是如果私服有这个版本号，情况就有点特殊了，原理分析下：

maven对于快照版本，P每次上传jar包，maven都会为它打上一个时间戳，同时将最新的版本信息记录在 maven-metadata.xml文件中。

文件内容一般如下：

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

<metadata modelVersion="1.1.0">

  <groupId>com.jd.stock.engine2</groupId>

  <artifactId>stock-engine2-test-export</artifactId>

  <version>1.1.3-SNAPSHOT</version>

  <versioning>

    <snapshot>

      <timestamp>20171228.022230</timestamp>

      <buildNumber>1</buildNumber>

    </snapshot>

    <lastUpdated>20180129020057</lastUpdated>

    <snapshotVersions>

      <snapshotVersion>

        <extension>jar</extension>

        <value>1.1.3-20171228.022230-1</value>

        <updated>20171228022230</updated>

      </snapshotVersion>

      <snapshotVersion>

        <extension>pom</extension>

        <value>1.1.3-20171228.022230-1</value>

        <updated>20171228022230</updated>

      </snapshotVersion>

    </snapshotVersions>

  </versioning>

</metadata>

当C重新获取依赖时，maven会首先去私服将maven-metadata.xml下载到本地，和本地的maven-metadata-local.xml文件进行比较，主要是对比更新时间(lastUpdated)的先后：(1) 如果远端下载配置文件的时间新，则去远端下载最新的jar包和pom文件至本地仓库，然后复制一份重命名为 SNAPSHOT结尾的jar包和pom文件。(2) 如果本地文件的时间新，则停止jar包的下载，以本地文件内记录的jar包信息为准，在本地仓库中进行查找。

因此这类情况，使用本地jar包方式如下：

1. 在本地仓库响应的目录中(根据groupId等信息，前文有说明)，将maven-metadata.xml文件重命名为maven-metadata-local.xml，对文件进行修改，将lastUpdated时间后延，将jar和pom的<value>值参考本地jar包进行更改，本例中改为 1.1.3-SNAPSHOT；

2. 清空其他所有文件，放入jar包，名字记得以SNAPSHOT结尾，不带时间戳的。

3. 将jar包内的配置文件拿出，和jar包放在同一目录中，和jar包一样的名字， .pom结尾。

远端下下来的配置如上图，修改后的配置文件如下：

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

<metadata modelVersion="1.1.0">

  <groupId>com.jd.stock.engine2</groupId>

  <artifactId>stock-engine2-test-export</artifactId>

  <version>1.1.3-SNAPSHOT</version>

  <versioning>

    <snapshot>

      <timestamp>20171228.022230</timestamp>

      <buildNumber>1</buildNumber>

    </snapshot>

    <lastUpdated>20180308020057</lastUpdated>

    <snapshotVersions>

      <snapshotVersion>

        <extension>jar</extension>

        <value>1.1.3-SNAPSHOT</value>

        <updated>20171228022230</updated>

      </snapshotVersion>

      <snapshotVersion>

        <extension>pom</extension>

        <value>1.1.3-SNAPSHOT</value>

        <updated>20171228022230</updated>

      </snapshotVersion>

    </snapshotVersions>

  </versioning>

</metadata>

本地仓库目录结构如下：