Maven学习（三） -- 仓库

标签（空格分隔）：学习笔记

坐标和依赖时任何一个构件在Maven世界中的逻辑表示方式；而构件的物理表示方式是文件，Maven通过仓库来同意管理这些文件。

任何一个构件都有其唯一的坐标，根据这个坐标可以定义其在仓库中的唯一存储路径，这便是Maven的仓库布局方式。

仓库的分类

对于Maven来说，仓库只分为两类：本地仓库和远程仓库。

当Maven根据坐标寻找构建的时候，首先会查看本地仓库，如果本地仓库存在此构件，则直接使用；如果本地仓库不存在此构件，或者需要查看是否有更新的构件版本，Maven就会到远程仓库查找，发现需要的构件后，将其下载到本地仓库再使用。如果本地仓库和远程仓库都不存在需要的构件，则报错。

本地仓库

不论是在Windows还是Linux上，Maven的默认仓库位置都为.m2/respository/，例如在Windows上的路径为：C:\Users\Parkk\.m2\respository\，而Linux上的路径为：/home/parkk/.m2/respository。

我们也可以通过修改~/.m2/settings.xml，设置localRespositury元素的值为想要的仓库地址：（关于settings.xml的描述，在上一篇博客中有描述，这里不再赘述）

<settings>

    <localRepository>D:\java\repository</localReposity>

</settings>

这样，就将本地仓库的位置设为了：D:\java\repository

一个构件只有在本地仓库之中后，才能由其他Maven项目使用，那么构件是如何进入到本地仓库中的呢？

可以将构件依赖Maven从远程仓库下载到本地仓库中，使用命令mav clean install；
可以将本地项目的构件安装到Maven仓库中。

远程仓库

安装好Maven后，如果不执行mvn命令，本地仓库目录是不存在的。当用户输入第一条Maven命令后，Maven才会创建本地仓库，然后根据配置需要，从远程仓库中下载构件至本地。

这个过程类似于藏书，当小明想读一本书《苏菲的世界》时，首先到书房里找这本书，如果没有，则会去书店中购买这本书放到书房，想读时随时拿出来读；有一天，小明又想读一本《机器学习》，到书房中寻找，没有又会到书店中将这本书买回家……

当Maven无法从本地仓库找到需要的构件的时候，就会从远程仓库中下载构件至本地仓库。

对于Maven来说，每个用户只有一个本地仓库，但是可以配置多个远程仓库。

中央仓库 -- Maven默认的远程仓库

在Maven中，%M2_HOME%/lib/maven-model-builder-3.3.9.jar中一个配置文件org/apache/maven/model/pom-4.0.0.xml中配置了中央仓库的URL：http://repo1.maven.org/maven2。

中央仓库中包含了世界上流行的大量开源Java构件，一般来说，一个简单的Maven项目所需要的依赖构件都能够从中央仓库中下载到。

私服

私服是一种特殊的远程仓库，它是架设在局域网内部的仓库服务，私服代理广域网上的远程仓库，供局域网内的Maven用户使用。

当Maven需要下载构件的时候，先从私服请求，如果私服不存在这个构件，则从外部的远程从库下载，缓存在私服后，再为Maven的下载请求提供服务；
一些无法从外部仓库下载到的构件也能从本地上传到私服上供大家使用。

私服的用途如下图所示：

这样做的好处就不要多说了吧，什么节约外网的贷款，加速Maven的构件，方便部署第三方构件，稳定……

远程仓库的配置

在很多时候，默认的中央仓库无法满足项目的需要，所以可能需要配置其他的远程仓库，如JBoss Maven仓库，在POM文件中进行配置，语法如下：

<project>

 ...

    <repositories>

        <repository>

            <id>jboss</id>

            <name>JBoss Repository</name>

            <url>http://repository.jboss.com/maven2/</url>

            <releases>

                <enabled>true</enabled>

            </releases>

            <snapshots>

                <enables>false</enables>

            </snapshots>

            <layout>default</layout>

        </repository>

    </repositories>

 ...

</project>

id: 唯一的标识这个远程仓库；
releases和snapshots：用来控制Maven对于发布版本构件和快照版本构件的下载。这里的enable分别设置为true和false，表示只会从JBoss仓库下载发布版的构件，而不会下载快照版的构件。

远程仓库的认证

有时为了安全考虑，我们需要提供认证信息才能访问一些远程仓库。

配置仓库信息和配置认证信息不同，仓库信息可以直接配置在POM文件中，而认证信息必须配置在settigns.xml中。这是因为POM往往是被提交到代码仓库中供所有成员使用的，而settigns.xml一般放在本地。

语法如下：

<settings>

...

    <servers>

        <server>

            <id>my-proj</id>

            <username>repo-user</username>

            <password>repo-psw</password>

        </server>

    </servers>

...

</settings>

settigns.xml中server元素的id必须与POM中需要认证的repository元素的id完全一致！

部署至远程仓库

编辑项目的pom.xml文件的distributionManagement元素：

<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 Snapshots Repository</name>

            <url>http://192.168.1.100/content/repositories/proj-snapshots</url>

        </snapshotRepository>

    </distributionManagement>

...

</project>

这里主要配置repository和snapshotRepository子元素，前者表示发布分本构件的仓库，后者表示快照版本的仓库。
在往远程仓库部署构件的时候，往往需要认证。-- 需要在settings.xml中创建一个server元素，其id与仓库的id匹配，并配置正确的认证信息。
配置正确后，在命令行运行mvn clean deploy将项目构件输出的构件部署到对应的远程仓库。

镜像

如果仓库X可以提供仓库Y存储的所有内容，那么就可以认为X是Y的一个镜像。

中央仓库镜像配置

例如，http://maven.net.cn/content/groups/public/是中央仓库http://repo1.maven.org/maven2/在中国的镜像，因此可以配置settings.xml使用该镜像来替代中央仓库：

<settings>

    ...

    <mirrors>

        <mirror>

            <id>maven.net.cn</id>

            <name>one of central mirrors in China</name>

            <url>http://maven.net.cn/content/groups/public/</url>

            <mirrorOf>central<mirrorOf>

        </mirror>

    </mirrors>

    ...

</settings>

私服镜像配置

对于组织内部的Maven用户来说，使用一个私服地址就等于使用了所有需要的外部仓库，可以将配置集中到私服，从而简化Maven的配置。

<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>

其中，

<mirrorOf>*<mirrorOf>: 表示匹配所有远程仓库；
<mirrorOf>external:*</mirrorOf>: 表示匹配所有远程仓库，使用localhost的除外，使用file://协议的除外。
<mirrorOf>repo1, repo2</mirrorOf>: 匹配repo1和repo2，使用逗号分隔多个仓库；
<mirrorOf>*,! repo1</mirrorOf>: 匹配所有远程仓库，repo1除外，使用感叹号将从库从中排除。

几个常用的仓库搜索服务