使用 Sonar 进行代码质量管理

朴灿烈づ我的快乐病毒、 2022-06-09 10:29 210阅读 0赞

Sonar 概述

Sonar 是一个用于代码质量管理的开放平台。通过插件机制，Sonar可以集成不同的测试工具，代码分析工具，以及持续集成工具。

与持续集成工具（例如 Hudson/Jenkins等）不同，Sonar并不是简单地把不同的代码检查工具结果（例如 FindBugs，PMD等）直接显示在 Web页面上，而是通过不同的插件对这些结果进行再加工处理，通过量化的方式度量代码质量的变化，从而可以方便地对不同规模和种类的工程进行代码质量管理。

在对其他工具的支持方面，Sonar不仅提供了对 IDE的支持，可以在 Eclipse和 IntelliJ IDEA这些工具里联机查看结果；同时 Sonar还对大量的持续集成工具提供了接口支持，可以很方便地在持续集成中使用 Sonar。

此外，Sonar的插件还可以对 Java以外的其他编程语言提供支持，对国际化以及报告文档化也有良好的支持。

Sonar 的安装

Sonar 是 Codehaus上面的一个开源项目，使用的是 LGPL V3软件许可。我们可以在其官方网站上下载其源代码及安装包。

其源代码需要使用分布式版本控制软件 Git进行检出（Check Out），命令行方式如下：

git clone git://github.com/SonarSource/sonar.git

本文主要介绍 Sonar的使用方法，只需要到[Sonar网站][Sonar]下载最近的发行包即可，本文写作时最新的版本为 2.11。

下载 zip包后，直接解压到任意目录，由于 Sonar自带了 Jetty 6的应用服务器环境，所以不需要额外的安装就可以使用，值得一提的是 Sonar也支持部署在 Apache Tomcat应用服务器中。

在 windows  环境中，直接启动 Soanr 的 bin  目录下 windows-x86-64\\StartSonar.bat  即可。

然后在浏览器中访问：http://localhost:9000/

图 **1. Sonar** 访问界面

[![24151936\_h09u.jpg][24151936_h09u.jpg]][24151936_h09u.jpg_24151936_h09u.jpg]

这样就成功安装并启动了 Sonar，但其中没有安装插件，需要用户下载并安装自己所需要的插件。本节以 Quality Index Plugin为例，介绍如何下载及安装 Sonar插件。

首先访问 Sonar  主页中 Dashboard > Sonar > Documentation > Sonar Plugin Library  路径

图 **2. Sonar** 插件的下载

[![24151937\_5CdV.jpg][24151936_h09u.jpg]][24151937_5CdV.jpg_24151936_h09u.jpg]

进入 Quality Index  插件，点击下载路径

图 **3. Quality Index Plugin**  下载

[![24151937\_5CdV.jpg][24151936_h09u.jpg]][24151937_5CdV.jpg_24151936_h09u.jpg]

然后将下载的 sonar-quality-index-plugin-1.1.3.jar文件放到 sonar-2.11\\extensions\\plugins路径下。重启 Sonar，该插件就在 Sonar的平台上运行并开始工作。

数据库设置

Sonar 默认使用的是 Derby数据库，但这个数据库一般用于评估版本或者测试用途。商用及对数据库要求较高时，建议使用其他数据库。Sonar可以支持大多数主流关系型数据库（例如 Microsoft SQL Server, MySQL, Oracle, PostgreSQL等）

本文以 MySQL为例说明如何更改 Sonar的数据库设置：

1.  在 MySQL  中创建 sonar 用户
    
    <table> 
     <tbody> 
      <tr> 
       <td style="width:380.0px; padding:0.0px 5.0px 0.0px 5.0px"> 
        <ul> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px Courier New; background-color:#f6f6f6"> CREATE USER sonar IDENTIFIED BY 'sonar';</li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px Courier New; background-color:#f6f6f6"> </li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px Courier New; background-color:#f6f6f6"> GRANT ALL PRIVILEGES ON *.* TO 'sonar'@'localhost' \</li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px Courier New; background-color:#f6f6f6"> IDENTIFIED BY 'sonar' WITH GRANT OPTION;</li> 
        </ul></td> 
      </tr> 
     </tbody> 
    </table>
