课程表

Maven课程

工具箱
速查手册

Maven POM

当前位置：免费教程 » 软件/图像 » Maven

POM 代表工程对象模型。它是使用 Maven 工作时的基本组建，是一个 xml 文件。它被放在工程根目录下，文件命名为 pom.xml。

POM 包含了关于工程和各种配置细节的信息，Maven 使用这些信息构建工程。

POM 也包含了目标和插件。当执行一个任务或者目标时，Maven 会查找当前目录下的 POM，从其中读取所需要的配置信息，然后执行目标。能够在 POM 中设置的一些配置如下：

  • project dependencies
  • plugins
  • goals
  • build profiles
  • project version
  • developers
  • mailing list

在创建 POM 之前，我们首先确定工程组（groupId），及其名称（artifactId）和版本，在仓库中这些属性是工程的唯一标识。

POM 举例

  1. <project xmlns="http://maven.apache.org/POM/4.0.0"
  2.    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3.    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
  4.    http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5.    <modelVersion>4.0.0</modelVersion>
  7.    <groupId>com.companyname.project-group</groupId>
  8.    <artifactId>project</artifactId>
  9.    <version>1.0</version>
  11. </project>

需要说明的是每个工程应该只有一个 POM 文件。

  • 所有的 POM 文件需要 project 元素和三个必须的字段：groupId, artifactId,version。
  • 在仓库中的工程标识为 groupId:artifactId:version
  • POM.xml 的根元素是 project，它有三个主要的子节点：
节点 描述
groupId 这是工程组的标识。它在一个组织或者项目中通常是唯一的。例如，一个银行组织 com.company.bank 拥有所有的和银行相关的项目。
artifactId 这是工程的标识。它通常是工程的名称。例如，消费者银行。groupId 和 artifactId 一起定义了 artifact 在仓库中的位置。
version 这是工程的版本号。在 artifact 的仓库中，它用来区分不同的版本。例如：
com.company.bank:consumer-banking:1.0
com.company.bank:consumer-banking:1.1.

Super POM

所有的 POM 都继承自一个父 POM（无论是否显式定义了这个父 POM）。父 POM 也被称作 Super POM，它包含了一些可以被继承的默认设置。

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

查看 Super POM 默认配置的一个简单方法是执行以下命令：mvn help:effective-pom

在你的电脑上的任意目录下创建一个 pom.xml 文件，使用上面提到的示例 pom 中的内容。

在下面的例子中，我们在 C:\MVN\project 目录中创建了一个 pom.xml 文件。

