本文节选翻译自apache的Maven入门教程Introduction to the POM
什么是POM
POM：Project Object Model. POM文件是Maven工程的最核心的文件。POM文件的格式是xml文件，它包含了项目的很多信息，Maven使用POM文件提供的配置信息来构建项目。Maven提供了一些默认配置:
| 含义 | 默认名称 |
| build directory | target |
| source directory | src/main/java |
| test source directory | src/test/java |
用户可以配置的Maven选项：
project dependencies(依赖)， the plugins, goals, build profiles等
另外还有 project versions, description, developers, mailing lists也可以被用户指定。
Super POM
Super POM是Maven的默认POM文件。除非用户显式设定，否则所有的POM文件都会继承Super POM文件中的内容。
Super POM 文件内容
1 <project>
2 <modelVersion>4.0.0</modelVersion>
3
4 <repositories>
5 <repository>
6 <id>central</id>
7 <name>Central Repository</name>
8 <url>https://repo.maven.apache.org/maven2</url>
9 <layout>default</layout>
10 <snapshots>
11 <enabled>false</enabled>
12 </snapshots>
13 </repository>
14 </repositories>
15
16 <pluginRepositories>
17 <pluginRepository>
18 <id>central</id>
19 <name>Central Repository</name>
20 <url>https://repo.maven.apache.org/maven2</url>
21 <layout>default</layout>
22 <snapshots>
23 <enabled>false</enabled>
24 </snapshots>
25 <releases>
26 <updatePolicy>never</updatePolicy>
27 </releases>
28 </pluginRepository>
29 </pluginRepositories>
30
31 <build>
32 <directory>${project.basedir}/target</directory>
33 <outputDirectory>${project.build.directory}/classes</outputDirectory>
34 <finalName>${project.artifactId}-${project.version}</finalName>
35 <testOutputDirectory>${project.build.directory}/test-classes</testOutputDirectory>
36 <sourceDirectory>${project.basedir}/src/main/java</sourceDirectory>
37 <scriptSourceDirectory>${project.basedir}/src/main/scripts</scriptSourceDirectory>
38 <testSourceDirectory>${project.basedir}/src/test/java</testSourceDirectory>
39 <resources>
40 <resource>
41 <directory>${project.basedir}/src/main/resources</directory>
42 </resource>
43 </resources>
44 <testResources>
45 <testResource>
46 <directory>${project.basedir}/src/test/resources</directory>
47 </testResource>
48 </testResources>
49 <pluginManagement>
50 <!-- NOTE: These plugins will be removed from future versions of the super POM -->
51 <!-- They are kept for the moment as they are very unlikely to conflict with lifecycle mappings (MNG-4453) -->
52 <plugins>
53 <plugin>
54 <artifactId>maven-antrun-plugin</artifactId>
55 <version>1.3</version>
56 </plugin>
57 <plugin>
58 <artifactId>maven-assembly-plugin</artifactId>
59 <version>2.2-beta-5</version>
60 </plugin>
61 <plugin>
62 <artifactId>maven-dependency-plugin</artifactId>
63 <version>2.8</version>
64 </plugin>
65 <plugin>
66 <artifactId>maven-release-plugin</artifactId>
67 <version>2.5.3</version>
68 </plugin>
69 </plugins>
70 </pluginManagement>
71 </build>
72
73 <reporting>
74 <outputDirectory>${project.build.directory}/site</outputDirectory>
75 </reporting>
76
77 <profiles>
78 <!-- NOTE: The release profile will be removed from future versions of the super POM -->
79 <profile>
80 <id>release-profile</id>
81
82 <activation>
83 <property>
84 <name>performRelease</name>
85 <value>true</value>
86 </property>
87 </activation>
88
89 <build>
90 <plugins>
91 <plugin>
92 <inherited>true</inherited>
93 <artifactId>maven-source-plugin</artifactId>
94 <executions>
95 <execution>
96 <id>attach-sources</id>
97 <goals>
98 <goal>jar-no-fork</goal>
99 </goals>
100 </execution>
101 </executions>
102 </plugin>
103 <plugin>
104 <inherited>true</inherited>
105 <artifactId>maven-javadoc-plugin</artifactId>
106 <executions>
107 <execution>
108 <id>attach-javadocs</id>
109 <goals>
110 <goal>jar</goal>
111 </goals>
112 </execution>
113 </executions>
114 </plugin>
115 <plugin>
116 <inherited>true</inherited>
117 <artifactId>maven-deploy-plugin</artifactId>
118 <configuration>
119 <updateReleaseInfo>true</updateReleaseInfo>
120 </configuration>
121 </plugin>
122 </plugins>
123 </build>
124 </profile>
125 </profiles>
126
127 </project>
Minimal POM
最小POM文件，一个POM文件最少要包含如下信息：
- project root
- modelVersion - 目前应该设置为4.0.0
- groupId - 项目组id
- artifactId - 项目id
- version - 版本号
最小POM文件 example:
1 <project> 2 <modelVersion>4.0.0</modelVersion> 3 <groupId>com.mycompany.app</groupId> 4 <artifactId>my-app</artifactId> 5 <version>1</version> 6 </project>
一个POM文件需要配置其groupId, artifactId和version。 这三个值构成该项目唯一合法的artifact name（或者说 坐标）。其形式是：<groudId>:<artifactId>:<version>。以上面的最小POM文件为例，其合法的fully artifact name是 "com.mycompany.app:my-app:1"。
除了上述最小POM文件要求提供的信息外，其他的配置信息如果不提供，则Maven会采用默认配置。如项目的打包类型信息可以被 packaging type 指定。每个项目都有打包类型，一般可以指定的类型有pom, jar, war等。如果不指定，默认的打包类型是jar。
另外，最小POM文件中并未指定 repositories。如果使用最小POM构建工程，则它会继承Super POM文件中的 repositories 配置。所以当Maven在执行项目遇到一些依赖包的时候，会从 http://repo.maven.apache.org/maven2 这个仓库下载，因为这个仓库被配置在Super POM中。
下面介绍如果使用Maven解决多项目合作的问题。如果一个大的项目下有多个子项目，则这些项目之间可以用继承(inheritance)或者融合(aggregation)的方式进行关联。
Project Inheritance
两个POM文件之间可以存在继承的关系，也就是说，一个POM文件可以复用（或者说两个POM文件之间可以合并）下列信息：
- dependencies
- developers and contributors
- plugin lists (including reports)
- plugin executions with matching ids
- plugin configuration
- resources
Example 1
场景
我们想在一个新项目中继承上面的这个POM, com.mycompany.app:my-app:1.我们现在有如下的一个新的项目 com.mycompany.app:my-module:1.
1 <project> 2 <modelVersion>4.0.0</modelVersion> 3 <groupId>com.mycompany.app</groupId> 4 <artifactId>my-module</artifactId> 5 <version>1</version> 6 </project>
这两个项目的目录结构如下：
1 . 2 |-- my-module 3 | `-- pom.xml 4 `-- 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文件为如下配置：
1 <project> 2 <parent> 3 <groupId>com.mycompany.app</groupId> 4 <artifactId>my-app</artifactId> 5 <version>1</version> 6 </parent> 7 <modelVersion>4.0.0</modelVersion> 8 <groupId>com.mycompany.app</groupId> 9 <artifactId>my-module</artifactId> 10 <version>1</version> 11 </project>
我们在com.mycompany.app:my-module:1 中添加了parent标签域，指定了父项目的坐标三要素 groupId, artifactId, version。这样，my-module项目就可以继承父项目的一些properties.
此外，如果如果在子项目中省略坐标中的groupId 和 version, 则子项目会使用和父项目一样的groupId 和 version。 但子项目必须指定artifactId。
如下配置com.mycompany.app:my-module:1， 省略了子项目的groupId 和 version, 则my-module会复用parent标签中指定的父项目的groupId和version