[英]Best practices for installing 3rd party libraries into your hosted Maven repository?
假设您有一个使用第三方库的项目,例如Google的Analytics Data API(gdata) ,它似乎当前没有部署到任何知名或流行的Maven公共存储库/索引中。 这不是什么大问题,因为我可以将工件部署到我的本地托管的Nexus存储库中。
但是,Maven社区中是否有任何最佳实践,我应该如何命名这个库在我的POM中的“坐标”,因为标准尚未在公共存储库中设置呢?
例如,我应该在我的POM中引用它
<dependency>
<groupId>com.google</groupId>
<artifactId>gdata-analytics</artifactId>
<version>1.0</version>
</dependency>
还是有一些更好/更标准的方式让我想出artifactId
?
(而且,为什么像谷歌这样的几十家图书馆的提供商不会花费一些精力将它们托管到主流的公共Maven存储库/索引中呢?这不会让人们更容易使用它们从而驱动它们采用?)
我已经使用Maven大约一年了,并且从未遇到过“标准”命名约定。 我通常会做你正在做的事情,虽然我尽量使版本号尽可能接近“真实”版本号,以避免在部署多个版本时出现混淆。
你做的很合理。 一些额外的要点:
当Maven从Nexus获取工件时,该工件被命名为artifactId-version。 GroupId被省略了。 因此,当工件移动(例如,复制到Web应用程序中的WEB-INF / lib)时,您的jar文件将显示为“ gdata-analytics-1.0 ”。 这通常不是问题。 但是,如果工件名称非常常见,例如“util”,您可能希望在artifactId中包含组信息,例如使用“ com.google ”的groupId和“ com.google.gdata-analytics ”的artifactId。 是的,重复是令人讨厌的,但它会在文件系统和搜索中产生最大的清晰度。 我实际上有一个问题,其中两个不同的groupId都有一个“ core-1.0 ”jar,一个在构建时被复制到lib目录时覆盖了另一个。
我的第二个MattK建议将你的Maven versionId与通常所知的工件版本对齐。
如果您遵循Dominic的建议,将groupId添加为您自己的公司名称(例如acme),则可以更轻松地利用Nexus的路由功能。 它将确保内部工件的请求不会传播到Maven Central并最终存储在他们的日志中(如果您的groupId是“ acme.secret.project ”,这可能很重要!
我倾向于使用我自己常用的groupId为groupId添加前缀。 这清楚地表明它是我上传的内容,以防万一它泄露给全世界。
你可能很幸运:Google为自己的项目拥有自己的Maven回购。 见本页: 说明
我有一些专属的Jar文件,所以我不得不在每个工作站加载它们(我们还没有公司共享的回购)。 我将它们放在/ lib目录中的源代码树中(并不总是一个好主意),并添加了一个包含mvn install-file命令的小.BAT文件(或.sh脚本)来加载我的本地机器的repo我建立的时间。 如果我必须更新这些jar,我也会更新“load.bat”文件,然后重新运行它。 在我的情况下,我不希望每年发生一次以上,也许更少。
许多sourceforge项目在groupid中使用项目的名称,例如:
GroupId net.sf.json-lib ArtifactId json-lib
这可能适用于谷歌示例,因为有很多谷歌文物。
请记住,您可以使用classifer标记来区分同一版本的两个jar,但是为不同的目的而构建,例如不同的JVM。
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.