maven配置文件

  • 前言
  • 节点理解
  • mirror配置
  • repository配置
  • mirror、repository查找顺序
  • 配置实例


前言

当我们进入一个公司，基本会统一发maven的setting文件，因为很多公司都有自己的私有仓库，很少有人去了解过setting文件，为什么有的setting文件要配repository、server还要配mirror？这些配置又有什么含义，他们之间的关系是什么?配置多个repository查找jar的顺序是什么？结合mirror又会如何查找？

节点理解

proxy是maven服务器不能访问外网时需要设置的代理服务（不常用）
server是maven需要打包代码上传到私服时，设置私服的鉴权信息，账号+密码
repository是maven去下载jar包的地址
mirror用于代替repository的镜像地址

internal repository（私服）指在局域网内部搭建的repository，跟local repository、jboss repository等的区别仅仅在于其URL是一个内部地址

mirro（镜像），相当于一个代理，会拦截去指定的远程repository下载构件的请求，然后从自己这里找出构件返回给客户端。配置mirror一般是出于网速。

私服和mirror是不同的，repository，用来提供公司内部的maven构件，而mirror只是远程repository的网络加速器

很多internal repository搭建工具也会提供mirror服务，比如Nexus可以让同一个URL用作internal repository，又让它成为所有repository的mirror

mirror配置

一个mirror节点可以对应一个或对个repository节点，由mirrorOf中的值决定

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                      https://maven.apache.org/xsd/settings-1.0.0.xsd">
  ...
  <mirrors>
    <mirror>
      <id>planetmirror.com</id>
      <name>PlanetMirror Australia</name>
      <url>http://downloads.planetmirror.com/pub/maven2</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>
  ...
</settings>
  • id： mirror标识
  • name： 属性、名称
  • url： 属性，镜像地址
  • mirrorOf： 该镜像对应repository的ID

以下是使用网易的镜像，来替代中央的仓库的配置样例：

<mirrors>
     <mirror>
      <id>maven.163.com</id>
      <name>maven mirror in China</name>
      <url>http://mirrors.163.com/maven/repository/maven-public/</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
</mirrors>

在使用的过程中，会出现这种不标准的配置：

<mirrors>
     <mirror>
      <id>maven.163.com</id>
      <name>maven mirror in China1</name>
      <url>http://mirrors.163.com/maven/repository/maven-public/</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
</mirrors>
<mirrors>
    <mirror>
      <id>aliyun.com</id>
      <name>maven mirror in China2</name>
      <mirrorOf>central</mirrorOf>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

这时候将两个镜像同时指向（central）中央仓库，这种maven只会选取第一个镜像，第二个永远不会生效。

repository配置

repository节点必须作为repositorys的子节点存在，而repositorys节点又必须作为profiles节点的子节点存在

<profiles>
    <profile>
        <id>nexus</id>
        <repositories>
            <!-- 公司私服配置 -->
            <repository>
                <id>you-internal-repos</id>
                <url>you-internal-repos-address</url>
                <releases>
                    <enabled>true</enabled>
                    <updatePolicy>always</updatePolicy>
                    <checksumPolicy>warn</checksumPolicy>
                </releases>
                <snapshots>
                    <enabled>true</enabled>
                    <updatePolicy>always</updatePolicy>
                    <checksumPolicy>warn</checksumPolicy>
                </snapshots>
            </repository>
            <!-- 阿里云私服配置 -->
            <repository>
                <id>aliyun-repos</id>
                <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
                <releases>
                    <enabled>true</enabled>
                </releases>
                <snapshots>
                    <enabled>true</enabled>
                </snapshots>
            </repository>
        </repositories>
    </profile>
</profiles>

<!-- 默认生效 -->
<activeProfiles>
    <activeProfile>nexus</activeProfile>
</activeProfiles>

mirror、repository查找顺序

当一个repository存在mirror时，maven查找jar时永远都是使用mirror配置的地址
当repository不存在mirror时，按照repositorys节点定义的先后顺序。先定义，在查找。

配置实例

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <localRepository>你的本地仓库地址</localRepository>
  <pluginGroups></pluginGroups>
  <proxies></proxies>
  <servers></servers>
  <mirrors>
    <mirror>
      <id>nexus-aliyun</id>
      <name>Nexus aliyun</name>
      <mirrorOf>central</mirrorOf>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
    <mirror>
      <id>nexus-mine</id>
      <name>Nexus mine</name>
      <mirrorOf>*</mirrorOf>
      <url>http://xx.xx.xx.xx/nexus/content/groups/public</url>
    </mirror>
  </mirrors>
</settings>