pom文件配置相关解释

pom文件配置相关解释

什么是pom?

POM是项目对象模型(Project Object Model)的简称,它是Maven项目中的文件，使用XML表示，名称叫做pom.xml。作用类似ant的build.xml文件，功能更强大。该文件用于管理：源代码、配置文件、开发者的信息和角色、问题追踪系统、组织信息、项目授权、项目的url、项目的依赖关系等等。事实上，在Maven世界中，project可以什么都没有，甚至没有代码，但是必须包含pom.xml文件。

概览#

下面是一个POM项目中的pom.xml文件中包含的元素。注意，其中的modelVersion是4.0.0，这是当前仅有的可以被Maven2&3同时支持的POM版本，它是必须的。

<!-- 父项目的坐标。如果项目中没有规定某个元素的值，那么父项目中的对应值即为项目的默认值。坐标包括group ID，artifact ID和 version。 --> 
<parent> 
    <!-- 被继承的父项目的构件标识符 --> 
    <artifactId>xxx</artifactId>

    <!-- 被继承的父项目的全球唯一标识符 -->
    <groupId>xxx</groupId> 

    <!-- 被继承的父项目的版本 --> 
    <version>xxx</version>

    <!-- 父项目的pom.xml文件的相对路径。相对路径允许你选择一个不同的路径。默认值是../pom.xml。
         Maven首先在构建当前项目的地方寻找父项目的pom，其次在文件系统的这个位置（relativePath位置），
         然后在本地仓库，最后在远程仓库寻找父项目的pom。 --> 
    <relativePath>xxx</relativePath> 
</parent> 

<!-- 声明项目描述符遵循哪一个POM模型版本。模型本身的版本很少改变，虽然如此，但它仍然是必不可少的，
     这是为了当Maven引入了新的特性或者其他模型变更的时候，确保稳定性。 --> 
<modelVersion> 4.0.0 </modelVersion> 

<!-- 项目的全球唯一标识符，通常使用全限定的包名区分该项目和其他项目。并且构建时生成的路径也是由此生成， 
     如com.mycompany.app生成的相对路径为：/com/mycompany/app --> 
<groupId>xxx</groupId> 

<!-- 构件的标识符，它和group ID一起唯一标识一个构件。换句话说，你不能有两个不同的项目拥有同样的artifact ID
     和groupID；在某个特定的group ID下，artifact ID也必须是唯一的。构件是项目产生的或使用的一个东西，Maven
     为项目产生的构件包括：JARs，源码，二进制发布和WARs等。 --> 
<artifactId>xxx</artifactId> 

<!-- 项目产生的构件类型，例如jar、war、ear、pom。插件可以创建他们自己的构件类型，所以前面列的不是全部构件类型 --> 
<packaging> jar </packaging> 

<!-- 项目当前版本，格式为:主版本.次版本.增量版本-限定版本号 --> 
<version> 1.0-SNAPSHOT </version> 

<!-- 项目的名称, Maven产生的文档用 --> 
<name> xxx-maven </name> 

<!-- 项目主页的URL, Maven产生的文档用 --> 
<url> http://maven.apache.org </url> 

<!-- 项目的详细描述, Maven 产生的文档用。 当这个元素能够用HTML格式描述时（例如，CDATA中的文本会被解析器忽略，
     就可以包含HTML标签）， 不鼓励使用纯文本描述。如果你需要修改产生的web站点的索引页面，你应该修改你自己的
     索引页文件，而不是调整这里的文档。 --> 
<description> A maven project to study maven. </description> 

<!-- 描述了这个项目构建环境中的前提条件。 --> 
<prerequisites> 
    <!-- 构建该项目或使用该插件所需要的Maven的最低版本 --> 
    <maven></maven> 
</prerequisites> 

<!-- 项目的问题管理系统(Bugzilla, Jira, Scarab,或任何你喜欢的问题管理系统)的名称和URL，本例为 jira --> 
<issueManagement> 
    <!-- 问题管理系统（例如jira）的名字， --> 
    <system> jira </system> 

    <!-- 该项目使用的问题管理系统的URL --> 
    <url> http://jira.baidu.com/banseon </url> 
</issueManagement> 

<!-- 项目持续集成信息 --> 
<ciManagement> 
    <!-- 持续集成系统的名字，例如continuum --> 
    <system></system> 

    <!-- 该项目使用的持续集成系统的URL（如果持续集成系统有web接口的话）。 --> 
    <url></url> 

    <!-- 构建完成时，需要通知的开发者/用户的配置项。包括被通知者信息和通知条件（错误，失败，成功，警告） --> 
    <notifiers> 
        <!-- 配置一种方式，当构建中断时，以该方式通知用户/开发者 --> 
        <notifier> 
            <!-- 传送通知的途径 --> 
            <type></type> 

            <!-- 发生错误时是否通知 --> 
            <sendOnError></sendOnError> 

            <!-- 构建失败时是否通知 --> 
            <sendOnFailure></sendOnFailure> 

            <!-- 构建成功时是否通知 --> 
            <sendOnSuccess></sendOnSuccess> 

            <!-- 发生警告时是否通知 --> 
            <sendOnWarning></sendOnWarning> 

            <!-- 不赞成使用。通知发送到哪里 --> 
            <address></address> 

            <!-- 扩展配置项 --> 
            <configuration></configuration> 
        </notifier> 
    </notifiers> 