2.  
3.  将 MySQL  的驱动文件（如 mysql-connector-java-5.1.13.jar）拷贝到 sonar-2.11\\extensions\\jdbc-driver\\mysql目录
4.  修改 sonar-2.11\\conf\\sonar.properties文件，用 \# 注释原来 Derby  的配置项，并打开 MySQL 数据库的配置项:
    
    <table> 
     <tbody> 
      <tr> 
       <td style="width:534.0px; padding:0.0px 5.0px 0.0px 5.0px"> 
        <ul> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px Courier New; background-color:#f6f6f6"> # Comment the following lines to deactivate the default embedded database.</li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px Courier New; background-color:#f6f6f6"> #sonar.jdbc.url: jdbc:derby://localhost:1527/sonar;create=true</li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px Courier New; background-color:#f6f6f6"> #sonar.jdbc.driverClassName: org.apache.derby.jdbc.ClientDriver</li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px Courier New; background-color:#f6f6f6"> #sonar.jdbc.validationQuery: values(1)</li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px Courier New; background-color:#f6f6f6"> </li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px STHeiti; background-color:#f6f6f6"> <span style="font:12.0px Courier New"></span><span style="font:12.0px STHeiti Light">〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜省略部分〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜</span></li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px Courier New; background-color:#f6f6f6"> <span style="font:12.0px STHeiti Light"></span></li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px STHeiti; background-color:#f6f6f6"> <span style="font:12.0px STHeiti Light">#----- MySQL 5.x/6.x</span></li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px STHeiti; background-color:#f6f6f6"> <span style="font:12.0px STHeiti Light"># Comment the embedded database and uncomment the following&nbsp;</span></li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px STHeiti; background-color:#f6f6f6"> <span style="font:12.0px STHeiti Light">#properties to use MySQL. The validation query is optional.</span></li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px STHeiti; background-color:#f6f6f6"> <span style="font:12.0px STHeiti Light">sonar.jdbc.url: \</span></li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px STHeiti; background-color:#f6f6f6"> <span style="font:12.0px STHeiti Light">jdbc:mysql://localhost:3306/sonar?useUnicode=true&amp;characterEncoding=utf8</span></li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px STHeiti; background-color:#f6f6f6"> <span style="font:12.0px STHeiti Light">sonar.jdbc.driverClassName: com.mysql.jdbc.Driver</span></li> 
         <li style="margin:0.0px 0.0px 0.0px 0.0px; line-height:20.0px; font:12.0px STHeiti; background-color:#f6f6f6"> <span style="font:12.0px STHeiti Light">#sonar.jdbc.validationQuery: select 1</span></li> 
        </ul></td> 
      </tr> 
     </tbody> 
    </table>
5.  
6.  重启 Sonar。

使用 Sonar进行代码质量管理

为了不涉及代码的版权问题及方便读者试验，本节以开源项目 Mojo为例，说明如何使用 Sonar对源代码进行质量管理，在不涉及编译的情况下，本文尽量使用 Sonar的 Nemo演示功能。

首先，需要从[Mojo 首页][Mojo]上下载源代码（本文使用 TortoiseSVN 工具），如图所示，Mojo项目包括了许多工程。

图 **4. Mojo** 工程文件夹

[![24151938\_HvlD.jpg][24151936_h09u.jpg]][24151938_HvlD.jpg_24151936_h09u.jpg]

其中的每个工程都是一个 Maven项目，如图所示：

图 **5. Maven** 工程文件

[![24151938\_CYFl.jpg][24151936_h09u.jpg]][24151938_CYFl.jpg_24151936_h09u.jpg]

编译命令如下：

<table> 
 <tbody> 
  <tr> 
   <td style="width:135.0px; padding:0.0px 5.0px 0.0px 5.0px"> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> mvn clean install</p> </td> 
  </tr> 
 </tbody> 
</table>

编译成功后，再使用如下命令：

<table> 
 <tbody> 
  <tr> 
   <td style="width:121.0px; padding:0.0px 5.0px 0.0px 5.0px"> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> mvn sonar:sonar</p> </td> 
  </tr> 
 </tbody> 
</table>

Maven 插件会自动把所需数据（如单元测试结果、静态检测结果等）上传到 Sonar服务器上，需要说明的是，关于 Sonar的配置并不在每个工程的 pom.xml文件里，而是在 Maven的配置文件 settings.xml文件里，具体配置如下：

<table> 
 <tbody> 
  <tr> 
   <td style="width:590.0px; padding:0.0px 5.0px 0.0px 5.0px"> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp; &lt;profile&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp;&nbsp; &nbsp; &lt;id&gt;sonar&lt;/id&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp;&nbsp; &nbsp; &lt;activation&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; &lt;activeByDefault&gt;true&lt;/activeByDefault&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp;&nbsp; &nbsp; &lt;/activation&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp;&nbsp; &nbsp; &lt;properties&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;sonar.jdbc.url&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; jdbc:mysql://localhost:3306/sonar?useUnicode=true&amp;characterEncoding=utf8</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;/sonar.jdbc.url&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;sonar.jdbc.driver&gt;com.mysql.jdbc.Driver&lt;/sonar.jdbc.driver&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;sonar.jdbc.username&gt;sonar&lt;/sonar.jdbc.username&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;sonar.jdbc.password&gt;sonar&lt;/sonar.jdbc.password&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; &lt;sonar.host.url&gt;http://localhost:9000&lt;/sonar.host.url&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp;&nbsp; &nbsp; &lt;/properties&gt;</p> <p style="margin:0.0px 0.0px 0.0px 0.0px; line-height:22.0px; font:12.0px Courier New; background-color:#f6f6f6"> &nbsp; &lt;/profile&gt;</p> </td> 
  </tr> 
 </tbody> 
</table>

将 Soanr所需要的数据上传到 Sonar服务器上之后，Sonar安装的插件会对这些数据进行分析和处理，并以各种方式显示给用户，从而使用户方便地对代码质量的监测和管理。

例如 Radiator插件可以根据项目的规模进行排序，并用不同演示显示代码质量：

图 **6. Radiator** 插件的显示

[![24151939\_Jvnn.jpg][24151936_h09u.jpg]][24151939_Jvnn.jpg_24151936_h09u.jpg]

Sonar 插件的配置

前面已经提到，Sonar的主要特色是对不同工具产生的检查结果进行再加工处理，Sonar还向用户提供了对数据进行个性化处理的方法。

本节以 Technical Debt插件为例说明如何通过设置参数影响最后的报告结果。首先了解一下这个插件中的“技术债务”的概念，这个概念最早是在 1992 年由 Ward Cunningham在他的论文“The WyCash Portfolio Management System”中提出的，之后被软件工程界接受并推广，《重构》的作者 Martin Fowler也在其[网站][Link 1]上对技术债务有所介绍。其实原理可以理解为“出来混早晚要还的”，当前不规范的代码，会对以后产品修改的成本造成影响。

Soanr 的 Technical Debt插件提供了默认的计算公式，通过对其中的权重参数进行配置，可以适应不同公司和项目对技术债务的计算。

图 **7. Technical Debt**  计算公式

[![24151939\_zcPE.jpg][24151936_h09u.jpg]][24151939_zcPE.jpg_24151936_h09u.jpg]

以上的各项数据指标，可以根据自己公司和项目的不同情况进行设置，如图所示：

图 **8. Sonar** 配置界面

