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>