修复Maven项目默认文件夹的Maven Plugin开发

    总体说Maven Plugin开发算是比较简单，了解了Mojo之后，实现起Maven Plugin的一个个goal就更加轻松了。

    由于发现在通过eclipse或者archetype创建Maven工程之后，src下的目录时而不完整，于是打起开发一个Maven Plugin的主意。该插件命名为：hello-maven-plugin，此外Apache Maven官方声明过Maven Plugin命名需要注意的问题，Maven官方的Plugin命名格式为：maven--plugin,其它个人或者组织可以使用-maven-plugin命名，当然不限于此。不过使用这种命名格式有个好处是在使用Plugin的时候可以通过 mvn plugin:goal 命令来进行操作，可以省去完整限定名。

   下面将是开发该插件的具体步骤：

1. 创建hello-maven-plugin的Maven工程

2. 在pom.xml中添加依赖和maven-plugin-plugin插件  

    

		
			org.apache.maven
			maven-plugin-api
			2.0
		
		
			org.apache.maven.plugin-tools
			maven-plugin-annotations
			3.4
			provided
		
		
			org.apache.maven
			maven-core
			3.1.0
		
	

				org.apache.maven.plugins
				maven-plugin-plugin
				3.4
				
					
						default-descriptor
						process-classes
					
				
			

   需要注意的事，Mojo对象的通过Java doc Tag或者Java Annotation的注释的方式都可以通过处理生产plugin.xml的描述文件，这里使用Java Annotation。

   详情：http://maven.apache.org/plugin-tools/maven-plugin-annotations/index.html

3.编写Mojo

  通常一个Plugin中可能有多个goal,这里我们把多个Mojo的共同部分提取到父类，该父类是抽象类，并未实现execute方法，而是由每个实现特定goal的Mojo来实现。

  

package secondriver.maven.plugin.hello;

import org.apache.maven.plugin.AbstractMojo;

public abstract class BaseMojo extends AbstractMojo {

	public void printLine() {
		getLog().info(
				"------------------------------------------------------------------------");
	}
}

 

package secondriver.maven.plugin.hello;

import java.io.File;

import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.MojoFailureException;
import org.apache.maven.plugins.annotations.LifecyclePhase;
import org.apache.maven.plugins.annotations.Mojo;
import org.apache.maven.plugins.annotations.Parameter;
import org.apache.maven.project.MavenProject;

@Mojo(name = "fixdir", requiresProject = true, threadSafe = true, defaultPhase = LifecyclePhase.NONE)
public class FixDir extends BaseMojo {

	@Parameter(defaultValue = "${project}")
	private MavenProject project;

	@Parameter(defaultValue = "${project.basedir}", readonly = true)
	private File baseDir;

	private String srcDir = "/src";

	private String mainJava = "/main/java";

	private String mainResources = "/main/resources";

	private String testJava = "/test/java";
	private String testResources = "/test/resources";

	@Parameter(name = "packageName", property = "fixdir.packageName", defaultValue = "${project.groupId}", required = true)
	private String packageName;

	public void execute() throws MojoExecutionException, MojoFailureException {
		String packagePath = packageName.replace(".", File.separator);

		// 创建关于main的目录
		mkdirs(mainJava + File.separator + packagePath);
		mkdirs(mainResources);

		// 创建关于test的目录
		mkdirs(testJava + File.separator + packagePath);
		mkdirs(testResources);
	}

	private void mkdirs(String path) throws MojoFailureException {
		File file = new File(baseDir, srcDir + File.separator + path);
		if (!file.exists()) {
			if (file.mkdirs()) {
				getLog().info(path + " created OK.");
			} else {
				getLog().error(path + " created Failed.");
				throw new MojoFailureException("Fix " + mainJava + ", "
						+ mainResources + ", " + testJava + ", "
						+ testResources + " Failed.");
			}
		}
	}
}

    上面的FixDirMojo实现了fixdir goal，其具体功能就是文中开始提到的将src的目录补完整（特别说一个，按照Maven工程的实际使用，这里并不完整，比如assembly，profile目录等都未创建）。

    限于篇幅有关Annotation的具体使用可以参见：http://maven.apache.org/plugin-tools/maven-plugin-tools-annotations/index.html#Supported_Annotations

    另外一个最好不过的方式就是通过Java Decompiler工具将现有个Maven Plugin反编译之后看看这些注解的具体使用。

4.编译，生成Plugin的描述文件，发布

  

hello-maven-plugin>mvn compiler:compile
hello-maven-plugin>mvn plugin:descriptor
hello-maven-plugin>mvn install

 也可以直接执行：mvn install

 通过plugin:descriptor将对Mojo进行处理，生成plugin.xml。关于描述下面是其中一部分摘取：

 

  hello-maven-plugin Maven Mojo
  
  secondriver.maven.plugin
  hello-maven-plugin
  1.0
  hello
  false
  true
  
    
      fixdir
      false
      true
      false
      false
      false
      true
      secondriver.maven.plugin.hello.FixDir
      java
      per-lookup
      once-per-session
      true
      
        
          baseDir
          java.io.File
          false
          false
          
        
        
          packageName
          java.lang.String
          true
          true
          
        
        
          project
          org.apache.maven.project.MavenProject
          false
          true
          
        
      
      
        
        ${fixdir.packageName}
        
      
    
  

 

 5.在Maven工程中添加hello-maven-plugin,并且使用其中功能

   

				secondriver.maven.plugin
				hello-maven-plugin
				1.0
			

 

 执行 mvn hello:fixdir或者mvn secondriver.maven.plugin:hello:1.0:fixdir命令，修复src下的目录。

  执行前：

  

  执行结果显示：

  

  执行后：

  

  通过对吧前后两幅目录树可以看出执行fixdir之后，test目录下结构完整了。

 6.写在最后

   本文只是通过创建一个简单的Maven Plugin解决实际中遇到的一个问题，其具备了功能性，但离一个合格的Maven Plugin的完整性还差好远。比如：Maven Plugin的参数说明，帮助文档，参数检查等。更多关于Maven Plugin开发还得去官网开开发文档（有点小凌乱），还有就是反编译已有的成熟Maven Plugin。