Maven集成Findbugs至compile阶段(excludeFilterFile 属性必须配置在 plugin 节点下)

最近在对代码作检测，使用到了findbug插件。每次检测都是手动检测，而且都是事后想起来才检测一下。
后来，想想有没有强制每个在提交代码的时候，使用findbug检测一下呢。
由于项目是使用maven打包编译的，所以，自然而然的就想到，findbug应该也有maven的插件吧。
于是，查了一下，的确有，: )。先直接上配置吧。

<build>
    <pluginManagement>
        <plugins>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>findbugs-maven-plugin</artifactId>
                <version>3.0.4</version>
            </plugin>
        </plugins>
    </pluginManagement>

    <plugins>
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>findbugs-maven-plugin</artifactId>
            <configuration>
                <effort>default</effort>
                <failOnError>true</failOnError
                 <excludeFilterFile>${project.basedir}/etc/findbug/excludeFilter.xml</excludeFilterFile>
            </configuration>
            <executions>
                <execution>
                    <id>check</id>
                    <phase>compile</phase>
                    <goals>
                        <goal>check</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

下面，稍微解释一下：

• 先在pluginManagement声明一下findbug的插件，这样，所有子模块可以使用同一个版本的插件(即子模块使用时，不用指定version的)
• 添加一个 execution，指定其 phase 为 compile，goal 为 check，意思是将 findbug 插件的 check 这个动作应用到 maven 生命期的 compile 之后，这样一来，当我们使用mvn compile这样的命令之后，会自动执行 findbug 插件的 check 这个goal。

2017-03-21 修正

原来的描述

在这个execution中，我们可以添加一个 configuration 子元素来配置一些配置项。

更正后的描述

在这个plugin中，我们可以添加一个 configuration 子元素来配置一些配置项。请务必注意，只能在 plugin 节点下配置，如果配置到 execution 节点下的话，那么，excludeFilterFile 属性将无效

• 像我上面的这个配置里，就配置了三个：effort、failOnError、excludeFilterFile。其中，前两个配置的值其实就是 findbug 插件里的默认值，这里把它们列出来，只是为了以后可能需要进行改动。最后一个配置项，是用来配置过滤掉那些不需要进行check的代码的，至于这份 filter 文件怎么写，可以参考我的另一篇blog：findbug的filter如何编写？

• PS：我上面将 findbug 绑定到了 compile 上，所以，就自动过滤掉了所有 test 代码。至于为什么，请自行查看 maven 的生命周期：maven生命周期

最后，提一下这个 findbug 插件的官网：findbug的maven插件的官网。然后，我想说，这个插件虽然提供了不少便利，但是官网文档做得不是很好，特别是：

• 各个goal的具体使用方式(只有粗略的使用说j)
• 各个goal之间的区别(特别是 check 和 findbug)
• 各个goal的 configuration 中可以配置哪些参数，这些参数的意思是什么

下面我本机的一个编译过程输出。我们可以看到，check 这个 goal 是依赖 findbugs 这个 goal 的，所以，会在 check 这个 goal 之前，会先运行 findbugs 这个 goals

[wz@test test-prj]$ mvn clean compile
[INFO] Scanning for projects...
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building test-prj 0.9.1
[INFO] ------------------------------------------------------------------------
[INFO] 
[INFO] --- maven-clean-plugin:2.6.1:clean (default-clean) @ test-prj ---
[INFO] Deleting /home/wz/idea_workspace/test-prj/target
[INFO] 
[INFO] --- maven-resources-plugin:2.5:resources (default-resources) @ test-prj ---
[debug] execute contextualize
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 3 resources
[INFO] Copying 36 resources to com/cm/test/persistence
[INFO] 
[INFO] --- maven-compiler-plugin:3.3:compile (default-compile) @ test-prj ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 402 source files to /home/wz/idea_workspace/test-prj/target/classes
[INFO] 
[INFO] >>> findbugs-maven-plugin:3.0.4:check (check) > :findbugs @ test-prj >>>
[INFO] 
[INFO] --- findbugs-maven-plugin:3.0.4:findbugs (findbugs) @ test-prj ---
[INFO] Fork Value is true
[INFO] Done FindBugs Analysis....
[INFO] 
[INFO] <<< findbugs-maven-plugin:3.0.4:check (check) < :findbugs @ test-prj <<<
[INFO] 
[INFO] --- findbugs-maven-plugin:3.0.4:check (check) @ test-prj ---
[INFO] BugInstance size is 0
[INFO] Error size is 0
[INFO] No errors/warnings found
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:31 min
[INFO] Finished at: 2017-01-06T14:11:53+08:00
[INFO] Final Memory: 38M/430M
[INFO] ------------------------------------------------------------------------