maven设置------settings.xml文件学习

https://blog.csdn.net/tomato__/article/details/13025187

快速预览

maven的配置文件为settings.xml，在下面路径中可以找到这个文件，分别为：
    ------ $M2_HOME/conf/settings.xml：全局设置，在maven的安装目录下；
    ------ ${user.home}/.m2/settings.xml：用户设置，需要用户手动添加，可以将安装目录下的settings.xml文件拷贝过来修改。
    两个文件的关系为：如果两个文件同时存在，文件内容将被融合，相同设置将以用户设置的settings.xml为准。
    该文件一共有10个配置项，文件结构为：
    <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/>
        <interactiveMode/>
        <usePluginRegistry/>
        <offline/>
        <pluginGroups/>
        <servers/>
        <mirrors/>
        <proxies/>
        <profiles/>
        <activeProfiles/>
    </settings>
 下面对每一个配置项做一个简要的讲解，帮助理解每一项的含义和配置方式，以便后面做更深入的学习：

简单属性

[html] view plain copy

[html] view plain copy

  1. <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  2. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
  4. http://maven.apache.org/xsd/settings-1.0.0.xsd">
  5. <localRepository>${user.home}/.m2/repository</localRepository>
  6. <interactiveMode>true</interactiveMode>
  7. <usePluginRegistry>false</usePluginRegistry>
  8. <offline>false</offline>
  9. ...
  10. </settings>

localRepository：本地仓库路径，默认值 ${user.home}/.m2/repository；
  interactiveMode：值为true/false，true表示mave可以使用用户输入，默认true；
  usePluginRegistry：值为true/false，true表示maven使用${user.home}/.m2/plugin-registry.xml管理插件版本，默认为false；
  offline：值为true/false，true表示构建系统在离线模式下执行，默认为false；

pluginGroups

每个pluginGroup元素都包含一个groupId，当你在命令行中没有提供插件的groupid时，将会使用该列表。这个列表自动包含org.apache.maven.plugins和org.codehaus.mojo。

[html] view plain copy

  1. <pluginGroups>
  2. <pluginGroup>org.mortbay.jetty</pluginGroup>
  3. </pluginGroups>

例如：在做了上面的配置后，直接执行如下简写形式的命令即可
  mvn jetty:run

servers

POM中的repositories和distributionManagement元素为下载和部署定义的仓库。一些设置如服务器的用户名和密码不应该和pom.xml一起分发。这种类型的信息应该存在于构建服务器上的settings.xml文件中。

[html] view plain copy

  1. <servers>
  2. <server>
  3. <id>server001</id>
  4. <username>my_login</username>
  5. <password>my_password</password>
  6. <privateKey>${user.home}/.ssh/id_dsa</privateKey>
  7. <passphrase>some_passphrase</passphrase>
  8. <filePermissions>664</filePermissions>
  9. <directoryPermissions>775</directoryPermissions>
  10. <configuration></configuration>
  11. </server>
  12. </servers>

id：服务器的id，和repository/mirror中配置的id项匹配；
  username，password：服务器的认证信息；
  privateKey，passphrase：指定一个路径到一个私有key（默认为${user.home}/.ssh/id_dsa）和一个passphrase；
  filePermissions，directoryPermissions：设置文件和文件夹访问权限，对应unix文件权限值，如：664，后者775.
  
  注意：如果你使用一个已有key登录服务器，你必须忽略<password>项，否则，key将会被忽略。

Mirrors

[html] view plain copy

  1. <mirrors>
  2. <mirror>
  3. <id>planetmirror.com</id>
  4. <name>PlanetMirror Australia</name>
  5. <url>http://downloads.planetmirror.com/pub/maven2</url>
  6. <mirrorOf>central</mirrorOf>
  7. </mirror>
  8. </mirrors>

id，name：镜像的唯一标识和用户友好的名称；
  url：镜像的url，用于代替原始仓库的url；
  mirrorof：使用镜像的仓库的id，可以使用下面匹配属性：
           ------*：匹配所有仓库id；
           ------external:*：匹配所有仓库id，除了那些使用localhost或者基于仓库的文件的仓库；
           ------多个仓库id之间用逗号分隔；
           ------!repol：表示匹配所有仓库，除了repol。
           注意：如果配置了多个仓库，首先匹配id精确匹配的镜像，否则maven使用第一个匹配的镜像。

proxies

代理服务器设置。

