maven的setting.xml文件的詳解

轉自:http://www.cnblogs.com/sxdcgaq8080/p/5588070.html

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的樣子:

 

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
 3           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4           xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
 5                
 6   <localRepository>D:\\develop\\mavenRepository</localRepository>
 7   <interactiveMode>true</interactiveMode>
 8   <offline>false</offline>
 9   <pluginGroups>
10  
11   </pluginGroups>
12  
13   <proxies>
14     <proxy>
15       <id>optional</id>
16       <active>true</active>
17       <protocol>http</protocol>
18       <username>proxyuser</username>
19       <password>proxypass</password>
20       <host>proxy.host.net</host>
21       <port>80</port>
22       <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
23     </proxy>
24   </proxies>
25  
26   <servers>
27     <server>
28       <id>deploymentRepo</id>
29       <username>repouser</username>
30       <password>repopwd</password>
31     </server>
32   </servers>
33  
34   <mirrors>
35     <mirror>
36       <id>mirrorId</id>
37       <mirrorOf>repositoryId</mirrorOf>
38       <name>Human Readable Name for this Mirror.</name>
39       <url>http://my.repository.com/repo/path</url>
40     </mirror>
41   </mirrors>
42  
43   <profiles>
44     <profile>
45       <id>jdk-1.5</id>
46       <activation>
47         <jdk>1.5</jdk>
48       </activation>
49       <repositories>
50         <repository>
51           <id>jdk15</id>
52           <name>jdk1.5</name>
53           <url>http://www.myhost.com/maven/jdk15</url>
54           <layout>default</layout>
55           <snapshotPolicy>always</snapshotPolicy>
56         </repository>
57       </repositories>
58     </profile>
59   </profiles>
60   <activeProfiles>
61     <activeProfile>jdk-1.5</activeProfile>
62   </activeProfiles>
63 </settings>
View Code

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的代理將會被使用。下面是一個使用代理的例子:

 

 1 <proxies>
 2   <proxy>
 3       <id>xxx</id>
 4       <active>true</active>
 5       <protocol>http</protocol>
 6       <username>用戶名</username>
 7       <password>密碼</password>
 8       <host>代理服務器地址</host>
 9       <port>代理服務器的端口</port>
10       <nonProxyHosts>不使用代理的主機</nonProxyHosts>
11   </proxy>
12 </proxies>
View Code

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

1   <servers>
2     <server>
3       <id>id</id>
4       <username>用戶名</username>
5       <password>密碼</password>
6     </server>
7   </servers>
View Code

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

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

1 <mirrors>
2     <mirror>
3       <id>mirrorId</id>
4       <mirrorOf>repositoryId</mirrorOf>
5       <name>定義一個容易看懂的名稱 </name>
6       <url>http://my.repository.com/repo/path</url>
7     </mirror>
8 </mirrors>
View Code

1》  id:是用來區別mirror的,所有的mirror不能有相同的id

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

3》 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元素來指定的。

       看下面一個例子:

 1   <profiles>
 2     <profile>
 3       <id>test</id>
 4       <activation>
 5         <activeByDefault>false</activeByDefault>
 6         <jdk>1.6</jdk>
 7         <os>
 8           <name>Windows 7</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>
View Code

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

1》  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滿足;

2》  os:表示當操作系統滿足條件的時候激活。

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

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

1 <property>
2        <name>hello</name>
3 </property>
View Code

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

1 <property>
2        <name>hello</name>
3        <value>world</value>
4 </property>
View Code

這個時候如果要激活該profile的話,可以在調用Maven指令的時候加上參數hello並指定其值爲world,如:

mvn compile –Dhello=world

1》  file:表示當文件存在或不存在的時候激活,exists表示存在,missing表示不存在。如下面的例子表示當文件hello/world不存在的時候激活該profile。

1 <profile>
2        <activation>
3               <file>
4                      <missing>hello/world</missing>
5               </file>
6        </activation>
7 </profile>
View Code

 

2》  activeByDefault:當其值爲true的時候表示如果沒有其他的profile處於激活狀態的時候,該profile將自動被激活。

(2)properties:用於定義屬性鍵值對的。當該profile是激活狀態的時候,properties下面指定的屬性都可以在pom.xml中使用。

(3)repositories:用於定義遠程倉庫的,當該profile是激活狀態的時候,這裏面定義的遠程倉庫將作爲當前pom的遠程倉庫。

 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>
View Code

1》  releases、snapshots:這是對於工件的類型的限制。

2》  enabled:表示這個倉庫是否允許這種類型的工件

3》  updatePolicy:表示多久嘗試更新一次。可選值有always、daily、interval:minutes(表示每多久更新一次)和never。

4》  checksumPolicy:當Maven在部署項目到倉庫的時候會連同校驗文件一起提交,checksumPolicy表示當這個校驗文件缺失或不正確的時候該如何處理,可選項有ignore、fail和warn。

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

activeProfiles:底包含一系列的activeProfile元素,表示對於所有的pom都處於活躍狀態的profile。如:

1   <activeProfiles>
2     <activeProfile>alwaysActiveProfile</activeProfile>
3     <activeProfile>anotherAlwaysActiveProfile</activeProfile>
4   </activeProfiles>
View Code
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章