Maven簡介（一）——Maven的安裝和settings.xml的配置

1       Maven的安裝

       安裝Maven之前要確定已經安裝好了jdk，并且配置好了環境變量JAVA_HOME。具體安裝步驟如下：

1.     從apache網上下載下傳maven項目的壓縮包。下載下傳位址為：http://maven.apache.org/download.html。比如現在最新的Maven版本是3.0.4，那麼我下載下傳好的安裝檔案就是apache-maven-3.0.4.zip。

2.     将下載下傳後的壓縮包解壓到Maven的安裝目錄，比如說是D:\\develop，那麼解壓後就是D:\\develop\\apache-maven-3.0.4。

3.     添加環境變量M2_HOME，其值為Maven的家目錄，如D:\\develop\\apache-maven-3.0.4。

4.     添加環境變量M2，其值将為maven安裝目錄的bin目錄，即D:\\develop\\apache-maven-3.0.4\\bin，對于windows系統也可以使用%M2_HOME%\\bin，對于linux系統也可以使用$M2_HOME/bin。

5.     将環境變量M2加入到PATH變量中，對于windows系統，可以在PATH變量的值後面加上“;%M2%”，對于linux系統，可以使用“export path=$path:$M2”

6.     還有一個可選的環境變量MAVEN_OPTS，該環境變量主要是配置Maven在使用jdk的時候指定JVM屬性的。如指定其值為“-Xms256m -Xmx512m”。

經過以上幾步之後Maven就安裝成功了。接下來我們可以在指令視窗使用mvn --version來驗證一下Maven是否安裝成功。如能正确輸出Maven的安裝版本，則表示它安裝成功了。

2       配置Maven的環境資訊

在Maven中提供了一個settings.xml檔案來定義Maven的全局環境資訊。這個檔案會存在于Maven的安裝目錄的conf子目錄下面，或者是使用者家目錄的.m2子目錄下面。我們可以通過這個檔案來定義本地倉庫、遠端倉庫和聯網使用的代理資訊等。

其實相對于多使用者的PC機而言，在Maven安裝目錄的conf子目錄下面的settings.xml才是真正的全局的配置。而使用者家目錄的.m2子目錄下面的settings.xml的配置隻是針對目前使用者的。當這兩個檔案同時存在的時候，那麼對于相同的配置資訊使用者家目錄下面的settings.xml中定義的會覆寫Maven安裝目錄下面的settings.xml中的定義。使用者家目錄下的settings.xml檔案一般是不存在的，但是Maven允許我們在這裡定義我們自己的settings.xml，如果需要在這裡定義我們自己的settings.xml的時候就可以把Maven安裝目錄下面的settings.xml檔案拷貝到使用者家目錄的.m2目錄下，然後改成自己想要的樣子。

先來看一個基本的settings.xml的樣子：

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>D:\\develop\\mavenRepository</localRepository>  
      <interactiveMode>true</interactiveMode>  
      <offline>false</offline>  
      <pluginGroups>  
       
      </pluginGroups>  
       
      <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>  
       
      <servers>  
        <server>  
          <id>deploymentRepo</id>  
          <username>repouser</username>  
          <password>repopwd</password>  
        </server>  
      </servers>  
       
      <mirrors>  
        <mirror>  
          <id>mirrorId</id>  
          <mirrorOf>repositoryId</mirrorOf>  
          <name>Human Readable Name for this Mirror.</name>  
          <url>http://my.repository.com/repo/path</url>  
        </mirror>  
      </mirrors>  
       
      <profiles>  
        <profile>  
          <id>jdk-1.5</id>  
          <activation>  
            <jdk>1.5</jdk>  
          </activation>  
          <repositories>  
            <repository>  
              <id>jdk15</id>  
              <name>jdk1.5</name>  
              <url>http://www.myhost.com/maven/jdk15</url>  
              <layout>default</layout>  
              <snapshotPolicy>always</snapshotPolicy>  
            </repository>  
          </repositories>  
        </profile>  
      </profiles>  
      <activeProfiles>  
        <activeProfile>jdk-1.5</activeProfile>  
      </activeProfiles>  
    </settings>  
           