[html] view plain copy

  1. <proxy>
  2. <id>optional</id>
  3. <active>true</active>
  4. <protocol>http</protocol>
  5. <username>proxyuser</username>
  6. <password>proxypass</password>
  7. <host>proxy.host.net</host>
  8. <port>80</port>
  9. <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
  10. </proxy>
  id：可选，为代理服务器设置一个名称；
  active：true/false，默认true；
  protocol：代理服务器使用的协议类型；
  username：用户名；
  password：密码；
  host：主机名，或者ip；
  port：端口号；
  nonProxyHosts：不使用代理服务器的主机类型，多个主机之间用‘|‘分隔，可使用通配符，如：*.somewhere.com。

profiles

  这里的profile元素是pom.xml的profile元素的一个裁剪版本，它包含activation、repositories、pluginRepositories和properties元素。
  如果一个在settins中的profile是激活的，它的值将覆盖在一个POM或者profiles.xml文件中的任何相同id的profiles。

Activation

通过Activation来指定profile生效的环境，具体见下：

[html] view plain copy

  1. <profiles>
  2. <profile>
  3. <id>test</id>
  4. <activation>
  5. <activeByDefault>false</activeByDefault>
  6. <jdk>1.5</jdk>
  7. <os>
  8. <name>Windows XP</name>
  9. <family>Windows</family>
  10. <arch>x86</arch>
  11. <version>5.1.2600</version>
  12. </os>
  13. <property>
  14. <name>mavenVersion</name>
  15. <value>2.0.3</value>
  16. </property>
  17. <file>
  18. <exists>${basedir}/file2.properties</exists>
  19. <missing>${basedir}/file1.properties</missing>
  20. </file>
  21. </activation>
  22. ...
  23. </profile>
  24. </profiles>

activeByDefault：是否自动激活；
   jdk：jdk版本，必须达到该版本后才能执行激活；
   os：操作系统环境信息；
   property：当maven探测到一个name=value值对时，profile才被激活；
   file：文件exists或者missing可以激活该profile。

Properties

properties中的值可以在一个POM中通过${x}来使用，x比哦是一个property，以下形式在settiongs.xml文件中都可以使用：
   --env.X；表示使用一个环境变量，如：${env.PATH}表示使用PATH环境变量；
   --project.x：标识在POM中的对应元素的值，如：<project><version>1.0</version></project>可以通过${project.version}引用；
   --settings.x：在settins.xml中包含的对应元素的值，如：<settings><offline>false</offline></settings>可以通过${settings.offline}引用；
   --Java System Properties：所有java.lang.System.getProperties()获取的属性都是可用的，如：${java.home}；
   --x：在<properties/> 中或者一个扩展文件中设置的属性，如：${someVar}；
   配置方式为：

[html] view plain copy

  1. <profiles>
  2. <profile>
  3. ...
  4. <properties>
  5. <user.install>${user.home}/our-project</user.install>
  6. </properties>
  7. ...
  8. </profile>
  9. </profiles>

属性${user.install}就可以在POM中使用了。

Repositories

仓库。仓库是Maven用来填充构建系统本地仓库所使用的一组远程项目。而Maven是从本地仓库中使用其插件和依赖。不同的远程仓库可能含有不同的项目，而在某个激活的profile下，可能定义了一些仓库来搜索需要的发布版或快照版构件。

[html] view plain copy

  1. <repositories>
  2. <repository>
  3. <id>codehausSnapshots</id>
  4. <name>Codehaus Snapshots</name>
  5. <releases>
  6. <enabled>false</enabled>
  7. <updatePolicy>always</updatePolicy>
  8. <checksumPolicy>warn</checksumPolicy>
  9. </releases>
  10. <snapshots>
  11. <enabled>true</enabled>
  12. <updatePolicy>never</updatePolicy>
  13. <checksumPolicy>fail</checksumPolicy>
  14. </snapshots>
  15. <url>http://snapshots.maven.codehaus.org/maven2</url>
  16. <layout>default</layout>
  17. </repository>
  18. </repositories>

releases、snapshots：不同的版本策略，对应发布版本和快照版本；
   enabled：true/false，对应类型是否激活；
   updatePolicy：更新策略，maven将比较本地POM的时间戳（存储在仓库的maven-metadata文件中）和远端的，配置选项可以设置：always、daily（一天一次，默认），interval:x（x为一整数，单位分钟），never；
   checksumPolicy：maven部署文件到仓库时，也会部署对应的校验和文件，你可以设置：ignore，fail或者warn用于当校验和文件不存在或者检验失败时的处理策略；
   layout：上面提到的仓库大部分都遵循共同的布局，可以配置：default（默认）或者legacy（遗留）；

