setting.xml主要用於配置maven的運行環境等一系列通用的屬性,是全局級別的配置文件;而pom.xml主要描述了項目的maven坐標,依賴關系,開發者需要遵循的規則,缺陷管理系統,組織和licenses,以及其他所有的項目相關因素,是項目級別的配置文件。
基礎配置
一個典型的pom.xml文件配置如下:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0http://maven.apache.org/xsd/maven-4.0.0.xsd"> <!-- 模型版本。maven2.0必須是這樣寫,現在是maven2唯一支持的版本 --> <modelVersion>4.0.0</modelVersion> <!-- 公司或者組織的唯一標志,並且配置時生成的路徑也是由此生成, 如com.winner.trade,maven會將該項目打成的jar包放本地路徑:/com/winner/trade --> <groupId>com.winner.trade</groupId> <!-- 本項目的唯一ID,一個groupId下面可能多個項目,就是靠artifactId來區分的 --> <artifactId>trade-core</artifactId> <!-- 本項目目前所處的版本號 --> <version>1.0.0-SNAPSHOT</version> <!-- 打包的機制,如pom,jar, maven-plugin, ejb, war, ear, rar, par,默認為jar --> <packaging>jar</packaging> <!-- 幫助定義構件輸出的一些附屬構件,附屬構件與主構件對應,有時候需要加上classifier才能唯一的確定該構件 不能直接定義項目的classifer,因為附屬構件不是項目直接默認生成的,而是由附加的插件幫助生成的 --> <classifier>...</classifier> <!-- 定義本項目的依賴關系 --> <dependencies> <!-- 每個dependency都對應這一個jar包 --> <dependency> <!--一般情況下,maven是通過groupId、artifactId、version這三個元素值(俗稱坐標)來檢索該構件, 然后引入你的工程。如果別人想引用你現在開發的這個項目(前提是已開發完畢並發布到了遠程倉庫),--> <!--就需要在他的pom文件中新建一個dependency節點,將本項目的groupId、artifactId、version寫入, maven就會把你上傳的jar包下載到他的本地 --> <groupId>com.winner.trade</groupId> <artifactId>trade-test</artifactId> <version>1.0.0-SNAPSHOT</version> <!-- maven認為,程序對外部的依賴會隨着程序的所處階段和應用場景而變化,所以maven中的依賴關系有作用域(scope)的限制。 --> <!--scope包含如下的取值:compile(編譯范圍)、provided(已提供范圍)、runtime(運行時范圍)、test(測試范圍)、system(系統范圍) --> <scope>test</scope> <!-- 設置指依賴是否可選,默認為false,即子項目默認都繼承:為true,則子項目必需顯示的引入,與dependencyManagement里定義的依賴類似 --> <optional>false</optional> <!-- 屏蔽依賴關系。 比如項目中使用的libA依賴某個庫的1.0版,libB依賴某個庫的2.0版,現在想統一使用2.0版,就應該屏蔽掉對1.0版的依賴 --> <exclusions> <exclusion> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> </exclusion> </exclusions> </dependency> </dependencies> <!-- 為pom定義一些常量,在pom中的其它地方可以直接引用 使用方式 如下 :${file.encoding} --> <properties> <file.encoding>UTF-8</file.encoding> <java.source.version>1.5</java.source.version> <java.target.version>1.5</java.target.version> </properties> ... </project>
構建配置
<build>
<!-- 產生的構件的文件名,默認值是${artifactId}-${version}。 -->
<finalName>myPorjectName</finalName>
<!-- 構建產生的所有文件存放的目錄,默認為${basedir}/target,即項目根目錄下的target -->
<directory>${basedir}/target</directory>
<!--當項目沒有規定目標(Maven2叫做階段(phase))時的默認值, -->
<!--必須跟命令行上的參數相同例如jar:jar,或者與某個階段(phase)相同例如install、compile等 -->
<defaultGoal>install</defaultGoal>
<!--當filtering開關打開時,使用到的過濾器屬性文件列表。 -->
<!--項目配置信息中諸如${spring.version}之類的占位符會被屬性文件中的實際值替換掉 -->
<filters>
<filter>../filter.properties</filter>
</filters>
<!--項目相關的所有資源路徑列表,例如和項目相關的配置文件、屬性文件,這些資源被包含在最終的打包文件里。 -->
<resources>
<resource>
<!--描述了資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。 -->
<!--舉個例子,如果你想資源在特定的包里(org.apache.maven.messages),你就必須該元素設置為org/apache/maven/messages。 -->
<!--然而,如果你只是想把資源放到源碼目錄結構里,就不需要該配置。 -->
<targetPath>resources</targetPath>
<!--是否使用參數值代替參數名。參數值取自properties元素或者文件里配置的屬性,文件在filters元素里列出。 -->
<filtering>true</filtering>
<!--描述存放資源的目錄,該路徑相對POM路徑 -->
<directory>src/main/resources</directory>
<!--包含的模式列表 -->
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<!--排除的模式列表 如果<include>與<exclude>划定的范圍存在沖突,以<exclude>為准 -->
<excludes>
<exclude>jdbc.properties</exclude>
</excludes>
</resource>
</resources>
<!--單元測試相關的所有資源路徑,配制方法與resources類似 -->
<testResources>
<testResource>
<targetPath />
<filtering />
<directory />
<includes />
<excludes />
</testResource>
</testResources>
<!--項目源碼目錄,當構建項目的時候,構建系統會編譯目錄里的源碼。該路徑是相對於pom.xml的相對路徑。 -->
<sourceDirectory>${basedir}\src\main\java</sourceDirectory>
<!--項目腳本源碼目錄,該目錄和源碼目錄不同, <!-- 絕大多數情況下,該目錄下的內容會被拷貝到輸出目錄(因為腳本是被解釋的,而不是被編譯的)。 -->
<scriptSourceDirectory>${basedir}\src\main\scripts
</scriptSourceDirectory>
<!--項目單元測試使用的源碼目錄,當測試項目的時候,構建系統會編譯目錄里的源碼。該路徑是相對於pom.xml的相對路徑。 -->
<testSourceDirectory>${basedir}\src\test\java</testSourceDirectory>
<!--被編譯過的應用程序class文件存放的目錄。 -->
<outputDirectory>${basedir}\target\classes</outputDirectory>
<!--被編譯過的測試class文件存放的目錄。 -->
<testOutputDirectory>${basedir}\target\test-classes
</testOutputDirectory>
<!--項目的一系列構建擴展,它們是一系列build過程中要使用的產品,會包含在running bulid‘s classpath里面。 -->
<!--他們可以開啟extensions,也可以通過提供條件來激活plugins。 -->
<!--簡單來講,extensions是在build過程被激活的產品 -->
<extensions>
<!--例如,通常情況下,程序開發完成后部署到線上Linux服務器,可能需要經歷打包、 -->
<!--將包文件傳到服務器、SSH連上服務器、敲命令啟動程序等一系列繁瑣的步驟。 -->
<!--實際上這些步驟都可以通過Maven的一個插件 wagon-maven-plugin 來自動完成 -->
<!--下面的擴展插件wagon-ssh用於通過SSH的方式連接遠程服務器, -->
<!--類似的還有支持ftp方式的wagon-ftp插件 -->
<extension>
<groupId>org.apache.maven.wagon</groupId>
<artifactId>wagon-ssh</artifactId>
<version>2.8</version>
</extension>
</extensions>
<!--使用的插件列表 。 -->
<plugins>
<plugin>
<groupId></groupId>
<artifactId>maven-assembly-plugin</artifactId>
<version>2.5.5</version>
<!--在構建生命周期中執行一組目標的配置。每個目標可能有不同的配置。 -->
<executions>
<execution>
<!--執行目標的標識符,用於標識構建過程中的目標,或者匹配繼承過程中需要合並的執行目標 -->
<id>assembly</id>
<!--綁定了目標的構建生命周期階段,如果省略,目標會被綁定到源數據里配置的默認階段 -->
<phase>package</phase>
<!--配置的執行目標 -->
<goals>
<goal>single</goal>
</goals>
<!--配置是否被傳播到子POM -->
<inherited>false</inherited>
</execution>
</executions>
<!--作為DOM對象的配置,配置項因插件而異 -->
<configuration>
<finalName>${finalName}</finalName>
<appendAssemblyId>false</appendAssemblyId>
<descriptor>assembly.xml</descriptor>
</configuration>
<!--是否從該插件下載Maven擴展(例如打包和類型處理器), -->
<!--由於性能原因,只有在真需要下載時,該元素才被設置成true。 -->
<extensions>false</extensions>
<!--項目引入插件所需要的額外依賴 -->
<dependencies>
<dependency>...</dependency>
</dependencies>
<!--任何配置是否被傳播到子項目 -->
<inherited>true</inherited>
</plugin>
</plugins>
<!--主要定義插件的共同元素、擴展元素集合,類似於dependencyManagement, -->
<!--所有繼承於此項目的子項目都能使用。該插件配置項直到被引用時才會被解析或綁定到生命周期。 -->
<!--給定插件的任何本地配置都會覆蓋這里的配置 -->
<pluginManagement>
<plugins>...</plugins>
</pluginManagement>
</build>
profile配置
<!--在列的項目構建profile,如果被激活,會修改構建處理 -->
<profiles>
<!--根據環境參數或命令行參數激活某個構建處理 -->
<profile>
<!--自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。 -->
<activation>
<!--profile默認是否激活的標識 -->
<activeByDefault>false</activeByDefault>
<!--activation有一個內建的java版本檢測,如果檢測到jdk版本與期待的一樣,profile被激活。 -->
<jdk>1.7</jdk>
<!--當匹配的操作系統屬性被檢測到,profile被激活。os元素可以定義一些操作系統相關的屬性。 -->
<os>
<!--激活profile的操作系統的名字 -->
<name>Windows XP</name>
<!--激活profile的操作系統所屬家族(如 'windows') -->
<family>Windows</family>
<!--激活profile的操作系統體系結構 -->
<arch>x86</arch>
<!--激活profile的操作系統版本 -->
<version>5.1.2600</version>
</os>
<!--如果Maven檢測到某一個屬性(其值可以在POM中通過${名稱}引用),其擁有對應的名稱和值,Profile就會被激活。 -->
<!-- 如果值字段是空的,那么存在屬性名稱字段就會激活profile,否則按區分大小寫方式匹配屬性值字段 -->
<property>
<!--激活profile的屬性的名稱 -->
<name>mavenVersion</name>
<!--激活profile的屬性的值 -->
<value>2.0.3</value>
</property>
<!--提供一個文件名,通過檢測該文件的存在或不存在來激活profile。missing檢查文件是否存在,如果不存在則激活profile。 -->
<!--另一方面,exists則會檢查文件是否存在,如果存在則激活profile。 -->
<file>
<!--如果指定的文件存在,則激活profile。 -->
<exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists>
<!--如果指定的文件不存在,則激活profile。 -->
<missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</missing>
</file>
</activation>
<id />
<build />
<modules />
<repositories />
<pluginRepositories />
<dependencies />
<reporting />
<dependencyManagement />
<distributionManagement />
<properties />
</profile>
profile配置項在setting.xml中也有,是pom.xml中profile元素的裁剪版本,包含了id,activation, repositories, pluginRepositories和 properties元素。這里的profile元素只包含這五個子元素是因為setting.xml只關心構建系統這個整體(這正是settings.xml文件的角色定位),而非單獨的項目對象模型設置。如果一個settings中的profile被激活,它的值會覆蓋任何其它定義在POM中或者profile.xml中的帶有相同id的profile。
pom.xml中的profile可以看做pom.xml的副本,擁有與pom.xml相同的子元素與配置方法。它包含可選的activation(profile的觸發器)和一系列的changes。例如test過程可能會指向不同的數據庫(相對最終的deployment)或者不同的dependencies或者不同的repositories,並且是根據不同的JDK來改變的。只需要其中一個成立就可以激活profile,如果第一個條件滿足了,那么后面就不會在進行匹配。
---------------------
作者:冰河winner
來源:CSDN
原文:https://blog.csdn.net/u012152619/article/details/51485297
版權聲明:本文為博主原創文章,轉載請附上博文鏈接!
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0http://maven.apache.org/xsd/maven-4.0.0.xsd"> <!-- 模型版本。maven2.0必須是這樣寫,現在是maven2唯一支持的版本 --><modelVersion>4.0.0</modelVersion> <!-- 公司或者組織的唯一標志,並且配置時生成的路徑也是由此生成, 如com.winner.trade,maven會將該項目打成的jar包放本地路徑:/com/winner/trade --><groupId>com.winner.trade</groupId> <!-- 本項目的唯一ID,一個groupId下面可能多個項目,就是靠artifactId來區分的 --><artifactId>trade-core</artifactId> <!-- 本項目目前所處的版本號 --><version>1.0.0-SNAPSHOT</version> <!-- 打包的機制,如pom,jar, maven-plugin, ejb, war, ear, rar, par,默認為jar --><packaging>jar</packaging> <!-- 幫助定義構件輸出的一些附屬構件,附屬構件與主構件對應,有時候需要加上classifier才能唯一的確定該構件 不能直接定義項目的classifer,因為附屬構件不是項目直接默認生成的,而是由附加的插件幫助生成的 --><classifier>...</classifier> <!-- 定義本項目的依賴關系 --><dependencies> <!-- 每個dependency都對應這一個jar包 --><dependency> <!--一般情況下,maven是通過groupId、artifactId、version這三個元素值(俗稱坐標)來檢索該構件, 然后引入你的工程。如果別人想引用你現在開發的這個項目(前提是已開發完畢並發布到了遠程倉庫),--> <!--就需要在他的pom文件中新建一個dependency節點,將本項目的groupId、artifactId、version寫入, maven就會把你上傳的jar包下載到他的本地 --><groupId>com.winner.trade</groupId><artifactId>trade-test</artifactId><version>1.0.0-SNAPSHOT</version> <!-- maven認為,程序對外部的依賴會隨着程序的所處階段和應用場景而變化,所以maven中的依賴關系有作用域(scope)的限制。 --><!--scope包含如下的取值:compile(編譯范圍)、provided(已提供范圍)、runtime(運行時范圍)、test(測試范圍)、system(系統范圍) --><scope>test</scope> <!-- 設置指依賴是否可選,默認為false,即子項目默認都繼承:為true,則子項目必需顯示的引入,與dependencyManagement里定義的依賴類似 --><optional>false</optional> <!-- 屏蔽依賴關系。 比如項目中使用的libA依賴某個庫的1.0版,libB依賴某個庫的2.0版,現在想統一使用2.0版,就應該屏蔽掉對1.0版的依賴 --><exclusions><exclusion><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId></exclusion></exclusions> </dependency> </dependencies> <!-- 為pom定義一些常量,在pom中的其它地方可以直接引用 使用方式 如下 :${file.encoding} --><properties><file.encoding>UTF-8</file.encoding><java.source.version>1.5</java.source.version><java.target.version>1.5</java.target.version></properties> ...</project>
