使用Eclipse开发Maven插件-1/3
概要
1. 这是一个样例,基本照着《Maven实战》-徐晓斌,第17章照抄的;个人练手之作,不喜勿喷!
2. 代码行统计插件。
备注
大量插件可从以下网站获得:
1. http://maven.apache.org/plugins/
2. http://mojo.codehaus.org/plugins.html
m2e插件不能提供搜索框,搜索Maven依赖包的(书里说可以,但实际插件不提供该功能了),可以通过:
https://repository.sonatype.org/index.html 搜索(可根据类名,包名,artifactId等信息查找)
正文
1. 创建Maven项目,archetype选择:maven-archetype-plugin
New--->Project…选择Maven Project
2. 删除MyMojo.java,新增CountMojo.java继承:org.apache.maven.plugin.AbstractMojo
package com.ckhuang.maven.plugin; import java.io.BufferedReader; import java.io.File; import java.io.FileReader; import java.io.IOException; import java.util.ArrayList; import java.util.Arrays; import java.util.List; import org.apache.maven.model.Resource; import org.apache.maven.plugin.AbstractMojo; import org.apache.maven.plugin.MojoExecutionException; import org.apache.maven.plugin.MojoFailureException; import org.apache.maven.plugins.annotations.Mojo; import org.apache.maven.plugins.annotations.Parameter; /** * * 统计项目文件的行数 * * @author ck.huang * */ @Mojo(name = "count") public class CountMojo extends AbstractMojo { private static final String[] INCLUDES_DEFAULT = new String[] {"xml", "java", "properties"}; /** * * 项目根目录 * */ @Parameter(defaultValue = "${project.basedir}", property = "baseDir", required = true, readonly = true) private File baseDir; /** * * 项目源文件目录 * */ @Parameter(defaultValue = "${project.build.sourceDirectory}", property = "sourceDirectory", required = true, readonly = true) private File sourceDirectory; /** * * 项目测试代码源文件目录 * */ @Parameter(defaultValue = "${project.build.testSourceDirectory}", property = "testSourceDirectory", required = true, readonly = true) private File testSourceDirectory; /** * * 运行时配置文件 * */ @Parameter(defaultValue = "${project.build.reousrce}", required = true, readonly = true) private List<Resource> resources; /** * * 测试时配置文件 * */ @Parameter(defaultValue = "${project.build.testReousrce}", required = true, readonly = true) private List<Resource> testResources; /** * 要统计的文件格式<br/> * 默认为:java,xml,properties<br/> * 可通过配置includes属性修改 */ @Parameter(property = "includes") private String[] includes; public void execute() throws MojoExecutionException, MojoFailureException { if (includes == null || includes.length == 0) { includes = INCLUDES_DEFAULT; } try { getLog().info("includes " + Arrays.toString(includes)); countDir(sourceDirectory); countDir(testSourceDirectory); countResource(resources); countResource(testResources); } catch (IOException e) { throw new MojoExecutionException("Unable to count lines of code.", e); } } /** * 统计文件目录下的文件总行数 * * @param dir 目录路径 * @throws IOException */ private void countDir(File dir) throws IOException { if (!dir.exists()) { return; } List<File> collected = new ArrayList<File>(); collectFiles(collected, dir); int lines = 0; for (File sourceFile : collected) { lines += countLine(sourceFile); } String path = dir.getAbsolutePath().substring(baseDir.getAbsolutePath().length()); getLog().info(path + ":" + lines + " lines of code in " + collected.size() + "files"); } private int countLine(File sourceFile) throws IOException { BufferedReader reader = new BufferedReader(new FileReader(sourceFile)); int line = 0; try { while (reader.ready()) { reader.readLine(); line++; } } finally { reader.close(); } return line; } private void collectFiles(List<File> collected, File file) { if (file.isFile()) { for (String include : includes) { if (file.getName().endsWith("." + include)) { collected.add(file); break; } } } else { for (File sub : file.listFiles()) { collectFiles(collected, sub); } } } /** * 统计配置文件 * * @param resources * @throws IOException */ private void countResource(List<Resource> resources) throws IOException { for (Resource res : resources) { countDir(new File(res.getDirectory())); } } }
3. 在生成的POM,xml文件基础上修改,修改:goalPrefix
<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>com.ckhuang.maven</groupId> <artifactId>maven-loc-plugin</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>maven-plugin</packaging> <name>lineCounter Maven Plugin</name> <!-- FIXME change it to the project‘s website --> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven.version>3.0.4</maven.version> </properties> <dependencies> <dependency> <groupId>org.apache.maven</groupId> <artifactId>maven-plugin-api</artifactId> <version>${maven.version}</version> </dependency> <dependency> <groupId>org.apache.maven.plugin-tools</groupId> <artifactId>maven-plugin-annotations</artifactId> <version>3.2</version> <scope>provided</scope> </dependency> <dependency> <groupId>org.codehaus.plexus</groupId> <artifactId>plexus-utils</artifactId> <version>3.0.8</version> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.8.2</version> <scope>test</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-plugin-plugin</artifactId> <version>3.2</version> <configuration> <goalPrefix>loc</goalPrefix> <skipErrorNoDescriptorsFound>true</skipErrorNoDescriptorsFound> </configuration> <executions> <execution> <id>mojo-descriptor</id> <goals> <goal>descriptor</goal> </goals> </execution> <execution> <id>help-goal</id> <goals> <goal>helpmojo</goal> </goals> </execution> </executions> </plugin> </plugins> </build> <profiles> <profile> <id>run-its</id> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-invoker-plugin</artifactId> <version>1.7</version> <configuration> <debug>true</debug> <cloneProjectsTo>${project.build.directory}/it</cloneProjectsTo> <pomIncludes> <pomInclude>*/pom.xml</pomInclude> </pomIncludes> <postBuildHookScript>verify</postBuildHookScript> <localRepositoryPath>${project.build.directory}/local-repo</localRepositoryPath> <settingsFile>src/it/settings.xml</settingsFile> <goals> <goal>clean</goal> <goal>test-compile</goal> </goals> </configuration> <executions> <execution> <id>integration-test</id> <goals> <goal>install</goal> <goal>integration-test</goal> <goal>verify</goal> </goals> </execution> </executions> </plugin> </plugins> </build> </profile> </profiles> </project>
4. 修改Maven的setting.xml增加插件所属的groupId,以便更简易的访问:
<pluginGroups> <!-- 你的插件groupId --> <pluginGroup>com.ckhuang.maven</pluginGroup> </pluginGroups>
5. 进入某个Maven项目,执行:
mvn loc:count
=========================================
PS,如果没有经过第4步,以及第3步中修改POM.xml的:
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-plugin-plugin</artifactId> <version>3.2</version> <configuration> <goalPrefix>loc</goalPrefix> <skipErrorNoDescriptorsFound>true</skipErrorNoDescriptorsFound> </configuration> <executions> <execution> <id>mojo-descriptor</id> <goals> <goal>descriptor</goal> </goals> </execution> <execution> <id>help-goal</id> <goals> <goal>helpmojo</goal> </goals> </execution> </executions> </plugin>
则使用插件需要执行:
mvn com.ckhuang.maven:maven-loc-plugin:0.0.1-SNAPSHOT:count
搞定!
后记
涉及的细节如注解:@Mojo,@Parameter(property = "includes")等的使用,${project.build.reousrce}等Maven的环境变量,
将在下一章节进行说明。
郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。