1. pom.xml簡(jiǎn)介

POM是Project Object Model的縮寫，pom.xml 則是每一個(gè)Maven工程必備的文件之一膏蚓。我們這里引用官網(wǎng)上對(duì)POM的簡(jiǎn)介捎拯。

A Project Object Model or POM is the fundamental unit of work in Maven. It is an XML file that contains information about the project and configuration details used by Maven to build the project. Some of the configuration that can be specified in the POM are the project dependencies, the plugins or goals that can be executed, the build profiles, and so on. Other information such as the project version, description, developers, mailing lists and such can also be specified. POM stands for "Project Object Model". It is an XML representation of a Maven project held in a file named pom.xml . In fact, in the Maven world, a project need not contain any code at all, merely a pom.xml.

如果你想更加深入地了解 pom.xml 文件的方方面面君珠，強(qiáng)烈推薦你閱讀官方的參考文檔： Introduction to the POM 和 POM Reference 谈宛。

2. pom.xml實(shí)戰(zhàn)

下面顺少，我們以一個(gè)實(shí)際項(xiàng)目中的 pom.xml 文件作為實(shí)戰(zhàn)案例抖部，分析里面所有元素和屬性的含義和用法淫痰。我們會(huì)以xml文件注釋的形式進(jìn)行分析和說明把介。我們本次實(shí)戰(zhàn)是基于一個(gè)最基本的Maven項(xiàng)目場(chǎng)景暑刃，不可能涵蓋所有的Maven配置元素厢漩，我們會(huì)在 Maven開發(fā)筆記 系列博客中，對(duì)Maven做更加深入的學(xué)習(xí)和研究岩臣。本次實(shí)戰(zhàn)的 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.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    
    <!-- xml文件中溜嗜，定義命名空間的格式為：xmlns:namespace-prefix="namespaceURI"
        定義默認(rèn)命名空間的格式為：xmlns="namespaceURI" -->
    <!-- pom文件本身就是一個(gè)xml文件，最高級(jí)別的元素就是project元素架谎，該元素定義了如下屬性：
        xmlns：定義了該元素下的所有子元素的默認(rèn)命名空間為：http://maven.apache.org/POM/4.0.0
        xmlns:xsi：定義了一個(gè)namespace-prefix炸宵，其代表的命名空間URI為：http://www.w3.org/2001/XMLSchema-instance
            定義該namespace-prefix主要是為了使用其所代表的命名空間中的schemaLocation屬性時(shí)，比較簡(jiǎn)潔
            其中谷扣，使用xsi作為namespace-prefix土全，并不是硬性規(guī)定，只是大家都這么用，方便閱讀理解裹匙，
            當(dāng)然了野哭，如果你執(zhí)意要改成別的命名，也是可以的
        xsi:schemaLocation：該屬性的使用格式為：xsi:schemaLocation="namespaceURI1 schemaURI1 namespaceURI2 schemaURI2 ..."
            其表示的意思是幻件，使用schemaURI1所對(duì)應(yīng)的schema文件拨黔，校驗(yàn)命名空間namespaceURI1下的元素，schemaURIN以此類推 -->
    
    <!-- Maven項(xiàng)目基本信息绰沥，即項(xiàng)目坐標(biāo)定義 BEGIN-->
    <!-- modelVersion 指定了當(dāng)前POM模型的版本篱蝇，對(duì)于Maven2 及Maven3 來(lái)說，只能是4.0.0 -->    
    <modelVersion>4.0.0</modelVersion>
    <!-- groupId 表明其所屬組織或公司徽曲，有時(shí)候會(huì)加上所屬的項(xiàng)目零截，命名規(guī)則為組織或公司域名反轉(zhuǎn)，或者再加項(xiàng)目名稱 -->
    <groupId>top.qiumengchen</groupId>
    <!-- artifactId 項(xiàng)目的模塊名秃臣，有時(shí)候和項(xiàng)目名保持一致涧衙，有時(shí)候?yàn)?項(xiàng)目名-模塊名" -->
    <artifactId>basement</artifactId>
    <!-- version 當(dāng)前項(xiàng)目的版本號(hào)，SHAPSHOT意為快照奥此，說明該項(xiàng)目還處于開發(fā)中 -->
    <version>0.0.1-SNAPSHOT</version>
    <!-- packaging 定義項(xiàng)目的打包方式弧哎，常用可選值：jar、war稚虎、pom等撤嫩，默認(rèn)方式為jar -->
    <packaging>war</packaging>
    <!-- name 聲明了一個(gè)對(duì)于用戶更加友好的項(xiàng)目名稱，非必須項(xiàng) -->
    <name>My Basement Maven Project</name>
    <!-- Maven項(xiàng)目基本信息蠢终，即項(xiàng)目坐標(biāo)定義 END-->
    
    <!-- 屬性定義 BEGIN-->
    <!-- properties 通過該元素序攘，用戶可以自定義一個(gè)或多個(gè)Maven屬性，然后在POM的其他地方
        使用${屬性名稱}的方式引用該屬性寻拂，從而消除重復(fù)程奠，保證文件的一致性 -->
    <properties>
        <project.build.encoding>UTF-8</project.build.encoding>
        <springframework.version>3.2.1.RELEASE</springframework.version>
    </properties>
    <!-- 屬性定義 END-->
    
    <!-- 依賴定義 BEGIN-->
    <dependencies>
        <!-- groupId、artifactId祭钉、version 元素的含義同Maven項(xiàng)目基本信息中的對(duì)應(yīng)元素含義一致
            type 指依賴的類型瞄沙，對(duì)應(yīng)于項(xiàng)目坐標(biāo)定義的packaging，其默認(rèn)值為jar
            scope 依賴的作用范圍朴皆，例如：compile帕识、test、provided遂铡、runtime、system晶姊，默認(rèn)compile
            optional 標(biāo)記依賴是否可選扒接，主要在該項(xiàng)目被其他項(xiàng)目依賴的時(shí)候起作用，取值有：true、false钾怔。默認(rèn)false
            exclusions 用來(lái)排除傳遞性依賴碱呼，用于排除某些不需要或不想要的特定依賴 -->
            
        <!-- SpringFramework 相關(guān)依賴 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>${springframework.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
            <version>${springframework.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>${springframework.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-tx</artifactId>
            <version>${springframework.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-orm</artifactId>
            <version>${springframework.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
            <version>${springframework.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>${springframework.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>${springframework.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-test</artifactId>
            <version>${springframework.version}</version>
            <scope>test</scope>
        </dependency>
        
        <!-- Apache Commons相關(guān)依賴 -->
        <!-- dbcp組件，提供數(shù)據(jù)庫(kù)連接池功能 -->
        <dependency>
            <groupId>commons-dbcp</groupId>
            <artifactId>commons-dbcp</artifactId>
            <version>1.4</version>
        </dependency>
        <!-- fileupload組件宗侦，提供文件上傳愚臀、下載等功能 -->
        <dependency>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
            <version>1.3.1</version>
        </dependency>
        <!-- lang組件，提供對(duì)Java核心類庫(kù)矾利，特別是java.lang類庫(kù)的擴(kuò)展姑裂，提供了很多便利的方法 -->
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
            <version>3.4</version>
        </dependency>
        
        <!-- 日志工具，log4j和commons-logging配合使用男旗，效果最佳 -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.14</version>
        </dependency>
        <!-- 使用slf4j接管commons-logging的職責(zé)舶斧，替換系統(tǒng)中已經(jīng)存在的日志系統(tǒng) -->
        <!-- slf4j核心jar包 -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.6.6</version>
        </dependency>
        <!-- 接管commons-logging的職責(zé)，使用common-loggin的接口察皇，底層還是由SLF4J來(lái)決定哪種實(shí)現(xiàn)機(jī)制 -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>jcl-over-slf4j</artifactId>
            <version>1.6.6</version>
            <scope>runtime</scope>
        </dependency>
        <!-- 使用SLF4J的接口茴厉，底層由log4j實(shí)現(xiàn) -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>1.6.6</version>
            <scope>runtime</scope>
        </dependency>
        
        <!-- JUnit 依賴 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.8.1</version>
            <scope>test</scope>
        </dependency>
        
        <!-- 數(shù)據(jù)庫(kù)相關(guān)依賴 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>2.3.5</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.0.8</version>
            <scope>runtime</scope>
        </dependency>
                        
        <!-- fge json schema begin -->
         <dependency>  
            <groupId>com.fasterxml.jackson.core</groupId>  
            <artifactId>jackson-core</artifactId>  
            <version>2.3.0</version>    
        </dependency>  
        <dependency>  
            <groupId>com.fasterxml.jackson.core</groupId>  
            <artifactId>jackson-databind</artifactId>  
            <version>2.3.0</version>    
        </dependency>  
        <dependency>  
            <groupId>com.github.fge</groupId>  
            <artifactId>json-schema-validator</artifactId>  
            <version>2.2.6</version>    
        </dependency>  
        <!-- fge json schema end -->
        
    </dependencies>
    <!-- 依賴定義 END-->
  
    <!-- Maven打包參數(shù) BEGIN -->
    <profiles>
        <!-- profile 可以讓我們定義一系列的配置信息，然后指定其激活條件什荣。
            可以定義多個(gè)profile矾缓，然后每個(gè)profile對(duì)應(yīng)不同的激活條件和配置信息，
            從而達(dá)到不同情況下使用不同配置信息的效果稻爬。
            激活條件包括但不僅限于：不同JDK而账，不同操作系統(tǒng)信息，顯式指定激活profile的id -->
        <profile>
            <id>development</id>
            <properties>
                <env>development</env>
            </properties>
        </profile>
        <profile>
            <id>beta</id>
            <properties>
                <env>beta</env>
            </properties>
        </profile>
        <profile>
            <id>production</id>
            <properties>
                <env>production</env>
            </properties>
        </profile>
    </profiles>
    <!-- Maven打包參數(shù) END -->
    
    <!-- Maven編譯設(shè)置 BEGIN -->
    <build>
        <!-- finalName 指定了最終構(gòu)建的文件的名稱格式因篇，默認(rèn)繼承Maven默認(rèn)父POM設(shè)定泞辐，即artifactId-version -->
        <finalName>basement</finalName>
        <!-- profile、filter竞滓、resource元素結(jié)合實(shí)現(xiàn)生成不同的發(fā)布包時(shí)咐吼，對(duì)資源進(jìn)行不同的替換操作
        下面這段配置以及結(jié)合profile的配置表示：
        對(duì)src/main/resources下的資源進(jìn)行過濾，過濾時(shí)采用的過濾文件為filter元素指定的文件商佑，
        其中${env}是由編譯時(shí)通過-P指定的profile決定的锯茄，
        過濾即指，使用filter中定義的變量的value替換src/main/resources目錄下相同key變量的value -->
        <filters>
            <filter>vars/var.${env}.properties</filter>
        </filters>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <filtering>true</filtering>
            </resource>
        </resources>
        <!-- 插件管理 -->
        <plugins>
            <!-- 配置編譯Java代碼插件茶没，source指定編譯Java 1.6版本的源文件肌幽，target指定生成與JVM 1.6兼容
                的字節(jié)碼文件，encoding指定編譯時(shí)采用的編碼為UTF-8 -->
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.3.2</version>
                <configuration>
                    <source>1.6</source>
                    <target>1.6</target>
                    <encoding>${project.build.encoding}</encoding>
                </configuration>
            </plugin>
            <!-- 配置處理資源文件的方式抓半，encoding指定處理時(shí)采用的編碼為UTF-8 -->
            <plugin>
                <artifactId>maven-resources-plugin</artifactId>
                <version>2.4</version>
                <configuration>
                    <encoding>${project.build.encoding}</encoding>
                </configuration>
            </plugin>
        </plugins>    
    </build>
    <!-- Maven編譯設(shè)置 END -->
</project>

3. 總結(jié)

我們本次實(shí)戰(zhàn)所采用的 pom.xml 文件比較簡(jiǎn)單喂急，僅僅涵蓋了Maven常用的配置元素。我們會(huì)在 Maven開發(fā)筆記 系列博客中進(jìn)行更加詳細(xì)深入的分析和研究笛求。如果大家有任何疑問或建議廊移，歡迎留言或評(píng)論糕簿，希望我們?cè)谙嗷ビ懻摗W(xué)習(xí)中一起進(jìn)步狡孔。