pom.xml之 超级POM

POM

Maven项目,依赖,构建配置,以及构件:所有这些都是要建模和表述的对象。这些对象通过一个名为项目对象模型(Project Object Model,POM)的XML文件描述。这个POM告诉Maven它正处理什么类型的项目,如何修改默认的行为来从源码生成输出。同样的方式,一个Java Web应用有一个web.xml文件来描述,配置,及自定义该应用,一个Maven项目则通过一个pom.xml文件定义。该文件是Maven中一个项目的描述性陈述;也是当Maven构建项目的时候需要理解的一份“地图”。

你可以将pom.xml看成是类似于Makefile或者Ant中的build.xml。当你使用GNUmake 来构建诸如MySQL软件的时候,你通常会有一个名为Makefile的文件,它包含了显式的指令来清理,编译,打包以及部署一个应用。在这一点上,Make,Ant,和Maven是相似的,它们都依赖于一个统一命名的文件如Makefilebuild.xml,或者pom.xml,但相似的地方也仅此而已。如果你看一下Maven的pom.xmlPOM的主要内容是处理描述信息:哪里存放源代码?哪里存放资源文件?打包方式是什么?如果你看一下Ant的build.xml文件,你会看到完全不同的东西。那里有显式的指令来执行一些任务,如编译一组Java类。Maven的POM是声明性的,虽然你可以通过Maven Ant插件来引入一些过程式的自定义指令,但大部分时间里,你不需要去了解项目构建的过程细节。

POM也不只是仅仅针对于构建Java项目。虽然本书的大部分样例都是Java应用,但是在Maven的项目对象模型定义中没有任何Java特定的东西。虽然Maven的默认插件是从一组源码,测试,和资源来构建一个JAR文件。但你同样可以为一个包含C#源码,使用微软工具处理一些微软私有的二进制文件的项目来定义一个POM。类似的,你也可以为一本技术书籍定义一个POM。事实上,本书的源码和本书的样例正是用一个Maven多模块项目组织的,我们使用一个Maven Docbook插件,将标准的Docbook XSL应用到一系列章节的XML文件上。还有人编写了Maven插件来将Adobe Flex代码构建成SWCSWF,也还有人使用了Maven来构建C编写的项目。

我们已经确定了POM是描述性和声明性的,它不像Ant或者Make那样提供显式的指令,我们也注意到POM的概念不是特定于Java的。让我们深入更多的细节,看一下Figure 9.1, “项目对象模型”,纵览一下POM的内容。

项目对象模型

Figure 9.1. 项目对象模型


POM包含了四类描述和配置:

项目总体信息

它包含了一个项目的而名称,项目URL,发起组织,以及项目的开发者贡献者列表和许可证。

构建设置

在这一部分,我们自定义Maven构建的默认行为。我们可以更改源码和测试代码的位置,可以添加新的插件,可以将插件目标绑定到生命周期,我们还可以自定义站点生成参数。

构建环境

构建环境包含了一些能在不同使用环境中 激活的profile。例如,在开发过程中你可能会想要将应用部署到一个而开发服务器上,而在产品环境中你会需要将应用部署到产品服务器上。构建环境为特定的环境定制了构建设置,通常它还会由~/.m2中的自定义settings.xml补充。这个settings文件将会在Chapter 11,构建Profile中,以及Section A.1, “简介”中的Appendix A,附录: Settings细节小节中讨论。

POM关系

一个项目很少孤立存在;它会依赖于其它项目,可能从父项目继承POM设置,它要定义自身的坐标,可能还会包含子模块。

9.2.1. 超级POM

在深入钻研一些样例POM之前,让我们先快速看一下超级POM。所有的Maven项目的POM都扩展自超级POM。超级POM定义了一组被所有项目共享的默认设置。它是Maven安装的一部分,可以在/usr/local/maven/lib中的maven-2.0.9-uber.jar文件中找到。如果你看一下这个JAR文件,你会看到在包org.apache.maven.project下看到一个名为pom-4.0.0.xml的文件。这个Maven的超级POMExample 9.1, “超级POM”所示。

Example 9.1. 超级POM

