maven參數詳解


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>


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM