1. 程式人生 > 實用技巧 >maven————pom.xml檔案模板

maven————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>