maven 仓库配置 pom中repositories属性

太过爱你忘了你带给我的痛 2024-02-17 21:54 10阅读 0赞

什么是Maven仓库  
在不用Maven的时候，比如说以前我们用Ant构建项目，在项目目录下，往往会看到一个名为/lib的子目录，那里存放着各类第三方依赖jar文件，如log4j.jar，junit.jar等等。每建立一个项目，你都需要建立这样的一个/lib目录，然后复制一对jar文件，这是很明显的重复。重复永远是噩梦的起点，多个项目不共用相同的jar文件，不仅会造成磁盘资源的浪费，也使得版本的一致性管理变得困难。此外，如果你使用版本管理工具，如SVN（你没有使用版本管理工具？马上试试SVN吧，它能帮你解决很多头疼的问题），你需要将大量的jar文件提交到代码库里，可是版本管理工具在处理二进制文件方面并不出色。  
Maven仓库就是放置所有JAR文件（WAR，ZIP，POM等等）的地方，所有Maven项目可以从同一个Maven仓库中获取自己所需要的依赖JAR，这节省了磁盘资源。此外，由于Maven仓库中所有的JAR都有其自己的坐标，该坐标告诉Maven它的组ID，构件ID，版本，打包方式等等，因此Maven项目可以方便的进行依赖版本管理。你也不在需要提交JAR文件到SCM仓库中，你可以建立一个组织层次的Maven仓库，供所有成员使用。  
简言之，Maven仓库能帮助我们管理构件（主要是JAR）。  
  
本地仓库（.m2） vs. 远程仓库（联网）  
运行Maven的时候，Maven所需要的任何构件都是直接从本地仓库获取的。如果本地仓库没有，它会首先尝试从远程仓库下载构件至本地仓库，然后再使用本地仓库的构件。  
比如说，你的项目配置了junit-3.8的依赖，在你运行mvn test 的时候，Maven需要使用junit-3.8的jar文件，它首先根据坐标查找本地仓库，如果找到，就直接使用。如果没有，Maven会检查可用的远程仓库配置，然后逐个尝试这些远程仓库去下载junit-3.8的jar文件，如果远程仓库存在该文件，Maven会将其下载到本地仓库中，继而使用。如果尝试过所有远程仓库之后，Maven还是没能够下载到该文件，它就会报错。  
Maven缺省的本地仓库地址为$\{user.home\}/.m2/repository 。也就是说，一个用户会对应的拥有一个本地仓库。  
你也可以自定义本地仓库的位置，修改$\{user.home\}/.m2/settings.xml ：

