Maven Plugins

2019-02-19  本文已影响0人  风吟空城

代码示例

<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/pluginspluginManagement部分继承插件的配置。

例如:
父类插件配置内容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>

子类插件配置会继承父类插件配置,继承规则如下:

  1. 如果父类和子类有同一属性配置,以子类为准;
  2. 如果父类有,子类没有。父类配置会被继承;

根据以上继承规则,子类继承父类插件配置后,属性如下:

<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.childrencombine.self来自定义继承规则。

  1. combine.children="append" 相同属性,子类插件配置和父类插件配置合并;
  2. combine.self="override" 相同属性,子类配置直接覆盖父类配置;
  3. 以上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版本。

上一篇下一篇

猜你喜欢

热点阅读