原文:http://blog.csdn.net/u012152619/article/details/51485297 一般來說,上面的幾個配置項對任何項目都是必不可少的,定義了項目的基本屬性。 這裡有必要對一個不太常用的屬性classifier做一下解釋,因為有時候引用某個jar包,classif ...
原文:http://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>
一般來說,上面的幾個配置項對任何項目都是必不可少的,定義了項目的基本屬性。
這裡有必要對一個不太常用的屬性classifier做一下解釋,因為有時候引用某個jar包,classifier不寫的話會報錯。
classifier元素用來幫助定義構件輸出的一些附屬構件。附屬構件與主構件對應,比如主構件是 kimi-app-2.0.0.jar,該項目可能還會通過使用一些插件生成 如kimi-app-2.0.0-javadoc.jar (Java文檔)、 kimi-app-2.0.0-sources.jar(Java源代碼) 這樣兩個附屬構件。這時候,javadoc、sources就是這兩個附屬構件的classifier,這樣附屬構件也就擁有了自己唯一的坐標。
classifier的用途在於:
1. maven download javadoc / sources jar包的時候,需要藉助classifier指明要下載那個附屬構件
2. 引入依賴的時候,有時候僅憑groupId、artifactId、version無法唯一的確定某個構件,需要藉助classifier來進一步明確目標。比如JSON-lib,有時候會同一個版本會提供多個jar包,在JDK1.5環境下是一套,在JDK1.3環境下是一套:
引用它的時候就要註明JDK版本,否則maven不知道你到底需要哪一套jar包:
[html] view plain copy
- <dependency>
- <groupId>net.sf.json-lib</groupId>
- <artifactId>json-lib</artifactId>
- <version>2.4</version>
- <classifier>jdk15</classifier>
- </dependency>
構建配置
[html] view plain copy
- <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>
pom裡面的倉庫與setting.xml里的倉庫功能是一樣的。主要的區別在於,pom里的倉庫是個性化的。比如一家大公司里的setting文件是公用的,所有項目都用一個setting文件,但各個子項目卻會引用不同的第三方庫,所以就需要在pom里設置自己需要的倉庫地址。
分發配置
[html] view plain copy
- <!--項目分發信息,在執行mvn deploy後表示要發佈的位置。 -->
- <!--有了這些信息就可以把網站部署到遠程伺服器或者把構件部署到遠程倉庫。 -->
- <distributionManagement>
- <!--部署項目產生的構件到遠程倉庫需要的信息 -->
- <repository>
- <!--是分配給快照一個唯一的版本號(由時間戳和構建流水號),還是每次都使用相同的版本號 -->
- <!--參見repositories/repository元素 -->
- <uniqueVersion>true</uniqueVersion>
- <id> repo-id </id>
- <name> repo-name</name>
- <url>file://${basedir}/target/deploy </url>
- <layout />
- </repository>
- <!--構件的快照部署到哪裡,如果沒有配置該元素,預設部署到repository元素配置的倉庫 -->
- <snapshotRepository>
- <uniqueVersion />
- <id />
- <name />
- <url />
- <layout />
- </snapshotRepository>
- <!--部署項目的網站需要的信息 -->
- <site>
- <!--部署位置的唯一標識符,用來匹配站點和settings.xml文件里的配置 -->
- <id> site-id </id>
- <!--部署位置的名稱 -->
- <name> site-name</name>
- <!--部署位置的URL,按protocol://hostname/path形式 -->
- <url>scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web </url>
- </site>
- <!--項目下載頁面的URL。如果沒有該元素,用戶應該參考主頁。 -->
- <!--使用該元素的原因是:幫助定位那些不在倉庫里的構件(由於license限制)。 -->
- <downloadUrl />
- <!--如果構件有了新的groupID和artifact ID(構件移到了新的位置),這裡列出構件的重定位信息。 -->
- <relocation>
- <!--構件新的group ID -->
- <groupId />
- <!--構件新的artifact ID -->
- <artifactId />
- <!--構件新的版本號 -->
- <version />
- <!--顯示給用戶的,關於移動的額外信息,例如原因。 -->
- <message />
- </relocation>
- <!--給出該構件在遠程倉庫的狀態。不得在本地項目中設置該元素,因為這是工具自動更新的。 -->
- <!--有效的值有:none(預設),converted(倉庫管理員從Maven 1 POM轉換過來), -->
- <!--partner(直接從伙伴Maven 2倉庫同步過來),deployed(從Maven 2實例部署),verified(被核實時正確的和最終的)。 -->
- <status />
- </distributionManagement>
倉庫配置
[html] view plain copy
- <!--發現依賴和擴展的遠程倉庫列表。 -->
- <repositories>
- <!--包含需要連接到遠程倉庫的信息 -->
- <repository>
- <!--如何處理遠程倉庫里發佈版本的下載 -->
- <releases>
- <!--true或者false表示該倉庫是否為下載某種類型構件(發佈版,快照版)開啟。 -->
- <enabled />
- <!--該元素指定更新發生的頻率。Maven會比較本地POM和遠程POM的時間戳。 -->
- <!--這裡的選項是:always(一直),daily(預設,每日), -->
- <!--interval:X(這裡X是以分鐘為單位的時間間隔),或者never(從不)。 -->
- <updatePolicy />
- <!--當Maven驗證構件校驗文件失敗時該怎麼做: -->
- <!--ignore(忽略),fail(失敗),或者warn(警告)。 -->
- <checksumPolicy />
- </releases>
- <!--如何處理遠程倉庫里快照版本的下載。有了releases和snapshots這兩組配置, -->
- <!--POM就可以在每個單獨的倉庫中,為每種類型的構件採取不同的策略。 -->
- <!--例如,可能有人會決定只為開發目的開啟對快照版本下載的支持 -->
- <snapshots>
- <enabled />
- <updatePolicy />
- <checksumPolicy />
- </snapshots>
- <!--遠程倉庫唯一標識符。可以用來匹配在settings.xml文件里配置的遠程倉庫 -->
- <id> repo-id </id>
- <!--遠程倉庫名稱 -->
- <name> repo-name</name>
- <!--遠程倉庫URL,按protocol://hostname/path形式 -->
- <url>http://192.168.1.169:9999/repository/ </url>
- <!--用於定位和排序構件的倉庫佈局類型-可以是default(預設)或者legacy(遺留)。 -->
- <!--Maven 2為其倉庫提供了一個預設的佈局; -->
- <!--然而,Maven1.x有一種不同的佈局。 -->
- <!--我們可以使用該元素指定佈局是default(預設)還是legacy(遺留)。 -->
- <layout> default</layout>
- </repository>
- </repositories>
- <!--發現插件的遠程倉庫列表,這些插件用於構建和報表 -->
- <pluginRepositories>
- <!--包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素 -->
- <pluginRepository />
- </pluginRepositories>
profile配置
[html] view plain copy
- <!--在列的項目構建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>&nb