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

需要使用maven-plugin-api依赖；
packaging属性为maven-plugin；
需要为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>

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

maven的插件有两大类：build插件和report插件。
build插件在生命周期build（default）间执行，需要在<build></build>元素间定义。
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指令：