settings.xml中主要包括以下元素：

localRepository：表示Maven用來在本地儲存資訊的本地倉庫的目錄。預設是使用者家目錄下面的.m2/repository目錄。

interactiveMode：表示是否使用互動模式，預設是true；如果設為false，那麼當Maven需要使用者進行輸入的時候，它會使用一個預設值。

offline：表示是否離線，預設是false。這個屬性表示在Maven進行項目編譯和部署等操作時是否允許Maven進行聯網來下載下傳所需要的資訊。

pluginGroups：在pluginGroups元素下面可以定義一系列的pluginGroup元素。表示當通過plugin的字首來解析plugin的時候到哪裡尋找。pluginGroup元素指定的是plugin的groupId。預設情況下，Maven會自動把org.apache.maven.plugins和org.codehaus.mojo添加到pluginGroups下。

proxies：其下面可以定義一系列的proxy子元素，表示Maven在進行聯網時需要使用到的代理。當設定了多個代理的時候第一個标記active為true的代理将會被使用。下面是一個使用代理的例子：

Xml代碼  收藏代碼

<proxies>  
      <proxy>  
          <id>xxx</id>  
          <active>true</active>  
          <protocol>http</protocol>  
          <username>使用者名</username>  
          <password>密碼</password>  
          <host>代理伺服器位址</host>  
          <port>代理伺服器的端口</port>  
          <nonProxyHosts>不使用代理的主機</nonProxyHosts>  
      </proxy>  
    </proxies>  
           

servers：其下面可以定義一系列的server子元素，表示當需要連接配接到一個遠端伺服器的時候需要使用到的驗證方式。這主要有username/password和privateKey/passphrase這兩種方式。以下是一個使用servers的示例：

Xml代碼  收藏代碼

<servers>  
      <server>  
        <id>id</id>  
        <username>使用者名</username>  
        <password>密碼</password>  
      </server>  
    </servers>  
           

mirrors：用于定義一系列的遠端倉庫的鏡像。我們可以在pom中定義一個下載下傳工件的時候所使用的遠端倉庫。但是有時候這個遠端倉庫會比較忙，是以這個時候人們就想着給它建立鏡像以緩解遠端倉庫的壓力，也就是說會把對遠端倉庫的請求轉換到對其鏡像位址的請求。每個遠端倉庫都會有一個id，這樣我們就可以建立自己的mirror來關聯到該倉庫，那麼以後需要從遠端倉庫下載下傳工件的時候Maven就可以從我們定義好的mirror站點來下載下傳，這可以很好的緩解我們遠端倉庫的壓力。在我們定義的mirror中每個遠端倉庫都隻能有一個mirror與它關聯，也就是說你不能同時配置多個mirror的mirrorOf指向同一個repositoryId。

看以下是一個使用mirrors的例子：

Xml代碼  收藏代碼

<mirrors>  
        <mirror>  
          <id>mirrorId</id>  
          <mirrorOf>repositoryId</mirrorOf>  
          <name>定義一個容易看懂的名稱 </name>  
          <url>http://my.repository.com/repo/path</url>  
        </mirror>  
    </mirrors>  
           

l  id：是用來差別mirror的，所有的mirror不能有相同的id

l  mirrorOf：用來表示該mirror是關聯的哪一個倉庫，其值為其關聯倉庫的id。當要同時關聯多個倉庫時，這多個倉庫之間可以用逗号隔開；當要關聯所有的倉庫時，可以使用“*”表示；當要關聯除某一個倉庫以外的其他所有倉庫時，可以表示為“*,!repositoryId”；當要關聯不是localhost或用file請求的倉庫時，可以表示為“external:*”。

l  url：表示該鏡像的url。當Maven在建立系統的時候就會使用這個url來連接配接到我們的遠端倉庫。

profiles：用于指定一系列的profile。profile元素由activation、repositories、pluginRepositories和properties四個元素組成。當一個profile在settings.xml中是處于活動狀态并且在pom.xml中定義了一個相同id的profile時，settings.xml中的profile會覆寫pom.xml中的profile。