pluginRepositories

插件仓库。仓库是两种主要构件的家。第一种构件被用作其它构件的依赖。这是中央仓库中存储大部分构件类型。另外一种构件类型是插件。Maven插件是一种特殊类型的构件。由于这个原因，插件仓库独立于其它仓库。pluginRepositories元素的结构和repositories元素的结构类似。每个pluginRepository元素指定一个Maven可以用来寻找新插件的远程地址。

activeProfiles

[html] view plain copy

  1. <activeProfiles>
  2. <activeProfile>env-test</activeProfile>
  3. </activeProfiles>

activeProfile中间定义activeProfile的id，在这里定义的activeProfile总是被激活，不关心环境设置，如果配置的id的profile没有发现，将没有任何事发生。

原文地址：https://www.cnblogs.com/xiaohanlin/p/9005915.html

时间： 2024-10-10 10:35:52

maven设置------settings.xml文件学习的相关文章

Maven的settings.xml文件

<?xml version="1.0"?> <settings> <localRepository>D:\repository</localRepository><!--需要改成自己的maven的本地仓库地址--> <mirrors> <mirror> <id>alimaven</id> <name>aliyun maven</name> <url&

转发：分享一个快的飞起的maven的settings.xml文件

<?xml version="1.0" encoding="UTF-8"?> <settings> <!--该处需要改成自己的maven的本地仓库地址--> <localRepository>E:/Java/.m2/repository</localRepository> <mirrors> <mirror> <id>alimaven</id> <nam

Maven的settings.xml文件结构之mirrors

Maven的远程库提供大量构件,供Maven项目直接下载使用.对于一个Maven项目,如果没有特别声明,默认使用Maven的central库,url如下: http://repo.maven.apache.org/maven2/ 但是这些远程库往往需要连接互联网访问,由于访问互联网的限制或安全控制的需要,在企业内部往往需要建立对远程库的镜像,即远程库的mirror.Maven引用镜像,而不是直接引用远程库,这需要在Maven的settings.xml文件中进行设置,示例如下: <mirrors>

Maven入门2-pom.xml文件与settings.xml文件

Maven入门2-pom.xml文件与settings.xml文件 本文内容来源于官网文档部分章节,settings.xml文件:参考http://maven.apache.org/settings.html,pom.xml文件参考:http://maven.apache.org/guides/introduction/introduction-to-the-pom.html. http://maven.apache.org/pom.html:一个是POM的简单介绍,一个是详细介绍. 下面针对几

[Maven]Settings.xml文件详解

概要 settings.xml有什么用? 如果在Eclipse中使用过Maven插件,想必会有这个经验:配置settings.xml文件的路径. l  settings.xml文件是干什么的,为什么要配置它呢? 从settings.xml的文件名就可以看出,它是用来设置Maven参数的配置文件.并且,settings.xml是Maven的全局配置文件.而pom.xml文件是所在项目的局部配置. Settings.xml中包含类似本地仓储位置.修改远程仓储服务器.认证信息等配置. settings

默认的Settings.xml文件（无修改过）-Maven

此为maven首次安装后的默认Settings.xml文件. 当什么都不作修改时,默认是从Maven中央仓库进行下载,http://repo1.maven.org/maven2/ <?xml version="1.0" encoding="UTF-8"?> <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agree

一次解决idea maven settings.xml文件不生效

一直使用eclipse,在eclipse中可以手动指定global和user settings,并且settings的文件名称可以不是settings.xml,只要内容符合maven规范就行.如下: 然而今天遇到个问题的背景是:我有个jar包需要发布到中央库,而在eclipse中需要切换settings配置,稍显麻烦,我就把需要传到中央库的这个应用导入到idea里面来,使用idea上传,配置了idea的maven路径,settings(我上传到中央库的名字是settings-org.xml)之后

史上最全的maven的pom.xml文件详解

史上最全的maven的pom.xml文件详解 http://www.cnblogs.com/hafiz/p/5360195.html <project 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 h

Maven中pom.xml文件的配置

<project 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/maven-v4_0_0.xsd "> <!-- 父项目的坐标.如