1. 程式人生 > >maven設置------settings.xml文件學習

maven設置------settings.xml文件學習

私有 get sdn 1.5 .get 簡寫 host light cksum

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沒有發現,將沒有任何事發生。

maven設置------settings.xml文件學習