（1）activation：這是profile中最重要的元素。跟pom.xml中的profile一樣，settings.xml中的profile也可以在特定環境下改變一些值，而這些環境是通過activation元素來指定的。

       看下面一個例子：

Xml代碼  收藏代碼

<profiles>  
      <profile>  
        <id>test</id>  
        <activation>  
          <activeByDefault>false</activeByDefault>  
          <jdk>1.6</jdk>  
          <os>  
            <name>Windows 7</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>  
           

       在上面這段代碼中，當所有的限制條件都滿足的時候就會激活這個profile。

l  jdk：表示當jdk的版本滿足條件的時候激活，在這裡是1.6。這裡的版本還可以用一個範圍來表示，如

<jdk>[1.4,1.7)</jdk>表示1.4、1.5和1.6滿足；

<jdk>[1.4,1.7]</jdk>表示1.4、1.5、1.6和1.7滿足；

l  os：表示當作業系統滿足條件的時候激活。

l  property：property是鍵值對的形式，表示當Maven檢測到了這樣一個鍵值對的時候就激活該profile。

(1)下面的示例表示當存在屬性hello的時候激活該profile。

Xml代碼  收藏代碼

<property>  
           <name>hello</name>  
    </property>
           

(2)下面的示例表示當屬性hello的值為world的時候激活該profile。

Xml代碼  收藏代碼

<property>  
           <name>hello</name>  
           <value>world</value>  
    </property> 
           

這個時候如果要激活該profile的話，可以在調用Maven指令的時候加上參數hello并指定其值為world，如：

mvn compile –Dhello=world

l  file：表示當檔案存在或不存在的時候激活，exists表示存在，missing表示不存在。如下面的例子表示當檔案hello/world不存在的時候激活該profile。

Xml代碼  收藏代碼

<profile>  
           <activation>  
                  <file>  
                         <missing>hello/world</missing>  
                  </file>  
           </activation>  
    </profile>  
           

l  activeByDefault：當其值為true的時候表示如果沒有其他的profile處于激活狀态的時候，該profile将自動被激活。

（2）properties：用于定義屬性鍵值對的。當該profile是激活狀态的時候，properties下面指定的屬性都可以在pom.xml中使用。

（3）repositories：用于定義遠端倉庫的，當該profile是激活狀态的時候，這裡面定義的遠端倉庫将作為目前pom的遠端倉庫。

Xml代碼  收藏代碼

<repositories>  
      <repository>  
        <id>codehausSnapshots</id>  
        <name>Codehaus Snapshots</name>  
        <releases>  
          <enabled>false</enabled>  
          <updatePolicy>always</updatePolicy>  
          <checksumPolicy>warn</checksumPolicy>  
        </releases>  
        <snapshots>  
          <enabled>true</enabled>  
          <updatePolicy>never</updatePolicy>  
          <checksumPolicy>fail</checksumPolicy>  
        </snapshots>  
        <url>http://snapshots.maven.codehaus.org/maven2</url>  
        <layout>default</layout>  
      </repository>  
    </repositories>  
           

l  releases、snapshots：這是對于工件的類型的限制。

l  enabled：表示這個倉庫是否允許這種類型的工件

l  updatePolicy：表示多久嘗試更新一次。可選值有always、daily、interval:minutes（表示每多久更新一次）和never。

l  checksumPolicy：當Maven在部署項目到倉庫的時候會連同校驗檔案一起送出，checksumPolicy表示當這個校驗檔案缺失或不正确的時候該如何處理，可選項有ignore、fail和warn。

（4）pluginRepositories：在Maven中有兩種類型的倉庫，一種是存儲工件的倉庫，另一種就是存儲plugin插件的倉庫。pluginRepositories的定義和repositories的定義類似，它表示Maven在哪些地方可以找到所需要的插件。

activeProfiles：底包含一系列的activeProfile元素，表示對于所有的pom都處于活躍狀态的profile。如：

Xml代碼  收藏代碼

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