Maven仓库

Maven仓库是什么

Maven在某个位置统一存储所有Maven项目共享的构件，这个统一的位置就是仓库。

仓库的布局

在仓库中，任何一个构件都有其唯一的坐标，根据这个坐标可以定义在其仓库中的唯一路径，这就是Maven的仓库布局方式。坐标和路径的对应关系为groupId/artifactId/version/artifactId-version.packaging。

仓库的分类

Maven仓库分为本地仓库和远程仓库，远程仓库分为中央仓库、私服和其他公共库。

本地仓库

在用户的用户目录下有一个路径名为.m2/repository的仓库目录，此为本地仓库。
我们也可以通过编辑文件.m2/settings.xml设置本地仓库的地址，设置localRepository的值为想要的仓库地址。

<!--
 localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  <localRepository>/path/to/local/repo</localRepository>

-->

默认情况下，文件.m2/settings.xml是不存在的。我们要从maven安装目录下的conf文件夹里面把settings.xml文件复制过来。
一个构件只有在本地仓库才可以被使用，构件进入本地仓库有两种方式。一种是从远程仓库下载到本地仓库，另一种是通过命令mvn clean install将本地项目的构件安装到本地仓库中。

远程仓库

远程仓库是非本地的仓库，当所要的构件在本地仓库找不到，才会去远程仓库进行寻找。

中央仓库

中央仓库是Maven默认的远程仓库，包含了世界上绝大多数流行的开源Java构件。

私服

私服是一种特殊的远程仓库，它是架设在局域网内的仓库服务。当Maven需要下载构件时，它从私服请求，私服上没有想要的构件才会请求外部的远程仓库。Maven用户可以上传构件到私服，也可以从外部远程仓库下载构件到私服。
使用私服的好处：
* 加速Maven构建
* 节省自己的外网带宽
* 部署第三方构件
* 提高稳定性
* 降低中央仓库的负荷

其他公共库

除了中央仓库和私服的其他远程仓库，常见的有Java.net Maven库和JBoss Maven库等。

远程仓库的配置

如果默认的中央仓库没法满足需要，我们需要配置其他远程仓库，则需要在pom.xml里面配置。

<project>
    <repositories>
        <repository>
            <id>jboss</id>
            <name>JBoss Repository</name>
            <url>http://repository.jboss.com/maven2/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
            <layout>default</layout>
        </repository>
    </repositories>
</project>

可以在repositories标签下可以通过子元素repository配置多个远程仓库。id元素的值必须是唯一的，其标识了该远程仓库。Maven自带的中央仓库id是central，如果使用该id会覆盖中央仓库。name元素为该仓库命名。url元素指向仓库的地址，该地址基于http协议。releases和snapshots元素分别用来控制Maven对于发布版构件和快照版构件的下载。这两个元素有三个子元素，分别是enabled，updatePolicy和checksumPolicy。enabled的值为true或false，true是支持下载该版本的构件，false是不支持。updatePolicy是用来配置Maven从远程仓库检查更新的频率，默认值是daily，表示Maven每天检查一次。其他可用的值有never（从不检查更新），always（每次构建都检查更新），internal:X（每隔X分钟检查一次更新，X为整数）。checksumPolicy用来配置Maven检查检验和文件的策略。当构件被部署到Maven仓库时，会同时部署对应的检验和文件。在下载构件的时候，Maven会验证检验和文件。如果检验和验证失败，当checksumPolicy的值为默认的warm时，Maven在执行构建时会输出警告信息；为fail时会构建失败，为ignore时会忽略这个错误。

远程仓库的认证

大部分远程仓库可以直接访问，但有时候出于安全目的，必须提供认证信息才能访问一些远程仓库。配置认证信息需要在setting.xml里面配置。

<settings>
    ...
    <servers>
        <server>
            <id>my-proj</id>
            <username>repo-user</username>
            <password>repo-pwd</password>
        </server>
    </servers>
    ...
</settings>

以上，id元素指定所需要认证的仓库id，username和password分别指定用户名和密码。

部署至远程仓库

想要把项目生成的构件部署到远程仓库，需要在pom.xml文件里面配置，如果需要认证，则要在setting.xml中配置认证信息。

<project>
    ...
    <distributionManagement>
        <repository>
            <id>proj-releases</id>
            <name>Proj Release Repository</name>
            <url>http://192.168.1.100/content/repositories/proj-releases</url>
        </repository>
        <snapshotRepository>
            <id>proj-snapshots</id>
            <name>Proj Snapshot Repository</name>
            <url>http://192.168.1.100/content/repositories/proj-releases</url>
        </snapshotRepository>
    </distributionManagement>
    ...
</project>

以上时在pom.xml中的配置。distributionManagement的两个子元素repository和snapshotRepository分别配置发布版本构件的仓库和快照版本的构件。两个元素都要配置id，name和url。id时配置唯一标识，name只是方便阅读，url是配置仓库地址。

镜像

如果仓库X可以提供仓库Y存储的所有内容，则可以认为X是Y的一个镜像。编辑setting.xml可以将被镜像的请求转移到镜像仓库上。

<settings>
    ...
    <mirrors>
        <mirror>
            <id>internal-repository</id>
            <name>Internal Repository Manager</name>
            <url>http://192.168.1.100/maven2</url>
            <mirrorOf>*</mirrorOf>
        </mirror>
    </mirrors>
    ...
</settings>

上面的配置信息中，id是镜像的唯一标识，name配置其名字，url配置其仓库地址，mirrorOf配置其需要代理的仓库。上面的*是只所有Maven仓库的请求都转向该镜像。
mirrorOf的值有很多：
* *：匹配所有远程仓库
* external:*：匹配所有不在本地上的远程仓库
* repo1，repo2：匹配仓库repo1和repo2，使用逗号分隔多个仓库
* *，!repo1：匹配所有远程仓库，repo1除外
需要注意的时，当镜像仓库不稳定或停止服务时，Maven是无法访问被代理的仓库的。

仓库搜索服务

如果你只知道你想要的构件名字，不知道具体Maven依赖路径，可以通过仓库搜索服务进行查找该构件路径，下面是提供仓库搜索服务的网站。
Sonatype Nexus
MVNrepository