Maven dependency and repository (part b)

原文地址：http://blog.csdn.net/totogogo/archive/2007/12/20/1956381.aspx

Repository介绍

 

Artifact Repositories

Repository就是用来存储artifacts and dependencies（实质也就是artifact）的地方。

有2种类型的repositories: local and remote。local repository里存储了因有使用需要而从remote repository下载的artifacts 的cache，还存储了你在本地build的，但还没有发布到remote repository的artifacts。

Remote repositories能够被accessed by 各种协议（如file:// and http://）。Remote repositories可以是真正供所有人都可以进入的repositorie（例如：Maven's central repository  repo1.maven.org就是典型例子)，也可以是一个build在你公司内部http server的internal repositories，它只在你们的开发团队里共享。

The local and remote repositories的结构是相同的，但作为maven的使用者，我们不需要去深入了解它的结构。

 

Why not Store JARs in CVS?

Maven强烈建议不要在你的project里包含任何要引用的JARs，即project不要存储这些jars，而应该定义对这些jars的dependency。例如，很多的project都会使用到一些常用的jar（如junit, XML parsers和standard utilities），你不要把他们的jar都放入你的project里，而应该使用它们的dependencies。

这些dependencies存储在local repositoty里可以供成千上万个project使用，其好处有：

·         It uses less storage – 每个JAR只存储在repository一个地方，所有的project如果要使用它就定义它的dependency即可，节约了空间，同时也使你的project cleaner。

·         It makes checking out a project quicker - initial checkout, and to a small degree updating, a project will be faster if there are no large binary files in CVS. While they may need to be downloaded again afterwards anyway, this only happens once and may not be necessary for some common JARs already in place.

·         No need for versioning – CVS and other source control systems are designed for versioning files, but external dependencies typically don't change, or if they do their filename changes anyway to indicate the new version. Storing these in CVS doesn't have any added benefit over keeping them in a local artifact cache.

 

Using Repositories

通常，你不需要对local repository做任何事，除非你想重新download所有的artifact而清空local repository

而对于remote repositories, 它们是用来download and upload artifact的 (当然，你必须有权限才可以操作).

Downloading from a Remote Repository

当一个project定义的dependency 在local repository里找不到，或者remote repository包含了新版本时，就会激活Download the dependency from remote repository的操作。

缺省情况下，会从maven central repository (http://repo1.maven.org/maven2 ) 下载。如果你还希望能够从其他的remote repository下载（比如要下载只供你们team使用的artifact），你需要在POM.XML里做下列设置：

<project>

 ...

 <repositories>

    <repository>

      <id>my-internal-site</id>

      <url>http://myserver/repo</url>

    </repository>

 </repositories>

 ...

</project>

上述设置也可以在settings.xml里。

Using Mirrors for the Central Repository

就象web server一样，central repository有时也会down机。如果这种情况发生了，你可以在settings.xml 里设置 <mirrors> element。详见Using Mirrors for Repositories .

 

Build Offline

如果你在使用maven build project时你的电脑无法连上网，那么你可以在mvn命令里添加-o参数

 mvn -o package

但要注意：许多plugins在设置为offline的情况下不会执行任何需要连接上网的操作，就会导致失败。

 

Internal Repositories

 

对于团队合作开发的project，建一个internal repository，使得团队成员能够共享、下载、上传最新的artifact，是非常必要的。internal repository并没有什么特别，它实际上就是一个remote repository

团队成员可以使用HTTP or the file system (using a file:// URL)的方式从internal repository下载artifact，也可以使用 SCP, FTP, or a file copy的方式上传artifact到internal repository。