maven之pom.xml配置文件详解-白红宇

maven之pom.xml配置文件详解

阅读量：4045 次

发布时间：2019-05-24

本文共 8382 字，大约阅读时间需要 27 分钟。

一、什么是pom

pom代表项目对象模型，它是Maven中工作的基本组成单位。它是一个XML文件，始终保存在项目的基本目录中的pom.xml文件中。pom包含的对象是使用maven来构建的，pom.xml文件包含了项目的各种配置信息。创建一个POM之前，应该要先决定项目组(groupId)，项目名(artifactId)和版本（version），因为这些属性在项目仓库是唯一标识的。需要特别注意，每个项目都只有一个pom.xml文件。

二、pom中的节点分布如下

三、各节点解释说明

1.基本配置信息


      
       
    
     4.0.0
       
       
    
     com.company.bank
       
       
    
     parent
       
       
    
     1.0
       
       
    
     war

节点	解释说明
modelVersion	pom模型版本，maven2和3只能为4.0.0
groupId	这是项目组的编号，这在组织或项目中通常是独一无二的。例如，一家银行集团com.company.bank拥有所有银行相关项目。
artifactId	这是项目的ID。这通常是项目的名称。例如，consumer-banking。除了groupId之外，artifactId还定义了artifact在存储库中的位置。
version	这是项目的版本。与groupId一起使用，artifact在存储库中用于将版本彼此分离。例如：com.company.bank:consumer-banking:1.0，com.company.bank:consumer-banking:1.1
packaging	项目打包方式，有以下值：pom, jar, maven-plugin, ejb, war, ear, rar, par

2.依赖配置

(1) dependencies

项目相关依赖配置，如果在父项目写的依赖，会被子项目引用。一般会在父项目中定义子项目中所有共用的依赖。

（2）parent

用于确定父项目的坐标位置。


       
    
     com.learnPro
        
    
     SIP-parent
        
        
    
     0.0.1-SNAPSHOT

groupId: 父项目的组Id标识符

artifactId:父项目的唯一标识符

relativePath：Maven首先在当前项目中找父项目的pom，然后在文件系统的这个位置（relativePath），然后在本地仓库，再在远程仓库找。

version: 父项目的版本

(3) modules

有些maven项目会做成多模块的，这个标签用于指定当前项目所包含的所有模块。之后对这个项目进行的maven操作，会让所有子模块也进行相同操作。


      
    
     com-a   
     
      com-b   
      
       com-c

(4) properties

用于定义pom常量

1.7

上面这个常量可以在pom文件的任意地方通过${

.version}来引用

（5）dependencyManagement

配置写法同dependencies


       
    
         .....

在父模块中定义后，子模块不会直接使用对应依赖，但是在使用相同依赖的时候可以不加版本号,这样的好处是，父项目统一了版本，而且子项目可以在需要的时候才引用对应的依赖。

3.构建配置

reporting
该元素描述使用报表插件产生报表的规范。当用户执行“mvn site”，这些报表就会运行。在页面导航栏能看到所有报表的链接。

5.项目信息

name：给用户提供更为友好的项目名

description：项目描述，maven文档中保存

url：主页的URL，maven文档中保存

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

licenses：该元素描述了项目所有License列表。应该只列出该项目的-

license列表，不要列出依赖项目的 license列表。如果列出多个license，用户可以选择它们中的一个而不是接受所有license。（如下）

organization：1.name 组织名 2.url 组织主页url

developers：项目开发人员列表（如下）

contributors：项目其他贡献者列表，同developers

6.环境配置

issueManagement

目的问题管理系统(Bugzilla, Jira, Scarab)的名称和URL


       
    
     Bugzilla
        
    
     http://127.0.0.1/bugzilla/

ciManagement

项目的持续集成信息


       
    
     continuum
        
    
     http://127.0.0.1:8080/continuum
        
          
             
      
       mail
              
      
       true
              
      
       true
              
      
       false
              
      
       false
              
      continuum@127.0.0.1

system：持续集成系统的名字

url：持续集成系统的URL

notifiers：构建完成时，需要通知的开发者/用户的配置项。包括被通知者信息和通知条件（错误，失败，成功，警告）
type：通知方式
sendOnError：错误时是否通知
sendOnFailure：失败时是否通知
sendOnSuccess：成功时是否通知
sendOnWarning：警告时是否通知
address：通知发送到的地址
configuration：扩展项

mailingLists

项目相关邮件列表信息


       
          
     
      User List
           
     
      user-subscribe@127.0.0.1
           
     
      user-unsubscribe@127.0.0.1
           
     
      user@127.0.0.1
           
     
      http://127.0.0.1/user/
           
             
      
       http://base.google.com/base/1/127.0.0.1
            
         
        .....

subscribe, unsubscribe: 订阅邮件（取消订阅）的地址或链接，如果是邮件地址，创建文档时，mailto: 链接会被自动创建

archive：浏览邮件信息的URL

post：接收邮件的地址

scm

许你配置你的代码库，供Maven web站点和其它插件使用


       
    
     scm:svn:http://127.0.0.1/svn/my-project
        
    
     scm:svn:https://127.0.0.1/svn/my-project
        
    
     HEAD
        
    
     http://127.0.0.1/websvn/my-project

connection, developerConnection：这两个表示我们如何连接到maven的版本库。connection只提供读，developerConnection将提供写的请求
写法如：scm:[provider]:[provider_specific]
如果连接到CVS仓库，可以配置如下：-

scm:cvs:pserver:127.0.0.1:/cvs/root:my-project

tag：项目标签，默认HEAD

url：共有仓库路径

prerequisites

项目构建的前提


       
    
     2.0.6

repositories,pluginRepositories

依赖和扩展的远程仓库列表，同上篇文章，setting.xml配置中介绍的。


       
          
             
      
       false
              
      
       always
              
      
       warn
            
           
             
      
       true
              
      
       never
              
      
       fail
            
           
     
      codehausSnapshots
           
     
      Codehaus Snapshots
           
     
      http://snapshots.maven.codehaus.org/maven2
           
     
      default
         
      
     
   
        ...