<span style="color: rgb(0, 128, 0);"><span style="font-size: 16px;"></span></span><span style="color: rgb(0, 128, 0);"><span style="font-size: 16px;"><<span class="hl-tag" style="color: blue;">project</span>
>

  <<span class="hl-tag" style="color: blue;">modelVersion</span>
>4.0.0<<span class="hl-tag" style="color: blue;">/modelVersion</span>
>

  <<span class="hl-tag" style="color: blue;">name</span>
>Maven Default Project<<span class="hl-tag" style="color: blue;">/name</span>
>



  <<span class="hl-tag" style="color: blue;">repositories</span>
>

    <<span class="hl-tag" style="color: blue;">repository</span>
>

      <<span class="hl-tag" style="color: blue;">id</span>
>central<<span class="hl-tag" style="color: blue;">/id</span>
> 

      <<span class="hl-tag" style="color: blue;">name</span>
>Maven Repository Switchboard<<span class="hl-tag" style="color: blue;">/name</span>
>

      <<span class="hl-tag" style="color: blue;">layout</span>
>default<<span class="hl-tag" style="color: blue;">/layout</span>
>

      <<span class="hl-tag" style="color: blue;">url</span>
>http://repo1.maven.org/maven2<<span class="hl-tag" style="color: blue;">/url</span>
>

      <<span class="hl-tag" style="color: blue;">snapshots</span>
>

        <<span class="hl-tag" style="color: blue;">enabled</span>
>false<<span class="hl-tag" style="color: blue;">/enabled</span>
>

      <<span class="hl-tag" style="color: blue;">/snapshots</span>
>

    <<span class="hl-tag" style="color: blue;">/repository</span>
>

  <<span class="hl-tag" style="color: blue;">/repositories</span>
>



  <<span class="hl-tag" style="color: blue;">pluginRepositories</span>
>

    <<span class="hl-tag" style="color: blue;">pluginRepository</span>
>

      <<span class="hl-tag" style="color: blue;">id</span>
>central<<span class="hl-tag" style="color: blue;">/id</span>
> 

      <<span class="hl-tag" style="color: blue;">name</span>
>Maven Plugin Repository<<span class="hl-tag" style="color: blue;">/name</span>
>

      <<span class="hl-tag" style="color: blue;">url</span>
>http://repo1.maven.org/maven2<<span class="hl-tag" style="color: blue;">/url</span>
>

      <<span class="hl-tag" style="color: blue;">layout</span>
>default<<span class="hl-tag" style="color: blue;">/layout</span>
>

      <<span class="hl-tag" style="color: blue;">snapshots</span>
>

        <<span class="hl-tag" style="color: blue;">enabled</span>
>false<<span class="hl-tag" style="color: blue;">/enabled</span>
>

      <<span class="hl-tag" style="color: blue;">/snapshots</span>
>

      <<span class="hl-tag" style="color: blue;">releases</span>
>

        <<span class="hl-tag" style="color: blue;">updatePolicy</span>
>never<<span class="hl-tag" style="color: blue;">/updatePolicy</span>
>

      <<span class="hl-tag" style="color: blue;">/releases</span>
>

    <<span class="hl-tag" style="color: blue;">/pluginRepository</span>
>

  <<span class="hl-tag" style="color: blue;">/pluginRepositories</span>
>



  <<span class="hl-tag" style="color: blue;">build</span>
> 

    <<span class="hl-tag" style="color: blue;">directory</span>
>target<<span class="hl-tag" style="color: blue;">/directory</span>
>

    <<span class="hl-tag" style="color: blue;">outputDirectory</span>
>target/classes<<span class="hl-tag" style="color: blue;">/outputDirectory</span>
>

    <<span class="hl-tag" style="color: blue;">finalName</span>
>content-zh-0.6-SNAPSHOT<<span class="hl-tag" style="color: blue;">/finalName</span>
>

    <<span class="hl-tag" style="color: blue;">testOutputDirectory</span>
>target/test-classes<<span class="hl-tag" style="color: blue;">/testOutputDirectory</span>
>

    <<span class="hl-tag" style="color: blue;">sourceDirectory</span>
>src/main/java<<span class="hl-tag" style="color: blue;">/sourceDirectory</span>
>

    <<span class="hl-tag" style="color: blue;">scriptSourceDirectory</span>
