php教程分享

Maven POM

•Maven•阅读

POM( Project Object Model，项目对象模型 ) 是 Maven 工程的基本工作单元，是一个XML文件，包含了项目的基本信息，用于描述项目如何构建，声明项目依赖，等等。

执行任务或目标时，Maven 会在当前目录中查找 POM。它读取 POM，获取所需的配置信息，然后执行目标。

POM 中可以指定以下配置：

  • 项目依赖
  • 插件
  • 执行目标
  • 项目构建 profile
  • 项目版本
  • 项目开发者列表
  • 相关邮件列表信息

在创建 POM 之前，我们首先需要描述项目组 (groupId), 项目的唯一ID。

<projectxmlns = "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"><!-- 模型版本 --><modelVersion>4.0.0</modelVersion><!-- 公司或者组织的唯一标志，并且配置时生成的路径也是由此生成， 如com.companyname.project-group，maven会将该项目打成的jar包放本地路径：/com/companyname/project-group --><groupId>com.companyname.project-group</groupId><!-- 项目的唯一ID，一个groupId下面可能多个项目，就是靠artifactId来区分的 --><artifactId>project</artifactId><!-- 版本号 --><version>1.0</version></project>

所有 POM 文件都需要 project 元素和三个必需字段：groupId，artifactId，version。

节点描述
project工程的根标签。
modelVersion模型版本需要设置为 4.0。
groupId这是工程组的标识。它在一个组织或者项目中通常是唯一的。例如，一个银行组织 com.companyname.project-group 拥有所有的和银行相关的项目。
artifactId这是工程的标识。它通常是工程的名称。例如，消费者银行。groupId 和 artifactId 一起定义了 artifact 在仓库中的位置。
version

这是工程的版本号。在 artifact 的仓库中，它用来区分不同的版本。例如：

com.company.bank:consumer-banking:1.0
com.company.bank:consumer-banking:1.1

父（Super）POM

父（Super）POM是 Maven 默认的 POM。所有的 POM 都继承自一个父 POM（无论是否显式定义了这个父 POM）。父 POM 包含了一些可以被继承的默认设置。因此，当 Maven 发现需要下载 POM 中的 依赖时，它会到 Super POM 中配置的默认仓库 http://repo1.maven.org/maven2 去下载。

Maven 使用 effective pom（Super pom 加上工程自己的配置）来执行相关的目标，它帮助开发者在 pom.xml 中做尽可能少的配置，当然这些配置可以被重写。

使用以下命令来查看 Super POM 默认配置：

mvn help:effective-pom

接下来我们创建目录 MVN/project，在该目录下创建 pom.xml，内容如下：

<projectxmlns = "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"><!-- 模型版本 --><modelVersion>4.0.0</modelVersion><!-- 公司或者组织的唯一标志，并且配置时生成的路径也是由此生成， 如com.companyname.project-group，maven会将该项目打成的jar包放本地路径：/com/companyname/project-group --><groupId>com.companyname.project-group</groupId><!-- 项目的唯一ID，一个groupId下面可能多个项目，就是靠artifactId来区分的 --><artifactId>project</artifactId><!-- 版本号 --><version>1.0</version></project>

在命令控制台，进入 MVN/project 目录，执行以下命令：

C:\MVN\project>mvn help:effective-pom

Maven 将会开始处理并显示 effective-pom。

[INFO] Scanning for projects...
Downloading: https://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-clean-plugin/2.5/maven-clean-plugin-2.5.pom
...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:36 min
[INFO] Finished at: 2018-09-05T11:31:28+08:00
[INFO] Final Memory: 15M/149M
[INFO] ------------------------------------------------------------------------

Effective POM 的结果就像在控制台中显示的一样，经过继承、插值之后，使配置生效。

