maven插件参数的user属性的含义是什么

Question

我是Maven的新手。当我尝试引用任何maven插件文档时，我总是看到参数定义的以下格式：Name Description{parameter Name}{Description}默认值是：...用户属性是：...

在大多数情况下，我看到用户属性与参数名称是一样的。我在这里想知道“用户属性”和“参数名”有什么区别。我认为在配置时指定相应插件的参数值时，参数名应该是元素标记名，但是“用户属性”的用法是什么？

Answer 1

注意：这是针对Maven3的。早期版本（有点）不同。

TL；DR：

“User property”指定可用于设置插件参数的Maven属性的名称。这允许从 部分之外配置插件。请注意，只有在 部分中未指定参数（请参见MNG-4979-Cant override configuration parameter from command line）时，此操作才起作用。

在Maven中，插件的参数通常在POM中的 部分中设置。插件文档中给出的“参数名称”是配置设置中要使用的名称。

例如，Surefire目标Surefire：test有一个参数“failifnospecifiedtests”。要在POM中设置它,请使用：

<configuration>
<failIfNoSpecifiedTests>false</failIfNoSpecifiedTests>
</configuration>

但是，有时从 部分外部设置插件参数是很有用的，例如在命令行或Maven配置文件中设置它。为了允许这样做，插件还可以声明它将从一个Maven属性（如果设置了）读取参数值。此属性是文档列出的用户属性。

• 在命令行上，通过指定-dsurefire.failifnoSpecifiedTests=false
• 在POM配置文件中: false ...

注意，插件必须为每个参数声明User属性，因此并非所有参数都有一个。例如，参数basedir没有用户属性，因此不能在命令行上设置。

在插件的源代码中，参数名没有显式声明；它取自Java字段的名称。“FailifnoSpecifiedTests”的源代码是：

/**
 * Set this to "true" to cause a failure if the none of the tests
 * specified in -Dtest=... are run. Defaults to "true".
 *
 * @since 2.12
 */
@Parameter( property = "surefire.failIfNoSpecifiedTests" )
private Boolean failIfNoSpecifiedTests;