詳解Maven用戶的配置settings.xml

Maven用戶設置

 

做者其餘技術文章

1）Oracle性能優化之查詢語句通用原則  

2）Redis經常使用命令

3) SpringCloud入門之經常使用的配置文件 application.yml和 bootstrap.yml區別

4）#ifndef、#def、#endif說明

這是一份Maven的特定於用戶的配置的參考。

包括不該與pom.xml文件一塊兒分發的內容，例如開發人員身份，以及本地設置，如代理信息。

設置文件的默認位置是〜/ .m2 / settings.xml

1. <settings xmlns="http://maven.apache.org/SETTINGS/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
2. xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd">
3. <localRepository/>
4. <interactiveMode/>
5. <usePluginRegistry/>
6. <offline/>
8. <proxies>
9. <proxy>
10. <active/>
11. <protocol/>
12. <username/>
13. <password/>
14. <port/>
15. <host/>
16. <nonProxyHosts/>
17. <id/>
18. </proxy>
19. </proxies>
21. <servers>
22. <server>
23. <username/>
24. <password/>
25. <privateKey/>
26. <passphrase/>
27. <filePermissions/>
28. <directoryPermissions/>
29. <configuration/>
30. <id/>
31. </server>
32. </servers>
34. <mirrors>
35. <mirror>
36. <mirrorOf/>
37. <name/>
38. <url/>
39. <layout/>
40. <mirrorOfLayouts/>
41. <id/>
42. </mirror>
43. </mirrors>
45. <profiles>
46. <profile>
47. <activation>
48. <activeByDefault/>
49. <jdk/>
50. <os>
51. <name/>
52. <family/>
53. <arch/>
54. <version/>
55. </os>
56. <property>
57. <name/>
58. <value/>
59. </property>
60. <file>
61. <missing/>
62. <exists/>
63. </file>
64. </activation>
65. <properties>
66. <key>value</key>
67. </properties>
69. <repositories>
70. <repository>
71. <releases>
72. <enabled/>
73. <updatePolicy/>
74. <checksumPolicy/>
75. </releases>
76. <snapshots>
77. <enabled/>
78. <updatePolicy/>
79. <checksumPolicy/>
80. </snapshots>
81. <id/>
82. <name/>
83. <url/>
84. <layout/>
85. </repository>
86. </repositories>
87. <pluginRepositories>
88. <pluginRepository>
89. <releases>
90. <enabled/>
91. <updatePolicy/>
92. <checksumPolicy/>
93. </releases>
94. <snapshots>
95. <enabled/>
96. <updatePolicy/>
97. <checksumPolicy/>
98. </snapshots>
99. <id/>
100. <name/>
101. <url/>
102. <layout/>
103. </pluginRepository>
104. </pluginRepositories>
105. <id/>
106. </profile>
107. </profiles>
109. <activeProfiles/>
110. <pluginGroups/>
111. </settings>

 

settings-Maven的用戶配置文件settings.xml的根元素。

Element	Type	Description
localRepository	String	Maven本地存儲庫。 默認值爲： $ {user.home} /.m2 / repository
interactiveMode	boolean	Maven是否應該嘗試與用戶進行交互以進行輸入。 默認值爲：true。
usePluginRegistry	boolean	Maven是否應該使用plugin-registry.xml文件來管理插件版本。 默認值爲：false。
offline	boolean	指示maven是否應該在離線模式下運行。 默認值爲：false。
proxies/proxy*	List<Proxy>	（多個）配置不一樣的代理配置文件。對於使用筆記本電腦或其餘移動平臺工做的任何人來講，多個代理配置文件可能會派上用場，只需從命令行或從下面的默認部分指定配置文件ID，便可輕鬆切換整個代理配置。
servers/server*	List<Server>	（不少）Maven配置服務器特定的設置，主要是身份驗證方法。這容許基於每一個服務器配置身份驗證。
mirrors/mirror*	List<Mirror>	（不少）Maven配置存儲庫的下載鏡像。
profiles/profile*	List<Profile>	（許多）Maven構建配置文件的配置，用於根據環境參數調整構建。
activeProfiles/activeProfile*	List<String>	（多個）Maven手動激活的構建配置文件列表，按照應用順序指定。
pluginGroups/pluginGroup*	List<String>	（不少）Maven當沒有明確提供插件groupId時，要搜索插件的groupId列表。

 

proxy

Maven的用戶配置文件settings.xml的<proxy>元素包含代理設置所需的信息。

Element	Type	Description
active	boolean	Maven此代理配置是否爲活動配置。 默認值爲：true。
protocol	String	Maven代理協議。 默認值爲：http。
username	String	Maven代理用戶。
password	String	Maven代理密碼。
port	int	Maven代理端口。 默認值爲：8080。
host	String	Maven代理主機。
nonProxyHosts	String	Maven非代理主機列表（由|分隔）。
id	String	沒有說明。 Maven默認值爲：default。

 

server

Maven的用戶配置文件settings.xml的<server>元素包含服務器設置所需的信息。

Element	Type	Description
username	String	Maven用於驗證的用戶名。
password	String	與用戶名一塊兒使用的密碼進行身份驗證。
privateKey	String	Maven用於進行身份驗證的私鑰位置。
passphrase	String	Maven密碼與privateKey一塊兒使用以進行身份驗證。
filePermissions	String	Maven文件建立時的權限。
directoryPermissions	String	Maven建立目錄時的目錄權限。
configuration	DOM	Maven傳輸層的額外配置。
ID	String	沒有說明。 Maven默認值爲：default。

mirror

 

Maven的用戶配置文件settings.xml的<mirror>,存儲庫的下載鏡像配置。

