代码示例
<project xmlns="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
https://maven.apache.org/xsd/maven-4.0.0.xsd">
<build>
...
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>2.6</version>
<extensions>false</extensions>
<inherited>true</inherited>
<configuration>
<classifier>test</classifier>
</configuration>
<dependencies>...</dependencies>
<executions>...</executions>
</plugin>
</plugins>
</build>
</project>
除了标准的<groupId><artifactId><version>这3个标签外,还有其他标签供用户选择。
extensions
true/false
,默认值为false
。 是否可以加载此插件的扩展项。
inherited
true/false
默认值为true
。其他继承此POM的POM文件中的插件是否继承该插件的属性。
configuration
这个标签是特定于单个插件的??梢栽谡饫镏付ú寮﨧ojo可能需要的任何属性。值得注意的是,所有配置元素(无论它们位于POM中的什么位置)都旨在将值传递给另一个底层系统,比如插件?;痪浠八担琍OM模式从来不显式地需要配置configuration
中的值,但是插件goal
完全有权要求配置值。
如果POM文件中声明了父类,它将从父类POM文件中的build/plugins
或pluginManagement
部分继承插件的配置。
例如:
父类插件配置内容demo:
<plugin>
<groupId>my.group</groupId>
<artifactId>my-plugin</artifactId>
<configuration>
<items>
<item>parent-1</item>
<item>parent-2</item>
</items>
<properties>
<parentKey>parent</parentKey>
</properties>
</configuration>
</plugin>
子类插件配置内容demo1:
<plugin>
<groupId>my.group</groupId>
<artifactId>my-plugin</artifactId>
<configuration>
<items>
<item>child-1</item>
</items>
<properties>
<childKey>child</childKey>
</properties>
</configuration>
子类插件配置会继承父类插件配置,继承规则如下:
- 如果父类和子类有同一属性配置,以子类为准;
- 如果父类有,子类没有。父类配置会被继承;
根据以上继承规则,子类继承父类插件配置后,属性如下:
<plugin>
<groupId>my.group</groupId>
<artifactId>my-plugin</artifactId>
<configuration>
<!--相同属性配置,以子类为准-->
<items>
<item>child-1</item>
</items>
<properties>
<childKey>child</childKey>
<!--子类没有的属性,继承该属性-->
<parentKey>parent</parentKey>
</properties>
</configuration>
如果不想接受默认的继承规则,也可以通过配置属性combine.children
和combine.self
来自定义继承规则。
- combine.children="append" 相同属性,子类插件配置和父类插件配置合并;
- combine.self="override" 相同属性,子类配置直接覆盖父类配置;
- 以上2个属性同时使用,以combine.self="override"为准;
子类插件配置内容demo2:
<configuration>
<items combine.children="append">
<!-- combine.children="merge" is the default -->
<item>child-1</item>
</items>
<properties combine.self="override">
<!-- combine.self="merge" is the default -->
<childKey>child</childKey>
</properties>
</configuration>
根据自定义的继承规则,继承生效的属性配置为:
<configuration>
<items combine.children="append">
<item>parent-1</item>
<item>parent-2</item>
<item>child-1</item>
</items>
<properties combine.self="override">
<childKey>child</childKey>
</properties>
</configuration>
dependencies
依赖关系在POM中很常见,并且是所有plugins元素块下的一个元素。依赖项具有与基础构建下相同的结构和功能。
这种情况下的主要区别是,它们不再作为项目的依赖项应用,而是作为它们所处插件的依赖项应用。这样做的好处是可以更改插件的依赖项列表,可以通过排除删除未使用的运行时依赖项,或者更改所需的dpendent版本。