maven学习手记 - 3

学习目标

maven插件的定义；

maven插件的使用。

 

前言

在手记2中说过maven的阶段命令是通过插件实现的。在手记1中也有简单的示范过插件的用法。但是总觉得有些泛泛了，想在这里再捋一下，以期能更好地掌握maven的插件。

 

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项目存在以下差别：

1. 需要使用maven-plugin-api依赖；
2. packaging属性为maven-plugin；
3. 需要为mojo类添加注释并在注释中使用@goal标记，或者使用maven-plugin-plugin插件。

上面一步步的操作是为了让大家对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。看下执行结果：

可以看到在控制台上输出了预期中的信息，执行成功了。

maven 插件的使用

还取出手记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>

再提下在文档上看到的知识：

1. maven的插件有两大类：build插件和report插件。
2. build插件在生命周期build（default）间执行，需要在<build></build>元素间定义。
3. report插件在生命周期site间执行，需要在<reporting></reporting>元素间定义。

这里使用的显然是一个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