原文地址 译者:carvendy
插件程序配置引导
1.通用配置
1.帮助目标
2.配置参数
1.匹配简单对象
2.匹配复杂对象
3.匹配集合对象
1.匹配Lists
2.匹配Maps
3.匹配Poperties
2.配置构建插件
1.使用 <executions>标签
2.使用 <dependencies>标签
3.使用 <inherited>标签
3.配置报表插件
1.使用 <reporting>标签 对比 <build>标签
2.使用 <reportSets>标签
3.使用 <inherited>标签
介绍
在Maven,有构建和报表插件:
- 构建插件:在构建的时候执行,应该配置在<build/>标签里。
- 报表插件:在生成网站时候执行,应该配置在<reporting/>标签里。
所有插件至少需要的信息: groupId ,artifactId 和 verion。
重要笔记:推荐定义每个版本插件,来确保构建过程中可重用性。好的实践就是在构建过程中指定它们到<build><pluginManagement/></build>节点内(通常,你会定义一个<pluginManagement/>的节点在父级的pom中)。对于报表插件,你应该指定每个版本插件到<reporting><plugins/></reporting>节点 (当然在<build><pluginManagement/></build>节点也是可以的)。
通用配置
maven插件(构建和报表)配置在指定的<configuration>节点,<configuration>的子节点映射到了字段,设置项,包括小咒语(记住一个插件程序包括一个或多个Mojo,每个Mojo匹配一个目标)。举个例子,我们有一个执行查询特定URL、指定超时时间和一些选项的Mojo。这个Mojo看起来会像这样:
/** * @goal query */ public class MyQueryMojo extends AbstractMojo { /** * @parameter expression="${query.url}" */ private String url; /** * @parameter default-value="60" */ private int timeout; /** * @parameter */ private String[] options; public void execute() throws MojoExecutionException { } }
在pom中配置Mojo的期望URL,超时时间和选项,如下:
<project>... <build> <plugins> <plugin> <artifactId>maven-myquery-plugin</artifactId> <version>1.0</version> <configuration> <url>http://www.foobar.com/query</url> <timeout>10</timeout> <options> <option>one</option> <option>two</option> <option>three</option> </options> </configuration> </plugin> </plugins> </build> ... </project>
当你看到这些节点配置与Mojo的字段相匹配。配置机制中采取了类似于XStream的工作方式来匹配对象。所以从例子上你可以看到直接匹配的url节点和url字段,timeout节点和字段,options节点和字段。这个匹配机制可以通过字段的类型检查来处理阵列,和确定是否合适匹配。
对于mojos预期被执行可以直接通过命令行,他们的参数提供配置的方式来替换pom中<configuration>的项目。这些插件文档为了参数可以列到配置文件的表达式中。在mojo之上,参数url与表达式${query.url}关联起来了,意味着可以通过化工系统属性指定query.url的值,如下:
mvn myquery:query -Dquery.url=http://maven.apache.org
注意,系统属性的名称不一定参数的名称匹配的mojo。虽然这是一个相当常见的做法,你会经常注意到插件,采用了一些前缀的系统属性,以避免与其他系统属性的名称冲突。虽然很少,也有插件参数,(如历史原因)采用的系统属性,这是完全无关的参数名。所以一定要仔细看看插件文档。
帮助指令
最新的maven插件通常有帮助目标在命令行中描述插件,有参数类型和类型。例如,理解一下javadoc 目标,你就需要执行:
你可以通过 javadoc:javadoc 指令看到所有参数,类似于这页。
配置参数
匹配简单对象
匹配简单类型,例如Boolean 或 Integer 这很简单。在<configuration> 节点里看是这样的:
<configuration> <myString>a string</myString> <myBoolean>true</myBoolean> <myInteger>10</myInteger> <myDouble>1.0</myDouble> <myFile>c:/temp</myFile> <myURL>http://maven.apache.org</myURL> </configuration>
配置复杂对象
匹配复杂类型在Maven当中也是相当直接的,让我们,看一下小例子设置一个Person对象,在<configuration> 节点里看是这样的:
<configuration> <myString>a string</myString> <myBoolean>true</myBoolean> <myInteger>10</myInteger> <myDouble>1.0</myDouble> <myFile>c:/temp</myFile> <myURL>http://maven.apache.org</myURL> </configuration>
匹配复杂对象的规则如下:
一定要有私有字段与节点对应。所以在我们的案例中,在mojo里person节点一定匹配person对象的字段。
对象实例化对象一定要和mojo在同一个包下。所以你的mojo在com.mycompany.mojo.query包中 匹配机制在包中找一个名叫person的对象。正如你是看到的机制 首字母为大写的节点名字,然后去找这个对象实例化。
如果你希望实例化的这个对象在不同的包里,有复杂的名字和你必须指定用implementation属性,如下:
<configuration> <person> <firstName>Jason</firstName> <lastName>van Zyl</lastName> </person> </configuration></pre> </div> <div>
匹配集合类型
配置匹配机制很容易处理很多集合,现在就让我们来看看例子吧:
匹配Lists
匹配lists的工作就像匹配数组一样,你有一个list的节点就会匹配一个List。你需要的配置如下:
public class MyAnimalMojo extends AbstractMojo{ /** * @parameter */ private List animals; public void execute() throws MojoExecutionException{ ... } }
当你定义了一个animals的字段,你的插件程序配置如下:
<project>... <build> <plugins> <plugin> <artifactId>maven-myanimal-plugin</artifactId> <version>1.0</version> <configuration> <animals> <animal>cat</animal> <animal>dog</animal> <animal>aardvark</animal> </animals> </configuration> </plugin> </plugins> </build> ... </project>
在每一个animals列出相应的字段。不像数组,集合不是指定成分类型。为了得到list各个项目的类型,策略使用如下:
1. 如果xml节点包含 implementation属性,已经在使用了。
2.如果xml节点包含 一个”.”,试着用一个有资格的类名。
3.试着xml标签(首字母大写)作为一个类,配置一个相同包下面的对象。
4.如果节点没有子节点,假定它是String类型。否则,配置失败。
Mapping Maps
在相同的方式下,你可以定义map如下:
/** * My Map. * * @parameter */ private Map myMap;
<configuration> <myMap> <key1>value1</key1> <key2>value2</key2> </myMap> </configuration>
Mapping Properties
Properties配置如下:
/** * My Properties. * * @parameter */ private Properties myProperties;
<configuration> <myProperties> <property> <name>propertyName1</name> <value>propertyValue1</value> <property> <property> <name>propertyName2</name> <value>propertyValue2</value> <property> </myProperties> </configuration>
配置构建插件
配置构建插件只能在<build>节点
使用<executions>标签
你可以使用<executions>标签配置一个mojo。mojos 在构建周期实践中最常用到。使用MyQueryMojo作为一个例子,你可以看到一些如下:
<project>... <build> <plugins> <plugin> <artifactId>maven-myquery-plugin</artifactId> <version>1.0</version> <executions> <execution> <id>execution1</id> <phase>test</phase> <configuration> <url>http://www.foo.com/query</url> <timeout>10</timeout> <options> <option>one</option> <option>two</option> <option>three</option> </options> </configuration> <goals> <goal>query</goal> </goals> </execution> <execution> <id>execution2</id> <configuration> <url>http://www.bar.com/query</url> <timeout>15</timeout> <options> <option>four</option> <option>five</option> <option>six</option> </options> </configuration> <goals> <goal>query</goal> </goals> </execution> </executions> </plugin> </plugins> </build> ... </project>
首先配置执行id “execution1” 配置绑定在测试周期。第二个执行没有一个阶段节点,你觉得它会执行什么呢?好,指令都有一个默认绑定的阶段作为依据。如果指令有一个绑定阶段那么它就会在这个节点执行。但是如果指令没有绑定任何周期那么它讲不会在构建周期执行。
笔记中的pom中所有执行插件的id都必须是唯一的,其实他们不必唯一因为通过poms的继承分层。执行插件同样的id在不同的pom中汇被合并。相同的应用执行插件可以被定义在profiles中。
如果我们配置多个执行插件在不同的周期?你认为它会怎么执行?让我们再一次来看看pom的例子,但是我们应该绑定execution2到一个阶段。
<project> ... <build> <plugins> <plugin> ... <executions> <execution> <id>execution1</id> <phase>test</phase> ... </execution> <execution> <id>execution2</id> <phase>install</phase> <configuration> <url>http://www.bar.com/query</url> <timeout>15</timeout> <options> <option>four</option> <option>five</option> <option>six</option> </options> </configuration> <goals> <goal>query</goal> </goals> </execution> </executions> </plugin> </plugins> </build> ... </project>
如果多个执行绑定不同的阶段,mojo会在不同阶段执行一次。意思就是,execution1 将会在测试阶段执行,而execution2 会在build阶段执行。
现在,让我们看另外一个mojo的例子,看一下默认的绑定的阶段。
/** * @goal query * @phase package */ public class MyBindedQueryMojo extends AbstractMojo { /** * @parameter expression="${query.url}"; */ private String url; /** * @parameter default-value="60" */ private int timeout; /** * @parameter */ privateString[] options; public void execute() throws MojoExecutionException { } }
从上面这个mojo的例子看,MyBindedQueryMojo 的默认周期是package阶段(看看@phares 注解)。但是如果我们想执行这个mojo在安装阶段而不是package阶段,我们应该使用<execution>下的<phase>表情 重新绑定mojo到一个新的周期。
<project> ... <build> <plugins> <plugin> <artifactId>maven-myquery-plugin</artifactId> <version>1.0</version> <executions> <execution> <id>execution1</id> <phase>install</phase> <configuration> <url>http://www.bar.com/query</url> <timeout>15</timeout> <options> <option>four</option> <option>five</option> <option>six</option> </options> </configuration> <goals> <goal>query</goal> </goals> </execution> </executions> </plugin> </plugins> </build> ... </project>
现在,MyBindedQueryMojo 默认周期已经被重写成 install阶段了
笔记:<executions>节点中的配置和外面的executions节点以外的元素不同,因为它们不能从命令中调用执行,因为它们是要调用了生命周期才会执行。所以你配置executions节点以外的元素可以插件完全调用。自从Maven 3.3.1 不是这样的情况了,你可以指定命令为插件指定执行的命令。因此,你想执行上面这个插件,指定execution1的配置可以通过命令行,你可以执行这个:
</div> <div>mvn myqyeryplugin:<a href="mailto:queryMojo@execution1">queryMojo@execution1</a></div> <div>
使用 <dependencies> 标签
你可以配置 插件的依赖库,通常是由一些最新的依赖版本。
例子,Maven Antrun Plugin 版本 1.2 是由 Ant 版本 1.6.5 ,如果你想是由最新的Ant版本来运行插件,你需要加dependencies 节点如下:
<project> ... <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-antrun-plugin</artifactId> <version>1.2</version> ... <dependencies> <dependency> <groupId>org.apache.ant</groupId> <artifactId>ant</artifactId> <version>1.7.1</version> </dependency> <dependency> <groupId>org.apache.ant</groupId> <artifactId>ant-launcher</artifactId> <version>1.7.1</version> </dependency> </dependencies> </plugin> </plugins> </build> ... </project>
在构建插件中使用 <inherited>标签
默认,插件配置应该传播到子项目的pom里,所以要打破继承,你就需要使用<inherited>标签:
<project> ... <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-antrun-plugin</artifactId> <version>1.2</version> <inherited>false</inherited> ... </plugin> </plugins> </build> ... </project>
配置报表插件
通过 配置报表插件在 <reporting>节点。
使用<reporting>标签和<build>标签
在pom中配置报表插件在 <reporting>标签 或者<build>标签,是不一样的行为。
mvn site
它只能将参数定义在configuration 节点的每一个指定在<reportying>标签中报表插件。例如,site 总是忽略了在<build>中每个插件在configuration 节点指定的一些参数。
mvn aplugin:areportgoal
它会首先将参数定义在configuration 节点的每一个指定在<reportying>标签中报表插件;如果找不到,它将会查找在build的每个插件的配置中定义的参数。
使用<reportSets>标签
你可以使用<reportSets>标签配置一个报表插件。在运行mvn site,通常用于可以选择性的生成报表。通过下面的配置你可以生成项目的团队报表。
<project> ... <reporting> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-project-info-reports-plugin</artifactId> <version>2.1.2</version> <reportSets> <reportSet> <reports> <report>project-team</report> </reports> </reportSet> </reportSets> </plugin> </plugins> </reporting> ... </project>
笔记:
1. 执行所有报表,你需要使用:
<reportSets> <reportSet> <reports/> </reportSet> </reportSets>
2.参考任意一个插件的文档(例如 plugin-info.html)你会了解更多可用的插件。
在报表插件中使用 <inherited> 标签
与构建插件类似,打破继承,你可以使用<inherited>标签
<project> ... <reporting> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-project-info-reports-plugin</artifactId> <version>2.1.2</version> <inherited>false</inherited> </plugin> </plugins> </reporting> ... </project> <div>
原创文章,作者:ItWorker,如若转载,请注明出处:https://blog.ytso.com/112904.html