Maven 作为当下流行的构建工具,在开发中得到了广泛的使用,开发人员可以方便的通过Maven将依赖的jar包从私服上拉取到本地。但日常开发中,经常会遇到需要使用本地jar包的情况:
jar包提供方开发还在进行中,版本还没稳定,还不具备上传至私服的条件,因此系统间的开发合作可能是通过本地打个jar包,然后将jar文件发送给依赖方,依赖方使用这个本地jar包进行开发。
下面分几种常见情景,分别介绍怎么通过maven使用本地jar包:
- 服务提供方P(provider)和依赖方C(consumer)两个系统都是同一个开发人员开发
这种情况是最简单的,只要在系统A上,通过maven 的 install命名,将jar包构建至本地仓库,系统B就能正常使用这个新构建的jar包了。
- P和C在不同开发人员中,但是jar包是非快照版本(非SNAPSHOT)
这种情况也较简单,根据pom文件的groupId,artifactId和version在本地仓库中找到相应的目录(没有的话,就新建),将P提供的jar包放置于此,并将jar包内的pom.xml文件拿出,重命名为何jar包一样的名字,后缀用 .pom结尾,就好了。
- P和C在不同开发人员中,jar包是快照版本
对于快照版本的jar包,如果jar包的版本号,私服没有,这比较简单,和情况2一样处理就行。但是如果私服有这个版本号,情况就有点特殊了,原理分析如下:
maven对于快照版本,P每次上传jar包,maven都会为它打上一个时间戳,同时将最新的版本信息记录在 maven-metadata.xml文件中。文件内容一般如下:
当C重新获取依赖时,maven会首先去私服将maven-metadata.xml下载到本地,和本地的maven-metadata-local.xml文件进行比较,主要是对比更新时间(lastUpdated)的先后:(1) 如果远端下载配置文件的时间新,则去远端下载最新的jar包和pom文件至本地仓库,然后复制一份重命名为 SNAPSHOT结尾的jar包和pom文件。(2) 如果本地文件的时间新,则停止jar包的下载,以本地文件内记录的jar包信息为准,在本地仓库中进行查找。<?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>
- 在本地仓库响应的目录中(根据groupId等信息,前文有说明),将maven-metadata.xml文件重命名为maven-metadata-local.xml,对文件进行修改,将lastUpdated时间后延,将jar和pom的<value>值参考本地jar包进行更改,本例中改为 1.1.3-SNAPSHOT;
- 清空其他所有文件,放入jar包,名字记得以SNAPSHOT结尾,不带时间戳的。
- 将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>
本地仓库目录结构如下: