CheckStyle、cobertura、Findbugs与Maven2的集成[转]

zhaohaolin

浏览: 1010825 次
性别:
来自: 杭州

最近访客更多访客>>

bfs198

ymitxiavj

xuming_1980

bianrongxin

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

JAVA

（一）

将 CheckStyle（http://maven.apache.org/plugins/maven-checkstyle-plugin/usage.html ）、FindBugs（http://mojo.codehaus.org/findbugs-maven-plugin/2.0.1/usage.html ）集成到 Maven 中，代码检查可以通过构建工具自动完成。

将cobertura（http://mojo.codehaus.org/cobertura-maven-plugin/usage.html ）集成到 Maven 中，可生成单元测试覆盖率报告。

那么，如何将配置集中化，以便在完成一次项目构建时不必手动处理配置呢？

使用 Maven 内置的依赖项机制可轻松解决问题。

1. 安装jdk1.5 ，配置JAVA_HOME 、path 中加上%JAVA_HOME%\bin ；

2. 安装Maven ，配置MAVEN_HOME 、path 中加上%MAVEN_HOME%\bin ；

3. 配置Maven 的插件安装目录，修改conf\ 下的settings.xml 文件，修改其中的<localRepository> ，如D:/app/m2/repository ；

4. 配置Maven 的可用内存（防止内存溢出），修改文件%MAVEN_HOME%\bin\mvn.bat ，在@REM set MAVEN_OPTS=-Xdebug -Xnoagent -Djava.compiler=NONE... 下添加一行set MAVEN_OPTS= -Xms256m – Xmx 1024 m 。

使用配置管理工具如 SVN 将代码下载到本地。

（二）

首先，修改要检查代码库 top 级的 pom.xml 文件，在build pluginManagement和 build plugins以及 reporting 部分配置插件，以便于下载安装对应版本的插件（ Maven 会自动从其镜像库中下载），方法如下：

...

<build>

     <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-checkstyle-plugin</artifactId>
            <version>2.3</version>
     </plugin>

     <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>findbugs-maven-plugin</artifactId>
            <version>2.0.1</version>
         </plugin>
         <plugin>
               <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-surefire-report-plugin</artifactId>
          <version>2.5</version>
         </plugin>
         <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>cobertura-maven-plugin</artifactId>
            <version>2.4</version>
         </plugin>

...

</plugins>

</pluginManagement>

     <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-checkstyle-plugin</artifactId>
            <version>2.3</version>
     </plugin>

     <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>findbugs-maven-plugin</artifactId>
            <version>2.0.1</version>
         </plugin>
         <plugin>
               <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-surefire-report-plugin</artifactId>
           <version>2.5</version>
         </plugin>
         <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>cobertura-maven-plugin</artifactId>
            <version>2.4</version>
         </plugin>

...

</plugins>

</build>

...

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-checkstyle-plugin</artifactId>

<configLocation>Loong_Checks.xml</configLocation>

</configuration>

</plugin>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-surefire-report-plugin</artifactId>

</plugin>

<groupId>org.codehaus.mojo</groupId>

<artifactId>cobertura-maven-plugin</artifactId>

</plugin>

             <plugin>
                   <groupId>org.codehaus.mojo</groupId>
                 <artifactId>findbugs-maven-plugin</artifactId>
                   <version>2.0.1</version>
                <configuration>
                          <xmlOutput>true</xmlOutput>
                             <effort>Max</effort>
                    </configuration>
               </plugin>

...

</plugins>

</reporting>

...

</project>

maven-checkstyle-plugin 的最新版本为 2.5 ，其对应的 CheckStyle 核心版本为 5.0 ； maven-checkstyle-plugin 2.3 对应的 CheckStyle 核心版本为 4.4 。查看maven仓库中checkstyle插件的 pom 文件，可看到如下内容，其中的版本号就为对应的 CheckStyle 的版本号。其他插件与此同理。

<groupId>checkstyle</groupId>

<artifactId>checkstyle</artifactId>

</dependency>

（三）