[![24151940\_JsgH.jpg][24151936_h09u.jpg]][24151940_JsgH.jpg_24151936_h09u.jpg]

例如默认参数下同一个项目的技术债务指标如下：

图 **9.** 默认参数下 **Technical Debt**结果

[![24151941\_2NLc.jpg][24151936_h09u.jpg]][24151941_2NLc.jpg_24151936_h09u.jpg]

修改了参数后的结果为：

图 **10.** 配置参数后 **Technical Debt**结果

[![24151941\_vCTN.jpg][24151936_h09u.jpg]][24151941_vCTN.jpg_24151936_h09u.jpg]

可见将 Average time to cover complexity of one (in hours)从 0.2修改为 0.01后，Coverage的权重变小了，从而达到忽略单元测试覆盖率的作用。不同的公司和项目可以根据需要调整各自的参数，参数的调优和策略不在本文的讨论范围之内。

通过以上的示例可以看出，Sonar使用不同类型的图表显示给用户代码质量的结果，并且这些图表不是简单地对单元测试覆盖率或者静态检测工具的结果进行显示，而是根据软件工程理论进行了二次加工后的结果，更加科学和直观。

结束语

Sonar 为代码的质量管理提供了一个平台，对传统的代码静态检测如 PMD、FindBugs等工具进行整合，可以说是目前最强大的代码质量管理工具之一。

文章出处： [IBM developerWorks][]

参考:

[开发工作中使用的软件列表][Link 2]

[懒人可以用Automator提高工作效率][Automator]

[使用脚本简化工作][Link 3]

[程序员要学会偷懒\---正确运用自动化技术][---]

[如何使用搜索技巧来成为一名高效的程序员][Link 4]

[\[《人件》摘录\]: 生产力:赢得战役和输掉战争][Link 5]

[Sonar]: http://www.sonarsource.org/downloads/
[24151936_h09u.jpg]: 
[24151936_h09u.jpg_24151936_h09u.jpg]: /images/20220609/60c6a60011e9454bbad9b93dca037de9.png
[24151937_5CdV.jpg_24151936_h09u.jpg]: /images/20220609/b8b524bca532458198a4adef4d6b2838.png
[Mojo]: http://mojo.codehaus.org/
[24151938_HvlD.jpg_24151936_h09u.jpg]: /images/20220609/f9730759ff9b4b16b4731cd78a0d84b9.png
[24151938_CYFl.jpg_24151936_h09u.jpg]: /images/20220609/db19bd66510347f085856bbda970da0d.png
[24151939_Jvnn.jpg_24151936_h09u.jpg]: /images/20220609/c0eafe75a9fa42779193e37d8b5a5242.png
[Link 1]: http://www.martinfowler.com/bliki/TechnicalDebt.html
[24151939_zcPE.jpg_24151936_h09u.jpg]: /images/20220609/2d7281d49c4e4aa0b0fc1fd111610cab.png
[24151940_JsgH.jpg_24151936_h09u.jpg]: /images/20220609/d013374d7ff7424193c6617028ff7afa.png
[24151941_2NLc.jpg_24151936_h09u.jpg]: /images/20220609/0e90a5d909054f97beb71e179348cfb6.png
[24151941_vCTN.jpg_24151936_h09u.jpg]: /images/20220609/e77cf4308d15471ab9c80f47914ba99f.png
[IBM developerWorks]: http://www.ibm.com/developerworks/cn/java/j-lo-sonar/index.html
[Link 2]: http://blog.csdn.net/horkychen/article/details/7777295
[Automator]: http://blog.csdn.net/horkychen/article/details/7709670
[Link 3]: http://blog.csdn.net/horkychen/article/details/7734525
[---]: http://blog.csdn.net/horkychen/article/details/6324604
[Link 4]: http://blog.csdn.net/horkychen/article/details/7787035
[Link 5]: http://blog.csdn.net/horkychen/article/details/6989568