Maven POM 官方[中文]介绍

原英文文档地址：Introduction to the POM

1. 什么是POM？

POM(project object model)包含了工程信息和工程的配置细节，Maven使用POM文件来构建工程。POM文件包含了工程中的大部分默认值。举个例子，target是默认的构建目录，src/main/java是默认的源码目录，src/test/java是默认的测试源码目录，等等。

Maven2中的pom.xml就是Maven1中的project.xml。相比于在maven.xml中包含可执行的goal，现在goals和plugins都可以在pom.xml中配置。当执行一个task或者goal时，Maven会在当前目录下寻找并读取pom.xml来获取配置信息，然后执行goal。

能在pom.xml中声明的配置包括工程依赖(project dependencies)，插件(plugins)，可执行的目标(goals)，构建配置(build profiles)等等。其他信息，比如工程版本，描述，开发者，邮件列表等等也可以在pox.xml中声明。

2. Super POM

Super POM是Maven的默认POM文件，除非你显示的声明继承关系，否则所有的POM文件都是在Super POM的基础上的扩展，也就是说，Super POM中的的配置会被你的工程中创建的pom.xml继承。

Maven 2.0.x中的Super POM代码如下：


  4.0.0
  Maven Default Project
 
  
    
      central
      Maven Repository Switchboard
      default
      http://repo1.maven.org/maven2
      
        false
      
    
  
 
  
    
      central
      Maven Plugin Repository
      http://repo1.maven.org/maven2
      default
      
        false
      
      
        never
      
    
  
 
  
    target
    target/classes
    ${artifactId}-${version}
    target/test-classes
    src/main/java
    src/main/scripts
    src/test/java
    
      
        src/main/resources
      
    
    
      
        src/test/resources
      
    
  
 
  
    target/site
  
 
  
    
      release-profile
 
      
        
          performRelease
        
      
 
      
        
          
            true
            org.apache.maven.plugins
            maven-source-plugin
 
            
              
                attach-sources
                
                  jar
                
              
            
          
          
            true
            org.apache.maven.plugins
            maven-javadoc-plugin
 
            
              
                attach-javadocs
                
                  jar
                
              
            
          
          
            true
            org.apache.maven.plugins
            maven-deploy-plugin
 
            
              true

下面是Maven 2.1.x的Super POM:*


  4.0.0
  Maven Default Project
 
  
    
      central
      Maven Repository Switchboard
      default
      http://repo1.maven.org/maven2
      
        false
      
    
  
 
  
    
      central
      Maven Plugin Repository
      http://repo1.maven.org/maven2
      default
      
        false
      
      
        never
      
    
  
 
  
    ${project.basedir}/target
    ${project.build.directory}/classes
    ${project.artifactId}-${project.version}
    ${project.build.directory}/test-classes
    ${project.basedir}/src/main/java
    
    src/main/scripts
    ${project.basedir}/src/test/java
    
      
        ${project.basedir}/src/main/resources
      
    
    
      
        ${project.basedir}/src/test/resources
      
    
   
       
         
           maven-antrun-plugin
           1.3
                
         
           maven-assembly-plugin
           2.2-beta-2
                  
         
           maven-clean-plugin
           2.2
         
         
           maven-compiler-plugin
           2.0.2
         
         
           maven-dependency-plugin
           2.0
         
         
           maven-deploy-plugin
           2.4
         
         
           maven-ear-plugin
           2.3.1
         
         
           maven-ejb-plugin
           2.1
         
         
           maven-install-plugin
           2.2
         
         
           maven-jar-plugin
           2.2
         
         
           maven-javadoc-plugin
           2.5
         
         
           maven-plugin-plugin
           2.4.3
         
         
           maven-rar-plugin
           2.2
                 
                         
           maven-release-plugin
           2.0-beta-8
         
                         
           maven-resources-plugin
           2.3
         
         
           maven-site-plugin
           2.0-beta-7
         
         
           maven-source-plugin
           2.0.4
                  
         
            maven-surefire-plugin
            2.4.3
         
         
           maven-war-plugin
           2.1-alpha-2
         
       
     
  
 
  
    ${project.build.directory}/site
  
  
    
      release-profile
 
      
        
          performRelease
          true
        
      
 
      
        
          
            true
            org.apache.maven.plugins
            maven-source-plugin
            
              
                attach-sources
                
                  jar
                
              
            
          
          
            true
            org.apache.maven.plugins
            maven-javadoc-plugin
            
              
                attach-javadocs
                
                  jar
                
              
            
          
          
            true
            org.apache.maven.plugins
            maven-deploy-plugin
            
              true