接下来，将自定义的checkstyle 规则配置文件my_Checks.xml拷贝到 top 级目录。

也可以将配置文件放在子文件夹下，配置中带上相对路径即可。

……

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-checkstyle-plugin</artifactId>

<configLocation>build-tools/src/main/resources/xx/my_checks.xml</configLocation>

</configuration>

</plugin>

……

</plugins>

</reporting>

如果使用插件自带的规则文件，可以作如下配置。 maven-checkstyle-plugin 插件自带的规则有 sun_checks.xml 、 maven_checks.xml 等，可查看插件包。

……

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-checkstyle-plugin</artifactId>

<configLocation>config/maven_checks.xml</configLocation>

</configuration>

</plugin>

……

</plugins>

</reporting>

（四）

在 reporting 部分增加 jxr 插件（http://maven.apache.org/plugins/maven-jxr-plugin/usage.html ），生成代码报告，这样在 CheckStyle、Findbugs等报告中点击问题对应的链接就可以直接看到出错的代码。

……

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-jxr-plugin</artifactId>

</plugin>

……

</plugins>

</reporting>

（五）

这些插件都是针对代码级的检查，生成的报告也是按照代码目录组织的，如果想要生成一个整体情况的报告，需要使用dashboard插件（http://mojo.codehaus.org/dashboard-maven-plugin/usage.html ），生成聚合报告，修改pom文件，在build pluginManagement和 build plugins以及 reporting部分配置dashboard插件：

...

<build>

<groupId>org.codehaus.mojo</groupId>

<artifactId>dashboard-maven-plugin</artifactId>

</plugin>

...

</plugins>

</pluginManagement>

<groupId>org.codehaus.mojo</groupId>

<artifactId>dashboard-maven-plugin</artifactId>

</plugin>

...

</plugins>

</build>

...

<groupId>org.codehaus.mojo</groupId>

<artifactId>dashboard-maven-plugin</artifactId>

</plugin>

...

</plugins>

</reporting>

...

</project>

（六）

要注意插件仓库的配置，如果项目maven仓库未提供插件的相关版本，有时构建时会报错找不到相关插件，需要修改pom文件：

<id>Codehaus repository</id>

<url>http://repository.codehaus.org/</url>

</pluginRepository>

</pluginRepositories>

（七）

与其他插件不同，要想在dashboard聚合报告中包含FindBugs报告，需要在pom文件中对FindBugs作如下配置（http://mojo.codehaus.org/dashboard-maven-plugin/findbugs_support.html ）：

...

<groupId>org.codehaus.mojo</groupId>

<artifactId>findbugs-maven-plugin</artifactId>

</configuration>

</plugin>

...

</plugins>

</reporting>

WARNING :

Minimum version of findbugs-maven-plugin 1.1.1 required.
Do not use the findbugs "<xmlOutputDirectory/>" config option if you want the dashboard to include the findbugs summary section. see MOJO-987 JIRA issue.

（八）

打开命令窗口，用 cd 命令转到项目所在的目录下。使用 mvn install 命令将 pom 文件中配置的插件下载安装到本地，然后使用 mvn site 命令进行检查并生成报告，用mvn dashboard:dashboard命令聚合报告。运行完毕，项目各子模块目录下会生成 target 目录， target\site下即为该项目的问题报告。如果只想检查指定目录，则cd到该目录下执行mvn命令即可。

这样生成的报告是默认的样式，默认的内容（项目pom文件reporting配置的报告都会生成），关于maven site的自定义配置和高级用法，参见 maven2站点的定制和发布

（九）

如果运行 mvn checkstyle:checkstyle 或 mvn site 过程中出现如下错误，则应该修改 CheckStyle 规则配置文件，去除其中的中文字符。

“[ERROR] BUILD ERROR

[INFO] ------------------------------------------------------------------------

[INFO] An error has occurred in Checkstyle report generation.

Embedded error: Failed during checkstyle configuration

Invalid byte 1 of 1-byte UTF-8 sequence.

”

（十）

如果 checkstyle 跳过代码检查，提示 ” Source directory does not exist - skipping report.” ，可能是源码路径不对，默认路径为${project.build.sourceDirectory}，默认是 src\main\java 。配置 sourceDirectory 属性，如下所示：

……

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-checkstyle-plugin</artifactId>

<configLocation>my_checks.xml</configLocation>

</configuration>

</plugin>

……

</plugins>

</reporting>

WARNING :

关于各插件的参数配置，具体可以参考官网Goals 页面，点击基本Goals 如(checkstyle:checkstyle,findbugs:findbugs)进入页面，即可看到参数列表。

（十一）

checkstyle规则的选取很重要，sun_checks很严格，不一定适合所有项目，所以需要根据项目实际情况和要求，配置checkstyle 规则配置文件。

一个典型的checkstyle规则配置文件：

<?xml version="1.0"?>
<!DOCTYPE module PUBLIC
"-//Puppy Crawl//DTD Check Configuration 1.2//EN"
" http://www.puppycrawl.com/dtds/configuration_1_2.dtd ">< xmlnamespace prefix ="o" ns ="urn:schemas-microsoft-com:office:office" />

<module name="PackageHtml">
        <property name="severity" value="ignore"/>
    </module>

<module name="NewlineAtEndOfFile">
    <property name="fileExtensions" value="MF"/>
    </module>

<module name="Translation"/>

<module name="ConstantName"/>
        <module name="LocalFinalVariableName">
            <property name="format" value="^[a-z][a-zA-Z0-9_]*$"/>
        </module>
        <module name="LocalVariableName">
            <property name="format" value="^[a-z][a-zA-Z0-9_]*$"/>
        </module>
        <module name="MemberName">
            <property name="format" value="^[a-z][a-zA-Z0-9_]*$"/>
        </module>
        <module name="MethodName"/>
        <module name="PackageName"/>
        <module name="ParameterName">
            <property name="format" value="^[a-z][a-zA-Z0-9_]*$"/>
        </module>
        <module name="StaticVariableName">
            <property name="format" value="^[a-z][a-zA-Z0-9_]*$"/>
        </module>
        <module name="TypeName"/>


        
        
        <module name="ModifierOrder"/>
        <module name="RedundantModifier"/>

<module name="ArrayTypeStyle"/>
        
        
        <module name="UpperEll"/>

<module name="EmptyBlock">
            <property name="option" value="text"/>
        </module>
        <module name="LeftCurly"/>
        <module name="NeedBraces"/>
        <module name="RightCurly"/>
        <module name="AvoidNestedBlocks"/>

<module name="FinalClass"/>
        <module name="InterfaceIsType"/>
        
        <module name="HideUtilityClassConstructor"/>

<module name="AvoidInlineConditionals"/>
        <module name="DoubleCheckedLocking"/>    
        <module name="EmptyStatement"/>
        
        
        <module name="IllegalInstantiation"/>
        <module name="InnerAssignment"/>
        
        <module name="MissingSwitchDefault"/>
        
        <module name="SimplifyBooleanExpression"/>
        <module name="SimplifyBooleanReturn"/>


        
        
        <module name="AvoidStarImport"/>
        <module name="IllegalImport"/> 
        <module name="RedundantImport"/>
        <module name="UnusedImports"/>

<module name="JavadocType">
            <property name="excludeScope" value="private"/>
            <property name="scope" value="nothing"/>
        </module>
        <module name="JavadocMethod">
            <property name="allowMissingJavadoc" value="true"/>
            <property name="logLoadErrors" value="true"/>
            <property name="suppressLoadErrors" value="true"/>
        </module>
        <module name="JavadocVariable">
            <property name="excludeScope" value="private"/>
            <property name="scope" value="nothing"/>
        </module>
        <module name="JavadocStyle">
            <property name="checkFirstSentence" value="false"/>
            <property name="checkHtml" value="false"/>
        </module>

</module>

分享到：

使用VC++6.0制作ASP服务器控件简介[转] | Eclipse提高工作效率的好习惯【转】

2011-10-16 23:42
浏览 1441
评论(0)
分类:编程语言
查看更多

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论