Maven配置 settings.xml

摘要记录settings.xml的配置，理解mirror、repository、profile的关系

本地仓库是远程仓库的一个缓冲和子集，当你构建Maven项目的时候，首先会从本地仓库查找资源，如果没有，那么Maven会从远程仓库下载到你本地仓库。这样在你下次使用的时候就不需要从远程下载了。如果你所需要的jar包版本在本地仓库没有，而且也不存在于远程仓库，Maven在构建的时候会报错，这种情况可能发生在有些jar包的新版本没有在Maven仓库中及时更新。

Maven缺省的本地仓库地址为${user.home}/.m2/repository 。也就是说，一个用户会对应的拥有一个本地仓库。当然你可以通过修改${user.home}/.m2/settings.xml 配置这个地址：

Xml代码

<settings>
…
<localRepository> D:/java/repository</localRepository>
…
</settings>

如果你想让所有的用户使用统一的配置那么你可以修改Maven主目录下的setting.xml:

${M2_HOME}/conf/setting.xml

repository是指在局域网内部搭建的repository，它跟central repository, jboss repository等的区别仅仅在于其URL是一个内部网址
mirror则相当于一个代理，它会拦截去指定的远程repository下载构件的请求，然后从自己这里找出构件回送给客户端。配置mirror的目的一般是出于网速考虑。

不过，很多internal repository搭建工具往往也提供mirror服务，比如Nexus就可以让同一个URL,既用作internal repository，又使它成为所有repository的mirror。

高级的镜像配置：
1.<mirrorOf>*</mirrorOf>
匹配所有远程仓库。这样所有pom中定义的仓库都不生效
2.<mirrorOf>external:*</mirrorOf>
匹配所有远程仓库，使用localhost的除外，使用file://协议的除外。也就是说，匹配所有不在本机上的远程仓库。
3.<mirrorOf>repo1,repo2</mirrorOf>
匹配仓库repo1和repo2，使用逗号分隔多个远程仓库。
4.<mirrorOf>*,!repo1</miiroOf>
匹配所有远程仓库，repo1除外，使用感叹号将仓库从匹配中排除。

mirrors可以配置多个mirror，每个mirror有id,name,url,mirrorOf属性，id是唯一标识一个mirror就不多说了，name貌似没多大用，相当于描述，url是官方的库地址，mirrorOf代表了一个镜像的替代位置，例如central就表示代替官方的中央库。

我本以为镜像库是一个分库的概念，就是说当a.jar在第一个mirror中不存在的时候，maven会去第二个mirror中查询下载。但事实却不是这样，当第一个mirror中不存在a.jar的时候，并不会去第二个mirror中查找，甚至于，maven根本不会去其他的mirror地址查询。

后来终于知道，maven的mirror是镜像，而不是“分库”，只有当前一个mirror无法连接的时候，才会去找后一个，类似于备份和容灾。

还有，mirror也不是按settings.xml中写的那样的顺序来查询的。

所谓的第一个并不一定是最上面的那个。

当有id为B,A,C的顺序的mirror在mirrors节点中，maven会根据字母排序来指定第一个，所以不管怎么排列，一定会找到A这个mirror来进行查找，当A无法连接，出现意外的情况下，才会去B查询。

001

<?xml version="1.0" encoding="UTF-8"?>

002

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"

003

          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

004

          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

005
 
006

    <servers>

007

        <server>

008

            <id>repo-iss</id>

009

            <username>deployment</username>

010

            <password>deployment123</password>

011

        </server>

012

    </servers>

013
 
014

    <mirrors>

015

        <!-- osc镜像 -->

016

        <mirror>

017

            <!-- 镜像所有远程仓库，但不包括指定的仓库 -->

018

            <id>mirror-osc</id>

019

            <mirrorOf>external:*,!repo-osc-thirdparty,!repo-iss</mirrorOf>

020

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

021

        </mirror>

022
<!--

023

        <mirror>

024

            <id>mirror-iss</id>

025

            <mirrorOf>external:*</mirrorOf>

026

            <url>http://10.24.16.99:5555/nexus/content/groups/public/</url>

027

        </mirror>

028
-->

029

    </mirrors>

030
 
031

    <profiles>

032

        <profile>

033

            <id>profile-default</id>

034

            <repositories>

035

                <repository>

036

                    <id>central</id>

037

                    <url>http://central</url>

038

                    <releases>

039

                        <enabled>true</enabled>

040

                    </releases>

041

                    <snapshots>

042

                        <enabled>false</enabled>

043

                    </snapshots>

044

                </repository>

045

                <repository>

046

                    <id>repo-osc-thirdparty</id>

047

                    <url>http://maven.oschina.net/content/repositories/thirdparty/</url>

048

                    <releases>

049

                        <enabled>true</enabled>

050

                    </releases>

051

                    <snapshots>

052

                        <enabled>false</enabled>

053

                    </snapshots>

054

                </repository>

055

            </repositories>

056

            <pluginRepositories>

057

                <pluginRepository>

058

                    <id>central</id>

059

                    <url>http://central</url>

060

                    <releases>

061

                        <enabled>true</enabled>

062

                    </releases>

063

                    <snapshots>

064

                        <enabled>false</enabled>

065

                    </snapshots>

066

                </pluginRepository>

067

            </pluginRepositories>

068

        </profile>

069

        <profile>

070

            <id>profile-iss</id>

071

            <repositories>

072

                <repository>

073

                    <id>repo-iss</id>

074

                    <url>http://10.24.16.99:5555/nexus/content/groups/public/</url>

075

                    <releases>

076

                        <enabled>true</enabled>

077

                    </releases>

078

                    <snapshots>

079

                        <enabled>true</enabled>

080

                    </snapshots>

081

                </repository>

082

            </repositories>

083

            <pluginRepositories>

084

                <pluginRepository>

085

                    <id>repo-iss</id>

086

                    <url>http://10.24.16.99:5555/nexus/content/groups/public/</url>

087

                    <releases>

088

                        <enabled>true</enabled>

089

                    </releases>

090

                    <snapshots>

091

                        <enabled>true</enabled>

092

                    </snapshots>

093

                </pluginRepository>

094

            </pluginRepositories>

095

        </profile>

096

    </profiles>

097
 
098

    <activeProfiles>

099

        <activeProfile>profile-default</activeProfile>

100

        <!--<activeProfile>profile-iss</activeProfile>-->

101

    </activeProfiles>

102
 
103
<!--

104

    <proxies>

105

        <proxy>

106

            <active>true</active>

107

            <protocol>http</protocol>

108

            <host>10.10.204.160</host>

109

            <port>80</port>

110

        </proxy>

111

    </proxies>

112
-->

113

</settings>