Maven Plugins

代码示例

<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

这个标签是特定于单个插件的。可以在这里指定插件Mojo可能需要的任何属性。值得注意的是，所有配置元素(无论它们位于POM中的什么位置)都旨在将值传递给另一个底层系统，比如插件。换句话说，POM模式从来不显式地需要配置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版本。

最后编辑于：2019.02.19 17:09:31