maven插件的定义;
maven插件的使用。
在手记2中说过maven的阶段命令是通过插件实现的。在手记1中也有简单的示范过插件的用法。但是总觉得有些泛泛了,想在这里再捋一下,以期能更好地掌握maven的插件。
还是从插件的定义及创建开始吧。
这里要理解一个词mojo,mojo即Maven Plain Old Java Object,就是一个普通的Java类。每一个Mojo都要实现org.apache.maven.plugin.Mojo接口。
首先创建一个maven项目mvnplugin,配置信息如下:
<groupId>net.ibuluo.mvnplugin</groupId> <artifactId>mvnplugin</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <name>mvnplugin</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties>
修改pom.xml文件,添加依赖:
<dependency> <groupId>org.apache.maven</groupId> <artifactId>maven-plugin-api</artifactId> <version>2.0</version> </dependency>
删除自带的App类,创建一个Tester类,继承AbstractMojo,实现execute方法:
package net.ibuluo.mvnplugin; import org.apache.maven.plugin.AbstractMojo; import org.apache.maven.plugin.MojoExecutionException; import org.apache.maven.plugin.MojoFailureException; public class Tester extends AbstractMojo{ public void execute() throws MojoExecutionException, MojoFailureException{ //System.out.println("Just a test!"); getLog().info("Just a test!"); } }
修改下项目的配置信息,修改pom.xml文件,修改的是packaging属性:
<groupId>net.ibuluo.mvnplugin</groupId> <artifactId>mvnplugin</artifactId> <version>1.0-SNAPSHOT</version> <packaging>maven-plugin</packaging>
输入mvn compile执行编译,编译失败:
需要为Tester类添加注释,并添加@goal标记,修改如下:
/** *@goal tester **/ public class Tester extends AbstractMojo{
再次执行编译mvn clean compile:
可以看到编译通过。回过头来看一下错误信息’No mojo definations were fund for plugin’-找不到插件的mojo定义,明明已经继承了AbstractMojo类了?再看看修改的内容,是在类的注释里添加了“@goal tester ”这样一段信息。翻翻maven的官方文档,里面有这样一句话“a plug-in consists of one or more Mojos where a Mojo maps to a goal”-一个插件有多个mojo,每个mojo对应一个目标。勇敢的推断一下,每个goal都是由一个mojo实现的,“@goal tester”实际上是将一个mojo绑定到名为tester的goal上,系统编译时首先寻找goal,然后再去根据goal寻找对应的mojo。若未指出goal,那么编译的时候就会报出异常。
这里也可以使用maven-plugin-plugin插件跳过这个异常:
<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-plugin-plugin</artifactId> <version>3.0</version> <executions> </executions> <configuration> <!-- Needed for Java 5 annotation based configuration, for some reason. --> <skipErrorNoDescriptorsFound>true</skipErrorNoDescriptorsFound> </configuration> </plugin> </plugins> </build>
通过上面创建插件的步骤总结下maven插件项目和普通maven项目存在以下差别:
上面一步步的操作是为了让大家对maven插件定义有一个认识的过程。
实际上maven还提供了maven-archetype-plugin插件可以帮助我们创建插件,语句如下:
mvn archetype:create -DgroupId=net.ibuluo.mvnplugin -DartifactId=mvnplugin -DarchetypeArtifactId=maven-archetype-mojo
创建好的项目的目录:
还提供了参考代码:
package net.ibuluo.mvnplugin; /* * Copyright 2001-2005 The Apache Software Foundation. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import org.apache.maven.plugin.AbstractMojo; import org.apache.maven.plugin.MojoExecutionException; import java.io.File; import java.io.FileWriter; import java.io.IOException; /** * Goal which touches a timestamp file. * * @goal touch * * @phase process-sources */ public class MyMojo extends AbstractMojo { /** * Location of the file. * @parameter expression="${project.build.directory}" * @required */ private File outputDirectory; public void execute() throws MojoExecutionException { File f = outputDirectory; if ( !f.exists() ) { f.mkdirs(); } File touch = new File( f, "touch.txt" ); FileWriter w = null; try { w = new FileWriter( touch ); w.write( "touch.txt" ); } catch ( IOException e ) { throw new MojoExecutionException( "Error creating file " + touch, e ); } finally { if ( w != null ) { try { w.close(); } catch ( IOException e ) { // ignore } } } } }
看完后删除这个类,新建Tester类(或是直接修改成Tester类)。将项目恢复到之前的样子。
要使用这个插件首先需要将插件部署到本地库,执行mvn install命令将插件发布到本地库。
试着调用下这个插件,在手记2中提到过插件使用的方式是:mvn 插件名:目标名。好像我们没有做过定义插件名这样一件事。目标名根据之前的猜测应该是tester。不管了,先试试mvn Tester:tester,用类名做插件名试试:
果不其然,执行失败了。再试试“mvn net.ibuluo.mvnplugin.Tester:tester”或“mvn net.ibuluo.mvnplugin:tester”,依然执行失败。
不做无谓的尝试了,插件的运行方式是:mvn groupID:artifactID:version:goal。
所以执行这个插件的指令应该是:mvn net.ibuluo.mvnplugin:mvnplugin:1.0-SNAPSHOT:tester。看下执行结果:
可以看到在控制台上输出了预期中的信息,执行成功了。
还取出手记1中的pom文件,着重看看使用插件的部分(绿色背景的部分):
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>net.ibuluo.mvntest</groupId> <artifactId>mvntest</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <name>mvntest</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <version>1.2.1</version> <executions> <execution> <phase>package</phase> <goals> <goal>shade</goal> </goals> <configuration> <transformers> <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"> <mainClass>net.ibuluo.mvntest.App</mainClass> </transformer> </transformers> </configuration> </execution> </executions> </plugin> </plugins> </build> </project>
再提下在文档上看到的知识:
这里使用的显然是一个build插件。
之前已经提过,groupId、artificialId和version是一个mvn项目的唯一性坐标。插件也可以被视为mvn项目,因此在使用插件时这三项属性是必不可少的,maven需要使用这三项属性找到需要的插件。
然后是executions标签,在这个标签中可以有多个execution,如有多个execution需要为每个execution设置id属性。execution中的phase指明了执行插件的阶段,goal指明了要执行的插件的目标。对于configuration属性我也不甚了了,说不了什么。
调整下当前项目的pom.xml文件,使之调用我们刚才定义的插件。主要是添加<build>属性:
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>net.ibuluo.mvnplugin</groupId> <artifactId>mvnplugin</artifactId> <version>1.0-SNAPSHOT</version> <packaging>maven-plugin</packaging> <name>mvnplugin</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> <dependencies> <dependency> <groupId>org.apache.maven</groupId> <artifactId>maven-plugin-api</artifactId> <version>2.0</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>net.ibuluo.mvnplugin</groupId> <artifactId>mvnplugin</artifactId> <version>1.0-SNAPSHOT</version> <executions> <execution> <phase>compile</phase> <goals> <goal>tester</goal> </goals> </execution> </executions> </plugin> </plugins> </build> </project>
执行mvn clean compile指令:
使用插件成功了。
参考文章:
http://maven.apache.org/guides/mini/guide-configuring-plugins.html
http://blog.csdn.net/liulin_good/article/details/6069818
http://blog.csdn.net/csfreebird/article/category/1543235
http://somebody-hjh.iteye.com/blog/726086
11