</ciManagement> 

<!-- 项目创建年份，4位数字。当产生版权信息时需要使用这个值。 --> 
<inceptionYear /> 

<!-- 项目相关邮件列表信息 --> 
<mailingLists> 
    <!-- 该元素描述了项目相关的所有邮件列表。自动产生的网站引用这些信息。 --> 
    <mailingList> 
        <!-- 邮件的名称 --> 
        <name> Demo </name> 

        <!-- 发送邮件的地址或链接，如果是邮件地址，创建文档时，mailto: 链接会被自动创建 --> 
        <post> banseon@126.com </post> 

        <!-- 订阅邮件的地址或链接，如果是邮件地址，创建文档时，mailto: 链接会被自动创建 --> 
        <subscribe> banseon@126.com </subscribe> 

        <!-- 取消订阅邮件的地址或链接，如果是邮件地址，创建文档时，mailto: 链接会被自动创建 --> 
        <unsubscribe> banseon@126.com </unsubscribe> 

        <!-- 你可以浏览邮件信息的URL --> 
        <archive> http:/hi.baidu.com/banseon/demo/dev/ </archive> 
    </mailingList> 
</mailingLists> 

<!-- 项目开发者列表 --> 
<developers> 
    <!-- 某个项目开发者的信息 --> 
    <developer> 
        <!-- SCM里项目开发者的唯一标识符 --> 
        <id> HELLO WORLD </id>
        
        <!-- 项目开发者的全名 --> 
        <name> banseon </name> 

        <!-- 项目开发者的email --> 
        <email> banseon@126.com </email> 

        <!-- 项目开发者的主页的URL --> 
        <url></url> 

        <!-- 项目开发者在项目中扮演的角色，角色元素描述了各种角色 --> 
        <roles> 
            <role> Project Manager </role> 
            <role> Architect </role> 
        </roles> 

        <!-- 项目开发者所属组织 --> 
        <organization> demo </organization> 

        <!-- 项目开发者所属组织的URL --> 
        <organizationUrl> http://hi.baidu.com/xxx </organizationUrl> 

        <!-- 项目开发者属性，如即时消息如何处理等 --> 
        <properties> 
            <dept> No </dept> 
        </properties> 

        <!-- 项目开发者所在时区， -11到12范围内的整数。 --> 
        <timezone> -5 </timezone> 
    </developer> 
</developers> 

<!-- 项目的其他贡献者列表 --> 
<contributors> 
    <!-- 项目的其他贡献者。参见developers/developer元素 --> 
    <contributor> 
        <!-- 项目贡献者的全名 --> 
        <name></name>

        <!-- 项目贡献者的email -->
        <email></email>

        <!-- 项目贡献者的主页的URL -->
        <url></url>

        <!-- 项目贡献者所属组织 -->
        <organization></organization>

        <!-- 项目贡献者所属组织的URL -->
        <organizationUrl></organizationUrl>

        <!-- 项目贡献者在项目中扮演的角色，角色元素描述了各种角色 --> 
        <roles> 
            <role> Project Manager </role> 
            <role> Architect </role> 
        </roles>

        <!-- 项目贡献者所在时区， -11到12范围内的整数。 --> 
        <timezone></timezone>
        
        <!-- 项目贡献者属性，如即时消息如何处理等 --> 
        <properties> 
            <dept> No </dept> 
        </properties>  
    </contributor> 
</contributors> 

<!-- 该元素描述了项目所有License列表。 应该只列出该项目的license列表，不要列出依赖项目的 license列表。
     如果列出多个license，用户可以选择它们中的一个而不是接受所有license。 --> 
<licenses> 
    <!-- 描述了项目的license，用于生成项目的web站点的license页面，其他一些报表和validation也会用到该元素。 --> 
    <license> 
        <!-- license用于法律上的名称 --> 
        <name> Apache 2 </name> 

        <!-- 官方的license正文页面的URL --> 
        <url> http://www.baidu.com/banseon/LICENSE-2.0.txt </url> 

        <!-- 项目分发的主要方式： 
                repo，可以从Maven库下载 
                manual， 用户必须手动下载和安装依赖 --> 
        <distribution> repo </distribution> 

        <!-- 关于license的补充信息 --> 
        <comments> A business-friendly OSS license </comments> 
    </license> 
</licenses> 

<!-- SCM(Source Control Management)标签允许你配置你的代码库，供Maven web站点和其它插件使用。 --> 
<scm> 
    <!-- SCM的URL,该URL描述了版本库和如何连接到版本库。欲知详情，请看SCMs提供的URL格式和列表。该连接只读。 --> 
    <connection> 
        scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-