**\[html\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  <!-- localRepository 
2.   | The path to the local repository maven will use to store artifacts. 
3.   | 
4.   | Default: $\{user.home\}/.m2/repository--**>**
5.  **<****localRepository****>**D:/.m2/repository**</****localRepository****>**

还可以在运行时指定本地仓库位置：  
mvn clean install -Dmaven .repo.local =/home/juven/myrepo/

还有一点需要理解的是，当我们运行install的时候，Maven实际上是将项目生成的构件安装到了本地仓库，也就是说，只有install了之后，其它项目才能使用此项目生成的构件。

接着了解一下Maven缺省的远程仓库，即Maven中央仓库:  
安装好Maven之后，我们可以建立一个简单的项目，配置一些简单的依赖，然后运行mvn clean install，项目就构建好了。我们没有手工的去下载任何jar文件，这一切都是因为Maven中央仓库的存在，当Maven在本地仓库找不到需要的jar文件时，它会查找远程仓库，而一个原始的Maven安装就自带了一个远程仓库——Maven中央仓库。  
这个Maven中央仓库是在哪里定义的呢？在我的机器上，我安装了maven-2.0.10，我可以找到这个文件：$\{M2\_HOME\}/lib/maven-2.0.10-uber.jar ，

但是到了3.xxx版本之后在： maven安装目录下的：/lib/maven-model-builder-$\{version\}.jar中

打开该文件，能找到超级POM：\\org\\apache\\maven\\model\\pom-4.0.0.xml ，它是所有Maven POM的父POM，所有Maven项目继承该配置，你可以在这个POM中发现如下配置：

**\[html\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **<****repositories****>**
2.  **<****repository****>**
3.  **<****id****>**central**</****id****>**
4.  **<****name****>**Central Repository**</****name****>**
5.  **<****url****>**https://repo.maven.apache.org/maven2**</****url****>**
6.  **<****layout****>**default**</****layout****>**
7.  **<****snapshots****>**
8.  **<****enabled****>**false**</****enabled****>**
9.  **</****snapshots****>**
10. **</****repository****>**
11. **</****repositories****>**

关于远程仓库的配置，下面的我会详细解释，这里我们只要知道，中央仓库的id为central，远程url地址为http://repo.maven.apache.org/maven2，它关闭了snapshot版本构件下载的支持。

在**POM中**配置远程仓库  
前面我们看到超级POM配置了ID为central的远程仓库，我们可以在POM中配置其它的远程仓库。这样做的原因有很多，比如你有一个**局域网的远程仓库**，使用该仓库能大大提高下载速度，继而提高构建速度，也有可能你依赖的一个jar在central中找不到，它只存在于某个特定的公共仓库，这样你也不得不添加那个远程仓库的配置。  
这里我配置一个远程仓库指向中央仓库的中国镜像：

**\[html\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **<****project****>**
2.  ... 
3.  **<****repositories****>**
4.  **<****repository****>**
5.  **<****id****>**maven-net-cn**</****id****>**
6.  **<****name****>**Maven China Mirror**</****name****>**
7.  **<****url****>**http://maven.net.cn/content/groups/public/**</****url****>**
8.  **<****releases****>**
9.  **<****enabled****>**true**</****enabled****>**
10. **</****releases****>**
11. **<****snapshots****>**
12. **<****enabled****>**false**</****enabled****>**
13. **</****snapshots****>**
14. **</****repository****>**
15. **</****repositories****>**
16. **<****pluginRepositories****>**
17. **<****pluginRepository****>**
18. **<****id****>**maven-net-cn**</****id****>**
19. **<****name****>**Maven China Mirror**</****name****>**
20. **<****url****>**http://maven.net.cn/content/groups/public/**</****url****>**
21. **<****releases****>**
22. **<****enabled****>**true**</****enabled****>**
23. **</****releases****>**
24. **<****snapshots****>**
25. **<****enabled****>**false**</****enabled****>**
26. **</****snapshots****>**
27. **</****pluginRepository****>**
28. **</****pluginRepositories****>**
29. ... 
30. **</****project****>**

我们先看一下<repositories>的配置，你可以在它下面添加多个<repository> ，每个<repository>都有它唯一的ID，一个描述性的name，以及最重要的，远程仓库的url。此外，<releases><enabled>true</enabled></releases>告诉Maven可以从这个仓库下载releases版本的构件，而<snapshots><enabled>false</enabled></snapshots>告诉Maven不要从这个仓库下载snapshot版本的构件。禁止从公共仓库下载snapshot构件是推荐的做法，因为这些构件不稳定，且不受你控制，你应该避免使用。当然，如果你想使用局域网内组织内部的仓库，你可以激活snapshot的支持。

关于<repositories>的更详细的配置及相关解释，请参考：http://www.sonatype.com/books/maven-book/reference\_zh/apas02s08.html。  
至于<pluginRepositories>，这是配置Maven从什么地方下载插件构件（Maven的所有实际行为都由其插件完成）。该元素的内部配置和<repository>完全一样，不再解释。

在**settings.xml中**配置远程仓库  
我们知道了如何在POM中配置远程仓库，但考虑这样的情况：在一个公司内部，同时进行这3个项目，而且以后随着这几个项目的结束，越来越多的项目会开始；同时，公司内部建立一个Maven仓库。我们统一为所有这些项目配置该仓库，于是不得不为每个项目提供同样的配置。问题出现了，这是重复 ！  
其实我们可以做到只配置一次，在哪里配置呢？就是settings.xml。  
不过事情没有那么简单，不是简单的将POM中的<repositories>及<pluginRepositories>元素复制到settings.xml中就可以，setting.xml不直接支持 这两个元素。但我们还是有一个并不复杂的解决方案，就是利用profile，如下：

**\[html\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **<****settings****>**
2.   ... 
3.  **<****profiles****>**
4.  **<****profile****>**
5.  **<****id****>**dev**</****id****>**
6.  
7.  **</****profile****>**
8.  **</****profiles****>**
9.  **<****activeProfiles****>**
10. **<****activeProfile****>**dev**</****activeProfile****>**
11. **</****activeProfiles****>**
12.  ... 
13. **</****settings****>**

这里我们定义一个id为dev的profile，将所有 repositories以及pluginRepositories元素放到这个profile中 ，然后，使用<activeProfiles>元素自动激活该profile。这样，你就不用再为每个POM重复配置仓库。  
使用profile为settings.xml添加仓库提供了一种用户全局范围的仓库配置。

使用**镜像**  
如果你的地理位置附近有一个速度更快的central镜像，或者你想覆盖central仓库配置，或者你想为所有POM使用唯一的一个远程仓库（这个远程仓库代理的所有必要的其它仓库），你可以使用settings.xml中的mirror配置。  
以下的mirror配置用maven[.NET][].cn覆盖了Maven自带的central：

**\[html\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **<****settings****>**
2.  ... 
3.  **<****mirrors****>**
4.  **<****mirror****>**
5.  **<****id****>**maven-net-cn**</****id****>**
6.  **<****name****>**Maven China Mirror**</****name****>**
7.  **<****url****>**http://maven.net.cn/content/groups/public/**</****url****>**
8.  **<****mirrorOf****>**central**</****mirrorOf****>**
9.  **</****mirror****>**
10. **</****mirrors****>**
11. ... 
12. **</****settings****>**

这里唯一需要解释的是<mirrorOf>，这里我们配置central的镜像，我们也可以配置一个所有仓库的镜像，以保证该镜像是Maven唯一使用的仓库：

**\[html\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **<****mirrors****>**
2.   <!-- mirror 
3.   | Specifies a repository mirror site to use instead of a given repository. The repository that 
4.   | this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used 
5.   | for inheritance and direct lookup purposes, and must be unique across the set of mirrors. 
6.   | 
7.   \--**>**
8.  **<****mirror****>**
9.  **<****id****>**nexus**</****id****>**
10. **<****mirrorOf****>**\***</****mirrorOf****>**
11. **<****name****>**Nexus Mirror**</****name****>**
12. **<****url****>**http://xx.xx/nexus/content/groups/public**</****url****>**
13. **</****mirror****>**
14. **</****mirrors****>**

**\[html\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **<****settings****>**
2.  ... 
3.  **<****mirrors****>**
4.  **<****mirror****>**
5.  **<****id****>**my-org-repo**</****id****>**
6.  **<****name****>**Repository in My Orgnization**</****name****>**
7.  **<****url****>**http://192.168.1.100/maven2**</****url****>**
8.  **<****mirrorOf****>**\***</****mirrorOf****>**
9.  **</****mirror****>**
10. **</****mirrors****>**
11. ... 
12. **</****settings****>**

#### [Maven最佳实践：Maven仓库][Maven_Maven] [http://juvenshun.iteye.com/blog/359256][Maven_Maven] ####

[view plain]: http://blog.csdn.net/zlgydx/article/details/51130627#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/1643219
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/1643219/fork
[.NET]: http://lib.csdn.net/base/dotnet
[Maven_Maven]: http://juvenshun.iteye.com/blog/359256