Maven 之 settings.xml文件详解

目录

一. 前言

二. settings.xml 文件详解

2.1. 配置节点详解

2.2. 实例详解

三. mirrorOf 详解

一. 前言

    Maven是一个流行的Java项目构建工具，它使用pom.xml文件来定义项目的配置和依赖关系。然而，Maven还提供了另一个重要的文件——setting.xml文件，用于配置Maven本身的行为。在本文中，我们将深入介绍setting.xml文件的作用和常见的配置选项。

    关于Maven的详细介绍请参见《Maven 从入门到精通》。

二. settings.xml 文件详解

2.1. 配置节点详解

    直接修改安装包下 setting.xml 文件，就能在机器上全局地定制 Maven 的行为。一般情况下，我们更偏向于复制该文件至 ～/.m2/ 目录下（～表示用户目录；在Linux或Mac OS X中，它的默认位置是 ~/.m2/settings.xml，在Windows系统中，它的默认位置是%USER_HOME%.m2\settings.xml），然后修改该文件，在用户范围定制 Maven 的行为。Maven运行时，先找用户目录 .m2 文件夹的 settings.xml，没有的话去安装包里面找全局的settings.xml。

    实际应用中，经常使用的是 、、、 这几个节点，其他节点使用默认值足够应对大部分的应用场景。

2.2. 实例详解

"1.0" encoding="UTF-8"?>     
<settings   xmlns="http://maven.apache.org/POM/4.0.0"    
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">  
        
      
    <localRepository>usr/local/mavenlocalRepository> 
        
      
    <interactiveMode>trueinteractiveMode>  
        
      
      
      
    <usePluginRegistry>falseusePluginRegistry>  
        
      
      
    <offline>falseoffline>  
        
      
      
      
      
    <pluginGroups>  
            
          
        <pluginGroup>org.codehaus.mojopluginGroup>  
           
    pluginGroups>  
        
      
    <proxies>  
            
          
        <proxy>  
                
              
            <id>myproxyid>  
                
              
            <active>trueactive>  
                
              
            <protocol>http://…protocol>  
                
              
            <host>proxy.somewhere.comhost>  
                
              
            <port>8080port>  
                
               
            <username>proxyuserusername>  
                
              
            <password>somepasswordpassword>  
                
              
            <nonProxyHosts>*.google.com|ibiblio.orgnonProxyHosts>  
                
        proxy>  
           
    proxies>  
        
      
    <servers>  
            
          
        <server>  
                
              
            <id>server001id>  
                
              
            <username>my_loginusername>  
                
              
            <password>my_passwordpassword>  
                
              
              
            <privateKey>${usr.home}/.ssh/id_dsaprivateKey>  
                
              
            <passphrase>some_passphrasepassphrase>  
                
              
              
            <filePermissions>664filePermissions>  
                
              
            <directoryPermissions>775directoryPermissions>  
                
              
            <configuration>configuration>  
                
        server>  
           
    servers>  
        
      
    <mirrors>  
            
          
        <mirror>  
                
              
            <id>planetmirror.comid>  
                
              
            <name>PlanetMirror Australianame>  
                
              
            <url>http://downloads.planetmirror.com/pub/maven2url>  
                
              
              
            <mirrorOf>centralmirrorOf>  
                
        mirror>  
           
    mirrors>  
        
      
      
      
      
    <profiles>  
            
          
        <profile>  
                
              
            <id>testid>  
                
              
              
              
              
            <activation>  
                    
                  
                <activeByDefault>falseactiveByDefault>  
                    
                  
                <jdk>1.8jdk>  
                    
                  
                <os>  
                        
                      
                    <name>Windows 10name>  
                        
                      
                    <family>Windowsfamily>  
                        
                      
                    <arch>x86arch>  
                        
                      
                    <version>5.1.2600version>  
                          
                os>  
                    
                  
                  
                <property>  
                        
                      
                    <name>mavenVersionname>  
                        
                      
                    <value>2.0.3value>  
                          
                property>  
                    
                  
                  
                <file>  
                        
                      
                    <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/exists>  
                        
                      
                    <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/missing>  
                          
                file>  
                     
            activation>  
                
               
              
               
              
              
              
              
              
            <properties>  
              
                  
                <user.install>usr/local/winner/jobs/maven-guideuser.install>  
                     
            properties>  
                
              
            <repositories>  
                    
                  
                <repository>  
                        
                      
                    <id>codehausSnapshotsid>  
                        
                      
                    <name>Codehaus Snapshotsname>  
                        
                      
                    <releases>  
                            
                          
                        <enabled>falseenabled>  
                            
                          
                          
                        <updatePolicy>alwaysupdatePolicy>  
                            
                          
                          
                        <checksumPolicy>warnchecksumPolicy>  
                               
                    releases>  
                        
                      
                      
                    <snapshots>  
                                
                        <enabled />  
                        <updatePolicy />  
                        <checksumPolicy />  
                               
                    snapshots>  
                        
                      
                    <url>http://snapshots.maven.codehaus.org/maven2url>  
                        
                      
                      
                    <layout>defaultlayout>  
                          
                repository>  
                     
            repositories>  
                
              
              
              
            <pluginRepositories>  
                    
                  
                <pluginRepository>  
                    <releases>  
                        <enabled />  
                        <updatePolicy />  
                        <checksumPolicy />  
                    releases>  
                           
                    <snapshots>  
                        <enabled />  
                        <updatePolicy />  
                        <checksumPolicy />  
                    snapshots>  
                           
                    <id />  
                    <name />  
                    <url />  
                    <layout />  
                pluginRepository>  
                          
            pluginRepositories>
                
        profile>  
           
    profiles>
                
      
      
      
      
    <activeProfiles>  
                      
        <activeProfile>env-testactiveProfile>  
                     
    activeProfiles>
        
settings>

三. mirrorOf 详解

    mirrorOf 可以理解“为某个仓库（repository）的做镜像”，填写的是repostoryId。* 的意思就是匹配所有的仓库（repository）。相当于一个拦截器，它会拦截maven对remote repository的相关请求，把请求里的remote repository地址，重定向到mirror里配置的地址。

在maven中配置一个mirror时，有多种形式：
1. mirrorOf=“*”  // mirror一切，你配置的repository不起作用了。
2. mirrorOf=my-repo-id // 镜像my-repo-id，你配置的my-repo-id仓库不起作用了。
3. mirrorOf=*,!my-repo-id  // !表示非运算，排除你配置的my-repo-id仓库，其他仓库都被镜像了。就是请求下载my-repo-id的仓库的jar不使用mirror的url下载，其他都是用mirror配置的url下载。
4. mirrorOf=external:*  // 如果本地库存在就用本地库的，如果本地没有，所有下载就用mirror配置的url下载。