<?xmlversion="1.0"encoding="UTF-8"?><!-- ================================================================= --><!----><!-- Generated by Maven Help Plugin on 2012-07-05T11:41:51 --><!-- See: http://maven.apache.org/plugins/maven-help-plugin/ --><!----><!-- ================================================================= --><!-- ================================================================= --><!----><!-- Effective POM for project --><!-- 'com.companyname.project-group:project-name:jar:1.0' --><!----><!-- ================================================================= --><projectxmlns="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 h ttp://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.companyname.project-group</groupId><artifactId>project</artifactId><version>1.0</version><build><sourceDirectory>C:\MVN\project\src\main\java</sourceDirectory><scriptSourceDirectory>src/main/scripts</scriptSourceDirectory><testSourceDirectory>C:\MVN\project\src\test\java</testSourceDirectory><outputDirectory>C:\MVN\project\target\classes</outputDirectory><testOutputDirectory>C:\MVN\project\target\test-classes</testOutputDirectory><resources><resource><mergeId>resource-0</mergeId><directory>C:\MVN\project\src\main\resources</directory></resource></resources><testResources><testResource><mergeId>resource-1</mergeId><directory>C:\MVN\project\src\test\resources</directory></testResource></testResources><directory>C:\MVN\project\target</directory><finalName>project-1.0</finalName><pluginManagement><plugins><plugin><artifactId>maven-antrun-plugin</artifactId><version>1.3</version></plugin><plugin><artifactId>maven-assembly-plugin</artifactId><version>2.2-beta-2</version></plugin><plugin><artifactId>maven-clean-plugin</artifactId><version>2.2</version></plugin><plugin><artifactId>maven-compiler-plugin</artifactId><version>2.0.2</version></plugin><plugin><artifactId>maven-dependency-plugin</artifactId><version>2.0</version></plugin><plugin><artifactId>maven-deploy-plugin</artifactId><version>2.4</version></plugin><plugin><artifactId>maven-ear-plugin</artifactId><version>2.3.1</version></plugin><plugin><artifactId>maven-ejb-plugin</artifactId><version>2.1</version></plugin><plugin><artifactId>maven-install-plugin</artifactId><version>2.2</version></plugin><plugin><artifactId>maven-jar-plugin</artifactId><version>2.2</version></plugin><plugin><artifactId>maven-javadoc-plugin</artifactId><version>2.5</version></plugin><plugin><artifactId>maven-plugin-plugin</artifactId><version>2.4.3</version></plugin><plugin><artifactId>maven-rar-plugin</artifactId><version>2.2</version></plugin><plugin><artifactId>maven-release-plugin</artifactId><version>2.0-beta-8</version></plugin><plugin><artifactId>maven-resources-plugin</artifactId><version>2.3</version></plugin><plugin><artifactId>maven-site-plugin</artifactId><version>2.0-beta-7</version></plugin><plugin><artifactId>maven-source-plugin</artifactId><version>2.0.4</version></plugin><plugin><artifactId>maven-surefire-plugin</artifactId><version>2.4.3</version></plugin><plugin><artifactId>maven-war-plugin</artifactId><version>2.1-alpha-2</version></plugin></plugins></pluginManagement><plugins><plugin><artifactId>maven-help-plugin</artifactId><version>2.1.1</version></plugin></plugins></build><repositories><repository><snapshots><enabled>false</enabled></snapshots><id>central</id><name>Maven Repository Switchboard</name><url>http://repo1.maven.org/maven2</url></repository></repositories><pluginRepositories><pluginRepository><releases><updatePolicy>never</updatePolicy></releases><snapshots><enabled>false</enabled></snapshots><id>central</id><name>Maven Plugin Repository</name><url>http://repo1.maven.org/maven2</url></pluginRepository></pluginRepositories><reporting><outputDirectory>C:\MVN\project\target/site</outputDirectory></reporting></project>

在上面的 pom.xml 中，你可以看到 Maven 在执行目标时需要用到的默认工程源码目录结构、输出目录、需要的插件、仓库和报表目录。

Maven 的 pom.xml 文件也不需要手工编写。

Maven 提供了大量的原型插件来创建工程，包括工程结构和 pom.xml。

POM 标签大全详解

<projectxmlns="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.0http://maven.apache.org/maven-v4_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
赞 (0)

相关推荐