Maven中的pom.xml配置文件详解

原文:http://blog.csdn.net/u012152619/article/details/51485297

<!-- 模型版本。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>  

...  

一般来说，上面的几个配置项对任何项目都是必不可少的，定义了项目的基本属性。

这里有必要对一个不太常用的属性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

print ?

net.sf.json-lib
json-lib
2.4
jdk15

构建配置

[html] view plain copy

print ?

<!-- 产生的构件的文件名，默认值是${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>  

        <!--描述了资源的目标路径。该路径相对targe