3. 最小化POM

一个最小化的POM文件的要求如下：

project 标签作为顶层标签
modelVersion – 应该设为4.0.0
groupId – 工程开发组的唯一id
artifactId – 工件(artifact)或工程(projrct)的唯一id
version – 版本号

这里是一个最小化POM的例子：


  4.0.0
  com.mycompany.app
  my-app
  1

说明：

在POM文件中需要声明 groupId , artifactId 和 version 。这三个值以::的形式声明，它们组成了工程的完整名称。比如上面的例子，完整名称为”com.mycompany.app:my-app1″。

如第一节所说，如果配置细节没有显示的设置，Maven将会使用继承自Super POM默认配置。其中一个默认值就是包的类型(packaging type)，每个Maven工程都有一个包类型，如果没有在POM中设置，则默认为”jar”。

前面的Minimal POM中，其中 repositories 这个值没有设置，如果你使用minimal POM来构建你的工程，它将使用继承Super POM中的 repositories 值(http://repo.maven.apache.org/maven2)，当Maven在POM中找到依赖，它就会去这个地址下载依赖包。

4. 工程继承

POM中可配置的元素如下：

依赖 (dependencies)
开发者和贡献者 (developers and contributors)
插件列表，包括报告 (plugin lists, including reports)
相应id的插件执行 (plugin executions with matching ids)
插件配置 (plugin configuration)
资源 (resources)

Super POM就是一个工程继承的例子。你也可以通过在POM中指定parent element来引入你自己的POM作为基础。就像下面的例子：

Example 1

情景
在这个例子中，我们还是沿用com.mycompany.app:my-app:1这个名称。现在让我们引入另一个工件，com.mycompany.app:my-module:1.


  4.0.0
  com.mycompany.app
  my-module
  1

指定它们的目录结构如下：

.
 |-- my-module
 |   `-- pom.xml
 `-- pom.xml

注意： my-module/pom.xml 是com.mycompany.app:my-module:1 的POM文件，而 pom.xml 是com.mycompany.app:my-app:1的POM文件。
解决方案：现在，如果我们将com.mycompany.app:my-app:1指定为com.mycompany.app:my-module:1的父工件(parent artifact)，我们需要修改com.mycompany.app:my-module:1的POM文件如下：


  
    com.mycompany.app
    my-app
    1
  
  4.0.0
  com.mycompany.app
  my-module
  1

注意： 我们需要添加一个parent结点，这个结点允许我们指定当前POM的父POM。通过指定父POM的完整名称(即groupId,artifactId,version这三个标签)，我们的模块(module)就能够继承父POM中的属性了。
另外，如果我们希望groupId和模块的version和他们的parents相同，你可以移除当前模块POM中的groupId和version标签。


  
    com.mycompany.app
    my-app
    1
  
  4.0.0
  my-module

这样做可以让当前模块集成父POM的groupid和version。

Example 2

情景
在父工程已经安装在本地仓库或指定目录结构(父POM是模块POM的上一级目录)中时，这样做是可以得。
但是如果父工程没有安装或者是像这样的目录机构呢？

.
 |-- my-module
 |   `-- pom.xml
 `-- parent
     `-- pom.xml

解决方案：为了修正这个目录结构，我们将在parent结点中添加元素。


  
    com.mycompany.app
    my-app
    1
    ../parent/pom.xml
  
  4.0.0
  my-module

顾名思义，这个元素指定了从模块POM到其父POM的相对路径。

5. 工程聚合

工程聚合和工程继承很相似，但不是从子模块指定父POM，而是从父POM指定子模块。这样做的话，父工程就知道子模块的存在了，而且如果Maven命令从父工程调用，在子模块中也能顺利执行。工程聚合要求如下做法：

将父POM的packageing属性设为”pom”
在父POM中指定模块的目录(子POM)

Example 3

情景
还是上次的POM和目录结构
com.mycompany.app:my-app:1’s POM


  4.0.0
  com.mycompany.app
  my-app
  1

com.mycompany.app:my-module:1’s POM


  4.0.0
  com.mycompany.app
  my-module
  1

directory structure

.
 |-- my-module
 |   `-- pom.xml
 `-- pom.xml

解决方案： 如果我们准备将my-module聚合进my-app中，我们只需要修改my-app。


  4.0.0
  com.mycompany.app
  my-app
  1
  pom
 
  
    my-module

在修改后的POM中，增加了packaging部分和模块部分，packaging的值设为”pom”，模块部分增加了my-module。的值是com.mycompany.app:my-app:1到com.mycompany.app:my-module:1的POM的相对路径(练习中，我们用模块的artifactId作为目录名称)。

现在，当Maven命令在com.mycompany.app:my-app:1中执行时，同样的明明也会在com.mycompany.app:my-module:1中执行。此外，有些命令(goals soecifically)以不同的方式处理工程聚合的情况。

Example 4

情景
如果我们将目录结构改成这样

.
|-- my-module
|   `-- pom.xml
`-- parent
`-- pom.xml

父POM又该如何指定子模块呢？
解决方案：答案是 – 跟Example 3一样，指定路径就好了。


  4.0.0
  com.mycompany.app
  my-app
  1
  pom
 
  
    ../my-module

6. 工程继承与工程聚合

如果你有好几个Maven 工程，并且这些工程有着相似的配置，你可以通过将相同的配置放到一个父工程中来重构。这样的话，你所要做的就是让你的Maven工程继承这个父工程，这些配置就能在所有的工程中通用了。

如果你有一组工程一起构建和运行，你可以创建一个父工程，并在父工程中声明这些工程为它的模块，这样做，你只要构建父工程，子工程也会随之构建。

当然，你可以同时做工程继承和工程聚合。这意味着，你可以为你的所有模块指定一个父工程，同时，父工程中可以指定其余的Maven工程为它的子模块。你只需要应用这三条规则：

在所有子POM中指定它们的父POM。

将父POM的packaging元素的值设为”pom”。

在父POM中指定子模块(子POM)的目录。

Example 5

情景
还是上次的POM，
com.mycompany.app:my-app:1’s POM


  4.0.0
  com.mycompany.app
  my-app
  1

com.mycompany.app:my-module:1’s POM


  4.0.0
  com.mycompany.app
  my-module
  1

目录结构

.
|-- my-module
|   `-- pom.xml
`-- parent
`-- pom.xml

解决方案： 同时做工程继承和工程聚合，你只要应用三条法则。

com.mycompany.app:my-app:1’s POM


  4.0.0
  com.mycompany.app
  my-app
  1
  pom
 
  
    ../my-module

com.mycompany.app:my-module:1’s POM


  
    com.mycompany.app
    my-app
    1
    ../parent/pom.xml
  
  4.0.0
  my-module

注意：配置继承的策略与POM继承的策略相同

7. 工程改写和变量

Maven鼓励的做法是不要做重复的工作(don’t repeat yourself)。但总有在不同的地方使用相同属性的情况。为了确保属性值指定一次，Maven允许你在POM使用你自己的变量或者预先定义的变量。

举个例子，为了使用 project.version 这个变量，你可以这样引用：

${project.version}

要注意的是这些变量在继承之后才会被处理。这意味着如果一个父工程使用了一个变量，它们在子工程中的定义与在父工程中的定义会不一样，是最后使用的那个。

可用的变量

工程模型变量

一个Model的任何字段都是一个单独的可以做为变量引用的值元素。例如， ${project.groupId} , ${project.version} , ${project.build.sourceDirectory} 等等。参考POM reference 列举的全部属性。这些变量都用 project. 前缀来引用。你可以看看pom. 参考，或者完全省略前缀 – 这些形式现在已经废弃不再使用了。

特殊变量

变量值	说明
project.basedir	当前工程所在的目录
project.baseUri	当前工程所在的目录，表示为一个URI，Maven 2.1.0之后
maven.build.timestamp	时间戳，表示开始构建的时间，Maven 2.1.0-M1之后

构建时间戳的格式可以在maven.build.timestamp.format属性中自定义，示例如下：


  ...
  
    yyyy-MM-dd'T'HH:mm:ss'Z'
  
  ...

格式化模式必须遵守API文档中给出的规则。如果这个属性不存在，默认值就是示例中给出的值.

属性
你同样可以将任何在工程中定义的属性作为变量引用，看看下面的例子：


  ...
  
    2.1
  
  
    
      org.apache.maven
      maven-artifact
      ${mavenVersion}
    
    
      org.apache.maven
      maven-project
      ${mavenVersion}
    
  
  ...

Maven POM 官方[中文]介绍

1. 什么是POM？

2. Super POM

3. 最小化POM

4. 工程继承

Example 1

Example 2

5. 工程聚合

Example 3

Example 4

6. 工程继承与工程聚合

Example 5

7. 工程改写和变量

可用的变量

工程模型变量

特殊变量

你可能感兴趣的:(Maven POM 官方[中文]介绍)