现在打开命令控制台，到 pom.xml 所在的目录下执行以下 mvn 命令。

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

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

  1. [INFO] Scanning for projects...
  2. [INFO] Searching repository for plugin with prefix: 'help'.
  3. [INFO] ------------------------------------------------------------------------
  4. [INFO] Building Unnamed - com.companyname.project-group:project-name:jar:1.0
  5. [INFO]    task-segment: [help:effective-pom] (aggregator-style)
  6. [INFO] ------------------------------------------------------------------------
  7. [INFO] [help:effective-pom {execution: default-cli}]
  8. [INFO]
  10. .....
  12. [INFO] ------------------------------------------------------------------------
  13. [INFO] BUILD SUCCESSFUL
  14. [INFO] ------------------------------------------------------------------------
  15. [INFO] Total time: < 1 second
  16. [INFO] Finished at: Thu Jul 05 11:41:51 IST 2012
  17. [INFO] Final Memory: 6M/15M
  18. [INFO] ------------------------------------------------------------------------

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

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- ================================================================= -->
  3. <!--                                                                   -->
  4. <!-- Generated by Maven Help Plugin on 2012-07-05T11:41:51             -->
  5. <!-- See: http://maven.apache.org/plugins/maven-help-plugin/           -->
  6. <!--                                                                   -->
  7. <!-- ================================================================= -->
  9. <!-- ================================================================= -->
  10. <!--                                                                   -->
  11. <!-- Effective POM for project                                         -->
  12. <!-- 'com.companyname.project-group:project-name:jar:1.0'              -->
  13. <!--                                                                   -->
  14. <!-- ================================================================= -->
  16. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/
  17. 2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 h
  18. ttp://maven.apache.org/xsd/maven-4.0.0.xsd">
  19.   <modelVersion>4.0.0</modelVersion>
  20.   <groupId>com.companyname.project-group</groupId>
  21.   <artifactId>project</artifactId>
  22.   <version>1.0</version>
  23.   <build>
  24.     <sourceDirectory>C:\MVN\project\src\main\java</sourceDirectory>
  25.     <scriptSourceDirectory>src/main/scripts</scriptSourceDirectory>
  26.     <testSourceDirectory>C:\MVN\project\src\test\java</testSourceDirectory>
  27.     <outputDirectory>C:\MVN\project\target\classes</outputDirectory>
  28.     <testOutputDirectory>C:\MVN\project\target\test-classes</testOutputDirectory>
  29.     <resources>
  30.       <resource>
  31.         <mergeId>resource-0</mergeId>
  32.         <directory>C:\MVN\project\src\main\resources</directory>
  33.       </resource>
  34.     </resources>
  35.     <testResources>
  36.       <testResource>
  37.         <mergeId>resource-1</mergeId>
  38.         <directory>C:\MVN\project\src\test\resources</directory>
  39.       </testResource>
  40.     </testResources>
  41.     <directory>C:\MVN\project\target</directory>
  42.     <finalName>project-1.0</finalName>
  43.     <pluginManagement>
  44.       <plugins>
  45.         <plugin>
  46.           <artifactId>maven-antrun-plugin</artifactId>
  47.           <version>1.3</version>
  48.         </plugin>
  49.         <plugin>
  50.           <artifactId>maven-assembly-plugin</artifactId>
  51.           <version>2.2-beta-2</version>
  52.         </plugin>
  53.         <plugin>
  54.           <artifactId>maven-clean-plugin</artifactId>
  55.           <version>2.2</version>
  56.         </plugin>
  57.         <plugin>
  58.           <artifactId>maven-compiler-plugin</artifactId>
  59.           <version>2.0.2</version>
  60.         </plugin>
  61.         <plugin>
  62.           <artifactId>maven-dependency-plugin</artifactId>
  63.           <version>2.0</version>
  64.         </plugin>
  65.         <plugin>
  66.           <artifactId>maven-deploy-plugin</artifactId>
  67.           <version>2.4</version>
  68.         </plugin>
  69.         <plugin>
  70.           <artifactId>maven-ear-plugin</artifactId>
  71.           <version>2.3.1</version>
  72.         </plugin>
  73.         <plugin>
  74.           <artifactId>maven-ejb-plugin</artifactId>
  75.           <version>2.1</version>
  76.         </plugin>
  77.         <plugin>
  78.           <artifactId>maven-install-plugin</artifactId>
  79.           <version>2.2</version>
  80.         </plugin>
  81.         <plugin>
  82.           <artifactId>maven-jar-plugin</artifactId>
  83.           <version>2.2</version>
  84.         </plugin>
  85.         <plugin>
  86.           <artifactId>maven-javadoc-plugin</artifactId>
  87.           <version>2.5</version>
  88.         </plugin>
  89.         <plugin>
  90.           <artifactId>maven-plugin-plugin</artifactId>
  91.           <version>2.4.3</version>
  92.         </plugin>
  93.         <plugin>
  94.           <artifactId>maven-rar-plugin</artifactId>
  95.           <version>2.2</version>
  96.         </plugin>
  97.         <plugin>
  98.           <artifactId>maven-release-plugin</artifactId>
  99.           <version>2.0-beta-8</version>
  100.         </plugin>
  101.         <plugin>
  102.           <artifactId>maven-resources-plugin</artifactId>
  103.           <version>2.3</version>
  104.         </plugin>
  105.         <plugin>
  106.           <artifactId>maven-site-plugin</artifactId>
  107.           <version>2.0-beta-7</version>
  108.         </plugin>
  109.         <plugin>
  110.           <artifactId>maven-source-plugin</artifactId>
  111.           <version>2.0.4</version>
  112.         </plugin>
  113.         <plugin>
  114.           <artifactId>maven-surefire-plugin</artifactId>
  115.           <version>2.4.3</version>
  116.         </plugin>
  117.         <plugin>
  118.           <artifactId>maven-war-plugin</artifactId>
  119.           <version>2.1-alpha-2</version>
  120.         </plugin>
  121.       </plugins>
  122.     </pluginManagement>
  123.     <plugins>
  124.       <plugin>
  125.         <artifactId>maven-help-plugin</artifactId>
  126.         <version>2.1.1</version>
  127.       </plugin>
  128.     </plugins>
  129.   </build>
  130.   <repositories>
  131.     <repository>
  132.       <snapshots>
  133.         <enabled>false</enabled>
  134.       </snapshots>
  135.       <id>central</id>
  136.       <name>Maven Repository Switchboard</name>
  137.       <url>http://repo1.maven.org/maven2</url>
  138.     </repository>
  139.   </repositories>
  140.   <pluginRepositories>
  141.     <pluginRepository>
  142.       <releases>
  143.         <updatePolicy>never</updatePolicy>
  144.       </releases>
  145.       <snapshots>
  146.         <enabled>false</enabled>
  147.       </snapshots>
  148.       <id>central</id>
  149.       <name>Maven Plugin Repository</name>
  150.       <url>http://repo1.maven.org/maven2</url>
  151.     </pluginRepository>
  152.   </pluginRepositories>
  153.   <reporting>
  154.     <outputDirectory>C:\MVN\project\target/site</outputDirectory>
  155.   </reporting>
  156. </project>

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

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

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

详细内容请参考 Maven - 插件 和 Maven - 创建工程 部分的内容。

转载本站内容时，请务必注明来自W3xue，违者必究。
 友情链接：直通硅谷 　点职佳 　北美留学生论坛

本站QQ群：前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

W3xue 的所有内容仅供测试，对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接（目前9元/月）请联系QQ：27243702 沸活量
皖ICP备17017327号-2　皖公网安备34020702000426号