7.6.2 使用maven-help-plugin描述插件
除了访问在线的插件文档之外,还可以借助maven-help-plugin来获取插件的详细信息。可以运行如下命令来获取maven-compiler-plugin 2.1版本的信息:
$mvn help:describe-Dplugin=org.apache.maven.plugins:maven-compiler-
plugin:2.1
这里执行的是maven-help-plugin的describe目标,在参数plugin中输入需要描述插件的groupId、artifactId和version。Maven在命令行输出maven-compiler-plugin的简要信息,包括该插件的坐标、目标前缀和目标等,见代码清单7-6。
代码清单7-6 使用maven-help-plugin获取插件信息
Name:Maven Compiler Plugin
Description:The Compiler Plugin is used to compile the sources of your
project.
Group Id:org.apache.maven.plugins
Artifact Id:maven-compiler-plugin
Version:2.1
Goal Prefix:compiler
This plugin has 3 goals:
compiler:compile
Description:Compiles application sources
compiler:help
Description:Display help information on maven-compiler-plugin.
Call
mvn compiler:help-Ddetail=true-Dgoal=<goal-name>
to display parameter details.
compiler:testCompile
Description:Compiles application test sources.
For more information,run'mvn help:describe[……]-Ddetail'
对于坐标和插件目标,不再多做解释,这里值得一提的是目标前缀(Goal Prefix),其作用是方便在命令行直接运行插件。在第7.8节会做进一步解释。maven-compiler-plugin的目标前缀是compiler。
在描述插件的时候,还可以省去版本信息,让Maven自动获取最新版本来进行表述。例如:
$mvn help:describe-Dplugin=org.apache.maven.plugins:maven-compiler-plugin
进一步简化,可以使用插件目标前缀替换坐标。例如:
$mvn help:describe-Dplugin=compiler
如果想仅仅描述某个插件目标的信息,可以加上goal参数:
$mvn help:describe-Dplugin=compiler-Dgoal=compile
如果想让maven-help-plugin输出更详细的信息,可以加上detail参数:
$mvn help:describe-Dplugin=compiler-Ddetail
读者可以在实际环境中使用help:describe描述一些常用插件的信息,以得到更加直观的感受。