>src/main/scripts<<span class="hl-tag" style="color: blue;">/scriptSourceDirectory</span>
>

    <<span class="hl-tag" style="color: blue;">testSourceDirectory</span>
>src/test/java<<span class="hl-tag" style="color: blue;">/testSourceDirectory</span>
>

    <<span class="hl-tag" style="color: blue;">resources</span>
>

      <<span class="hl-tag" style="color: blue;">resource</span>
>

        <<span class="hl-tag" style="color: blue;">directory</span>
>src/main/resources<<span class="hl-tag" style="color: blue;">/directory</span>
>

      <<span class="hl-tag" style="color: blue;">/resource</span>
>

    <<span class="hl-tag" style="color: blue;">/resources</span>
>

    <<span class="hl-tag" style="color: blue;">testResources</span>
>

      <<span class="hl-tag" style="color: blue;">testResource</span>
>

        <<span class="hl-tag" style="color: blue;">directory</span>
>src/test/resources<<span class="hl-tag" style="color: blue;">/directory</span>
>

      <<span class="hl-tag" style="color: blue;">/testResource</span>
>

    <<span class="hl-tag" style="color: blue;">/testResources</span>
>

  <<span class="hl-tag" style="color: blue;">/build</span>
>



      <<span class="hl-tag" style="color: blue;">pluginManagement</span>
>

       <<span class="hl-tag" style="color: blue;">plugins</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-antrun-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>1.1<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>       

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-assembly-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.2-beta-1<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-clean-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.2<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-compiler-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.0.2<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-dependency-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.0<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-deploy-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.3<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-ear-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.3.1<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-ejb-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.1<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-install-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.2<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-jar-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.2<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-javadoc-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.4<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-plugin-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.3<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-rar-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.2<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>                

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-release-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.0-beta-7<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>                

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-resources-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.2<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-site-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.0-beta-6<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-source-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.0.4<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>         

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

            <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-surefire-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

            <<span class="hl-tag" style="color: blue;">version</span>
>2.4.2<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

         <<span class="hl-tag" style="color: blue;">plugin</span>
>

           <<span class="hl-tag" style="color: blue;">artifactId</span>
>maven-war-plugin<<span class="hl-tag" style="color: blue;">/artifactId</span>
>

           <<span class="hl-tag" style="color: blue;">version</span>
>2.1-alpha-1<<span class="hl-tag" style="color: blue;">/version</span>
>

         <<span class="hl-tag" style="color: blue;">/plugin</span>
>

       <<span class="hl-tag" style="color: blue;">/plugins</span>
>

     <<span class="hl-tag" style="color: blue;">/pluginManagement</span>
>

  

  <<span class="hl-tag" style="color: blue;">reporting</span>
>

    <<span class="hl-tag" style="color: blue;">outputDirectory</span>
>target/site<<span class="hl-tag" style="color: blue;">/outputDirectory</span>
>

  <<span class="hl-tag" style="color: blue;">/reporting</span>
>

<<span class="hl-tag" style="color: blue;">/project</span>
></span></span>

这个超级POM定义了一些由所有项目继承的标准配置变量。对这些变量的简单解释如下:

1

默认的超级POM定义了一个单独的远程Maven仓库,ID为central。这是所有Maven客户端默认配置访问的中央Maven仓库。该配置可以通过一个自定义的settings.xml文件来覆盖。注意这个默认的超级POM关闭了从中央Maven仓库下载snapshot构件的功能。如果你需要使用一个snapshot仓库,你就要在你的pom.xml或者settings.xml中自定义仓库设置。Settings和profile将会在Chapter 11,构建Profile中和Section A.1, “简介”中的Appendix A,附录: Settings细节小节中具体介绍。

2

中央Maven仓库同时也包含Maven插件。默认的插件仓库就是这个中央仓库。Snapshot被关闭了,而且更新策略被设置成了“从不”,这意味着Maven将永远不会自动更新一个插件,即使新版本的插件发布了。

3

build元素设置Maven标准目录布局中那些目录的默认值。

4

从Maven 2.0.9开始,超级POM为核心插件提供了默认版本。这么做是为那些没有在它们POM中指定插件版本的用户提供一些稳定性。

超级POM永远是最基础的父POM

Figure 9.2. 超级POM永远是最基础的父POM

  • 1
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值