Element	Type	Description
mirrorOf	String	Maven鏡像存儲庫的服務器ID，例如「central」。這必須與鏡像id不匹配。
name	String	Maven描述鏡像的可選名稱。
url	String	Maven鏡像存儲庫的URL。
layout	String	Maven鏡像存儲庫的佈局。因爲Maven 3.  默認值爲：default。
mirrorOfLayouts	String	Maven存儲庫的佈局是鏡像的。此值可用於將鏡像的使用限制爲具備匹配佈局的存儲庫（除了匹配的ID）。自Maven 3.  默認值爲：default，legacy。
id	String	沒有說明。 Maven默認值爲：default。

profile

 

Maven的用戶配置文件settings.xml的<profile>,構建過程的定義，該過程以某種環境參數爲基礎。

Element	Type	Description
activation	Activation	Maven條件邏輯將自動觸發包含此配置文件。
properties/key=value*	Properties	（不少）Maven特定於此配置文件的擴展配置在這裏。內容採用 <property.name> property.value </property.name>的形式
repositories/repository*	List<Repository>	（不少）Maven遠程存儲庫的列表。
pluginRepositories/pluginRepository*	List<Repository>	（不少）Maven用於發現插件的遠程存儲庫列表。
id	String	沒有說明。 Maven默認值爲：default。

activation

 

Maven的用戶配置文件settings.xml的<activation>,構建運行時環境條件將觸發自動包含父構建概要文件。

Element	Type	Description
activeByDefault	boolean	Maven標記此配置文件是否做爲默認值處於活動狀態。 默認值爲：false。
jdk	String	Maven指定在檢測到匹配的JDK時將激活此配置文件。
os	ActivationOS	Maven指定在檢測到匹配的OS屬性時將激活此配置文件。
property	ActivationProperty	Maven指定在指定此System屬性時將激活此配置文件。
file	ActivationFile	Maven指定將根據文件的存在激活此配置文件。

os

 

Maven的用戶配置文件settings.xml的<OS>,這是一個激活配置，它將檢測操做系統的屬性以激活其配置文件。

Element	Type	Description
name	String	Maven用於激活配置文件的OS的名稱。
family	String	Maven用於激活配置文件的OS的通常系列（例如'windows'）
arch	String	Maven用於激活配置文件的OS的體系結構。
version	String	Maven用於激活配置文件的OS版本。

property

 

Maven的用戶配置文件settings.xml的<Property>,這是用於激活配置文件的屬性規範。若是value字段爲空，則named屬性的存在將激活配置文件，不然它也會對屬性值進行區分大小寫的匹配。

Element	Type	Description
name	String	Maven用於激活配置文件的屬性的名稱。
Value	String	Maven用於激活配置文件的屬性的值。

file

 

Maven的用戶配置文件settings.xml的<file>,這是用於激活配置文件的文件規範。默認值將是須要存在的文件的位置，若是不存在，則必須運行該配置文件。另外一方面，exists將測試文件是否存在，若是存在則將運行配置文件。

Element	Type	Description
missing	String	Maven激活配置文件時應該缺乏的文件名。
exists	String	Maven激活配置文件時應存在的文件的名稱。

repository

 

Maven的用戶配置文件settings.xml的<repository>,存儲庫包含與遠程存儲庫創建鏈接所需的信息

Element	Type	Description
releases	RepositoryPolicy	Maven如何處理今後存儲庫下載的版本
snapshots	RepositoryPolicy	Maven如何處理今後存儲庫下載快照
id	String	Maven存儲庫的惟一標識符。
name	String	Maven友好可讀的存儲庫名稱。
url	String	Maven存儲庫的URL。
layout	String	Maven此存儲庫用於定位和存儲工件的佈局類型 - 能夠是「遺留」或「默認」。 默認值爲：default。

 

releases

 

Maven的用戶配置文件settings.xml的<releases>,下載策略

Element	Type	Description
enabled	boolean	Maven是否使用此存儲庫下載此類工件。 默認值爲：true。
updatePolicy	String	Maven下載更新的頻率 - 能夠是「始終」，「天天」（默認），「間隔：XXX」（以分鐘爲單位）或「從不」（僅當它本地不存在時）。
checksumPolicy	String	Maven驗證工件校驗和失敗時該怎麼辦 - 警告，失敗等。有效值爲「失敗」或「警告」。

snapshots

 

Maven的用戶配置文件settings.xml的<snapshots>,下載策略

Element	Type	Description
enabled	boolean	Maven是否使用此存儲庫下載此類工件。 默認值爲：true。
updatePolicy	String	Maven下載更新的頻率 - 能夠是「始終」，「天天」（默認），「間隔：XXX」（以分鐘爲單位）或「從不」（僅當它本地不存在時）。
checksumPolicy	String	Maven驗證工件校驗和失敗時該怎麼辦 - 警告，失敗等。有效值爲「失敗」或「警告」。

pluginRepository

 

Maven的用戶配置文件settings.xml的<pluginRepository>,存儲庫包含與遠程存儲庫創建鏈接所需的信息

 

Element	Type	Description
Element	Type	Maven如何處理今後存儲庫下載的版本
releases	RepositoryPolicy	Maven如何處理今後存儲庫下載快照
snapshots	RepositoryPolicy	Maven存儲庫的惟一標識符。
id	String	人類可讀的存儲庫名稱。
name	String	Maven存儲庫的URL。
url	String	Maven此存儲庫用於定位和存儲工件的佈局類型 - 能夠是「遺留」或「默認」。 默認值爲：default。

 

分類:  java, SpringCloud