Maven pom.mxl文件详解

Maven pom.mxl文件详解

<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">

    <!--父项目的坐标。如果项目中没有规定某个元素的值，那么父项目中的对应值即为项目的默认值。 坐标包括group ID，artifact ID和 version。-->

    <parent>

        <!--被继承的父项目的构件标识符-->

        <artifactId/>

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

        <groupId/>

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

        <version/>

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

        <relativePath/>

    </parent>

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

    <modelVersion>4.0.0</modelVersion>

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

    <groupId>asia.banseon</groupId>

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

    <artifactId>banseon-maven2</artifactId>

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

    <packaging>jar</packaging>

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

    <version>1.0-SNAPSHOT</version>

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

    <name>banseon-maven</name>

    <!--项目主页的URL, Maven产生的文档用-->

    <url>http://www.baidu.com/banseon</url>

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

    <description>A maven project to study maven.</description>

    <!--描述了这个项目构建环境中的前提条件。-->

    <prerequisites>

        <!--构建该项目或使用该插件所需要的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/>

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

        <url/>

        <!--构建完成时，需要通知的开发者/用户的配置项。包括被通知者信息和通知条件（错误，失败，成功，警告）-->

        <notifiers>

            <!--配置一种方式，当构建中断时，以该方式通知用户/开发者-->

            <notifier>

                <!--传送通知的途径-->

                <type/>

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

                <sendOnError/>

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

                <sendOnFailure/>

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

                <sendOnSuccess/>

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

                <sendOnWarning/>

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

                <address/>

                <!--扩展配置项-->

                <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/>

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

            <roles>

                <role>Project Manager</role>

                <role>Architect</role>

            </roles>

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

            <organization>demo</organization>

            <!--项目开发者所属组织的URL-->

            <organizationUrl>http://hi.baidu.com/banseon</organizationUrl>

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

            <properties>

                <dept>No</dept>

            </properties>

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

            <timezone>-5</timezone>

        </developer>

    </developers>

    <!--项目的其他贡献者列表-->

    <contributors>

        <!--项目的其他贡献者。参见developers/developer元素-->

        <contributor>

            <name/>
            <email/>
            <url/>
            <organization/>
            <organizationUrl/>
            <roles/>
            <timezone/>
            <properties/>

        </contributor>

    </contributors>

    <!--该元素描述了项目所有License列表。 应该只列出该项目的license列表，不要列出依赖项目的 license列表。如果列出多个license，用户可以选择它们中的一个而不是接受所有license。-->

    <licenses>

        <!--描述了项目的license，用于生成项目的web站点的license页面，其他一些报表和validation也会用到该元素。-->