Maven讲解之 setting.xml

Maven讲解之 setting.xml

通常我们安装了Maven之后会对Maven setting.xml(Maven的配置文件做一些自定义)，本章我们将详细地学习一下Maven setting.xml文件。

• 文件位置
  一般存在与Maven安装的 Root File Path 的conf文件夹下：
  e.g.：
  

• setting.xml 概览

  <?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/>
      <interactiveMode/>
      <offline/>
      <pluginGroups/>
      <servers/>
      <mirrors/>
      <proxies/>
      <profiles/>
      <activeProfiles/>
  </settings>

localRepository(Maven仓库)

Maven repository 用于存放项目中应用的jar包,通常我们有一下两种做法设置Maven的仓库。

• 出厂默认设置
  即不配置Maven Repository的任何信息，默认使用 ${user.home}/.m2/repository/setting.xml

• 自定义仓库

  <localRepository>E:\WorkSpace\IDEs\Maven\MavenRepository</localRepository>

interactiveMode

interactiveMode 用于决定maven是否在需要输出的时候提示你，默认true。如果是false，它将使用合理的默认值，或者基于一些设置。

offline

决定maven是否在构建的时候进行网络传输。 默认false，表示联网状态，true为取消联网。 在某些情况下设置为true是很有用的，比如jar无法从网上下载等。

pluginGroups
Maven组件，默认使用的是 org.apache.maven.plugins所有组件。在Maven 管理项目的生命周期时会用到plugin。一下为Maven常用的plugins

• Default：默认使用Maven的插件。建议
• Customized：自定义使用插件。不建议
  
  • <pluginGroup>com.your.plugins</pluginGroup>

proxies

此项用于设置http代理 有时候由于安全问题，需要配置http代理，通过代理服务才能正常访问外部仓库下载资源可以ping repo1.maven.org来访问中央仓库 telnet 218.14.227.197 3128 来查看代理地址以及端口是否畅通

<proxies>
    <proxy>
      <id>optional</id>
      <active>true</active>
      <protocol>http</protocol><!--代理协议-->
      <username>proxyuser</username>
      <password>proxypass</password>
      <host>proxy.host.net</host>
      <port>80</port>
     <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
    </proxy>
  </proxies>

• id：proxy的唯一标识，用来区别proxy元素。
• active：表示是否激活代理，如果配置多个，默认是第一个生效
• username，password：提供连接代理服务器时的认证。
• host，port：主机地址，端口号

• nonProxyHosts：用来表示哪些主机名不需要代理，可以用|来分 割多个，此外也支持通配符，
  如：*.goole.com表示所有以goole.com结尾的都不需要通过代理

• Default：

• Customized：使用的不同的protocol 获取资源，可以配置多个proxy，顺序加载读取。

servers

这是一个认证配置的列表,根据系统中使用的server-id控制。认证配置在maven连接到远程服务时使用。

  <servers>
     | Specifies the authentication information to use when connecting to a particular server, identified by
     | a unique name within the system (referred to by the 'id' attribute below).
     |
     | NOTE: You should either specify username/password OR privateKey/passphrase, since these pairings are
     |       used together.
     |

    <server>
      <id>deploymentRepo</id>
      <username>repouser</username>
      <password>repopwd</password>
    </server>
    <!-- Another sample, using keys to authenticate.
    <server>
      <id>siteServer</id>
      <privateKey>/path/to/private/key</privateKey>
      <passphrase>optional; leave empty if not used.</passphrase>
    </server>
  </servers>

可以配置多个Server 顺序读取。

mirrors

指定镜像仓库位置用于从远程仓库下载资源

  <mirrors>
  <mirror>
        <id>nexus-aliyun</id>
        <mirrorOf>*,!jeecg,!jeecg-snapshots</mirrorOf>
        <name>Nexus aliyun</name>
        <url>http://maven.aliyun.com/nexus/content/groups/public</url>
    </mirror>
   <mirrors>
  </mirrors>

这里已Ali的镜像为例，可以配置多个镜像，顺序读取。

profiles

• settings.xml中时意味着该profile是全局的，所以只能配置范围宽泛一点配置信息，比如远程仓库等。而一些比较细致一点的需要定义在项目的pom.xml中。

• profile可以让我们定义一系列的配置信息，然后指定其激活条件。 根据每个profile对应不同的激活条件和配置信息，从而达到不同环境使用不同配置。

• 例子：通过profile定义jdk1.5以上使用一套配置，jdk1.5以下使用另外一套配置；或者通过操作系统来使用不同的配置信息。

• settings.xml中的信息有repositories、pluginRepositories和properties。定义在properties的值可以在pom.xml中使用。

<profiles>
    <profile>
              <id>test</id>
              <activation>
                 <activeByDefault>false</activeByDefault>
                 <jdk>1.5</jdk>
                 <os>
                     <name>Windows XP</name>
                     <family>Windows</family>
                     <arch>x86</arch>
                     <version>5.1.2600</version>
                 </os>
                 <property>
                     <name>mavenVersion</name>
                     <value>2.0.3</value>
                 </property>
                 <file>
                <exists>${basedir}/file2.properties</exists>
               <missing>${basedir}/file1.properties</missing>
                </file>
             </activation>
         </profile>
</profiles>

• jdk：检测到对应jdk版本就激活
• os：针对不同操作系统
• property：当maven检测到property（pom中如${name}这样的）profile将被激活
• file：如果存在文件，激活，不存在文件激活

通过以下命令查看哪些profile将生效
- mvn help:active-profiles

activeProfiles

每个activeProfile元素对应一个profile id的值，任何profile id被定义到activeProfile的profile将被激活。

<activeProfiles>
    <activeProfile>alwaysActiveProfile</activeProfile>
    <activeProfile>anotherAlwaysActiveProfile</activeProfile>
</activeProfiles>