Sonar简介
Sonar是一个用于代码质量管理的开源平台，用于管理源代码的质量，可以从七个维度检测代码质量
通过插件形式，可以支持包括java,C#,C/C++,PL/SQL,Cobol,JavaScrip,Groovy等等二十几种编程语言的代码质量管理与检测sonarQube能带来什么？
Developers' Seven Deadly Sins
1.糟糕的复杂度分布
文件、类、方法等，如果复杂度过高将难以改变，这会使得开发人员难以理解它们，
且如果没有自动化的单元测试，对于程序中的任何组件的改变都将可能导致需要全面的回归测试
显然程序中包含大量复制粘贴的代码是质量低下的
sonar可以展示源码中重复严重的地方
sonar可以很方便地统计并展示单元测试覆盖率
sonar可以通过PMD,CheckStyle,Findbugs等等代码规则检测工具规范代码编写
5.没有足够的或者过多的注释
没有注释将使代码可读性变差，特别是当不可避免地出现人员变动时，程序的可读性将大幅下降
而过多的注释又会使得开发人员将精力过多地花费在阅读注释上，亦违背初衷
6.潜在的bug
sonar可以通过PMD,CheckStyle,Findbugs等等代码规则检测工具检测出潜在的bug
通过sonar可以找出循环，展示包与包、类与类之间的相互依赖关系
可以检测自定义的架构规则
通过sonar可以管理第三方的jar包
可以利用LCOM4检测单个任务规则的应用情况
检测耦合
关于Spaghetti Design：http://docs.codehaus.org/display/SONAR/Spaghetti+Design
通过sonar可以有效检测以上在程序开发过程中的七大问题
SonarQube安装
预置条件
1.已安装JAVA环境
2.已安装有MySQL数据库
软件下载地址：http://www.sonarqube.org/downloads/
下载SonarQube与SonarQube Runner
中文补丁包下载：http://docs.codehaus.org/display/SONAR/Chinese+Pack
1.数据库配置
进入数据库命令
#mysql -u root -p
mysql> CREATE DATABASE sonar CHARACTER SET utf8 COLLATE utf8_general_ci;
mysql> CREATE USER 'sonar' IDENTIFIED BY 'sonar';
mysql> GRANT ALL ON sonar.* TO 'sonar'@'%' IDENTIFIED BY 'sonar';
mysql> GRANT ALL ON sonar.* TO 'sonar'@'localhost' IDENTIFIED BY 'sonar';
mysql> FLUSH PRIVILEGES;
2.安装sonar与sonar-runner
将下载的sonar-3.7.zip包解压至Linux某路径如/usr/local
将下载的sonar-runner-dist-2.3.zip包解压某路径/usr/local
添加SONAR_HOME、SONAR_RUNNER_HOME环境变量，并将SONAR_RUNNER_HOME加入PATH
修改sonar配置文件
编辑<install_directory>/conf/sonar.properties文件，配置数据库设置，默认已经提供了各类数据库的支持
这里使用mysql，因此取消mysql模块的注释
#vi sonar.properties
- sonar.jdbc.username: sonar
- sonar.jdbc.password: sonar
- sonar.jdbc.url: jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true
- # Optional properties
- sonar.jdbc.driverClassName: com.mysql.jdbc.Driver
修改sonar-runner的配置文件
切换至sonar-runner的安装目录下，修改sonar-runner.properties
根据实际使用数据库情况取消相应注释
- #Configure here general information about the environment, such as SonarQube DB details for example
- #No information about specific project should appear here
- #----- Default SonarQube server
- sonar.host.url=http://localhost:9000
- #----- PostgreSQL
- #sonar.jdbc.url=jdbc:postgresql://localhost/sonar
- #----- MySQL
- sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8
- #----- Oracle
- #sonar.jdbc.url=jdbc:oracle:thin:@localhost/XE
- #----- Microsoft SQLServer
- #sonar.jdbc.url=jdbc:jtds:sqlserver://localhost/sonar;SelectMethod=Cursor
- #----- Global database settings
- sonar.jdbc.username=sonar
- sonar.jdbc.password=sonar
- #----- Default source code encoding
- sonar.sourceEncoding=UTF-8
- #----- Security (when 'sonar.forceAuthentication' is set to 'true')
- sonar.login=admin
- sonar.password=admin
3.添加数据库驱动
除了Oracle数据库外，其它数据库驱动都默认已经提供了，且这些已添加的驱动是sonar唯一支持的，因此不需要修改
如果是Oracle数据库，需要复制JDBC驱动至<install_directory>/extensions/jdbc-driver/oracle目录
4.启动服务
目录切换至sonar的<install_directory>/bin/linux-x86-64/目录，启动服务
#./sonar.sh start 启动服务
#./sonar.sh stop 停止服务
#./sonar.sh restart 重启服务
至此，sonar就安装好了
访问http:\\localhost:9000即可
5.sonar中文补丁包安装
中文包安装
安装中文补丁包可以通过访问http:\\localhost:9000，打开sonar后，进入更新中心安装
或者下载中文补丁包后，放到SONARQUBE_HOME/extensions/plugins目录，然后重启SonarQube服务
sonar作为Linux服务并开机自启动
新建文件/etc/init.d/sonar，输入如下内容：
- #!/bin/sh
- #
- # rc file for SonarQube
- #
- # chkconfig: 345 96 10
- # description: SonarQube system (www.sonarsource.org)
- #
- ### BEGIN INIT INFO
- # Provides: sonar
- # Required-Start: $network
- # Required-Stop: $network
- # Default-Start: 3 4 5
- # Default-Stop: 0 1 2 6
- # Short-Description: SonarQube system (www.sonarsource.org)
- # Description: SonarQube system (www.sonarsource.org)
- ### END INIT INFO
- /usr/bin/sonar $*
SonarQube开机自启动（Ubuntu, 32位）：
sudo ln -s $SONAR_HOME/bin/linux-x86-32/sonar.sh /usr/bin/sonar
sudo chmod 755 /etc/init.d/sonar
sudo update-rc.d sonar defaults
SonarQube开机自启动（RedHat, CentOS, 64位）：
sudo ln -s $SONAR_HOME/bin/linux-x86-64/sonar.sh /usr/bin/sonar
sudo chmod 755 /etc/init.d/sonar
sudo chkconfig --add sonar
使用SonarQube Runner分析源码
预置条件
已安装SonarQube Runner且环境变量已配置，即sonar-runner命令可在任意目录下执行
1.在项目源码的根目录下创建sonar-project.properties配置文件
以android项目为例：
- sonar.projectKey=android-sonarqube-runner
- sonar.projectName=Simple Android project analyzed with the SonarQube Runner
- sonar.projectVersion=1.0
- sonar.sources=src
- sonar.binaries=bin/classes
- sonar.language=java
- sonar.sourceEncoding=UTF-8
- sonar.profile=Android Lint
注：要使用Android Lint
规则分析需要先访问http:\\localhost:9000更新中心添加Android Lint插件，使其可以分析Android Lint规则
2.执行分析
切换到项目源码根目录，执行命令
# sonar-runner
分析成功后访问http:\\localhost:9000即可查看分析结果
不同参数的意思：
http://docs.codehaus.org/display/SONAR/Analysis+Parameters
不同项目的源码分析示例下载：
https://github.com/SonarSource/sonar-examples/zipball/master
与IDE关联
最后，当然了，得与IDE相关联，才能更方便地实时查看
以Eclipse为例，请见：http://docs.sonarqube.org/display/SONAR/SonarQube+in+Eclipse
附：
sonarQube官网地址：http://www.sonarqube.org/
sonarQube官方文档地址：http://docs.codehaus.org/display/SONAR/Documentation
sonarQube示例地址：http://nemo.sonarqube.org/
http://www.myexception.cn/open-source/1307345.html
==============================================================================================================
和oracle集成
1 准备好JAVA环境。
2 新建ORACLE表空间和用户.
2 下载最新的sonar，解压到目录C:\app\sonar-3.6
3 修改C:\app\sonar-3.6\conf\sonar.properties：
sonar.jdbc.username:sonar
sonar.jdbc.password:sonar
sonar.jdbc.url:jdbc:oracle:thin:@localhost:1521/orcl
sonar.jdbc.driverClassName:oracle.jdbc.driver.OracleDriver
4 执行C:\app\sonar-3.6\bin\windows-x86-64\StartSonar.bat(操作系统为windows server 2008),启动自带的JETTY服务器。打开http://localhost:9000，如果显示sonar主页，则sonar安装成功.
5 安装中文插件和其它语言插件：将插件JAR包放到目录C:\app\sonar-3.6\extensions\plugins,重启服务即安装成功。
中文插件：sonar-l10n-zh-plugin-1.5
JS语言：sonar-javascript-plugin-1.3
web（HTML）语言:sonar-web-plugin-1.2
6 添加数据库驱动到C:\app\sonar-3.6\extensions\jdbc-driver\oracle\ojdbc-14.jar
第二步：安装SONAR-RUNNER
1 下载sonar-runner,解压到目录C:\app\sonar-runner-2.2.2
2 修改C:\app\sonar-runner-2.2.2\sonar-runner.properties:
sonar.jdbc.url=jdbc:oracle:thin:@localhost:1521/orcl
sonar.jdbc.username=sonar
sonar.jdbc.password=sonar
sonar.sourceEncoding=UTF-8
sonar.login=admin
sonar.password=admin
3 添加系统环境变量：SONAR_RUNNER_HOME 值为 C:\app\sonar-runner-2.2.2
4 修改环境变量Path,在变量值末尾添加：“;%SONAR_RUNNER_HOME%\bin”
5 命令行里执行 sonar-runner -h 如果显示如下内容,则安装成功。
C:\app\sonar-runner-2.2.2
INFO:
INFO: usage: sonar-runner [options]
INFO:
INFO: Options:
INFO: -D,--define <arg> Define property
INFO: -e,--errors Produce execution error messages
INFO: -h,--help Display help information
INFO: -v,--version Display version information
INFO: -X,--debug Produce execution debug output
第三步：分析代码
1 拷贝代码到C:\workspase\xjglxt
代码目录结构如图：
2 添加C:\workspase\xjglxt\sonar-project.properties 内容如下 :
#required metadata
#projectKey项目的唯一标识，不能重复
sonar.projectKey=xjglxt
sonar.projectName=xjglxt
sonar.projectVersion=1.0
sonar.sourceEncoding=UTF-8
sonar.modules=java-module,javascript-module,html-module
# Java module
java-module.sonar.projectName=Java Module
java-module.sonar.language=java
# .表示projectBaseDir指定的目录
java-module.sonar.sources=.
java-module.sonar.projectBaseDir=src
sonar.binaries=classes
# JavaScript module
javascript-module.sonar.projectName=JavaScript Module
javascript-module.sonar.language=js
javascript-module.sonar.sources=js
javascript-module.sonar.projectBaseDir=webRoot
# Html module
html-module.sonar.projectName=Html Module
html-module.sonar.language=web
html-module.sonar.sources=pages
html-module.sonar.projectBaseDir=webRoot
3 命令行里执行 cd ../../workspase/xjglxt 到项目根目录。
然后执行命令：sonar-runner，控制台会打印分析过程。当出现SUCCESS时，则分析成功。
INFO: --------------------
INFO: EXECUTION SUCCESS
INFO: --------------------
Total time: 2:37.891s
Final Memory: 14M/449M
INFO: --------------------
官网：http://www.sonarqube.org/
示例：http://nemo.sonarsource.org/
文档&插件：http://docs.codehaus.org/
遇到的问题及解决方法：
1 问题：项目列表里只有最近一次分析的项目。
原因：sonar.projectKey设置了同一个值。
2 项目名设置中文时显示乱码(sonar.projectName=中文)
原因：未找到
扫一扫
3376
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
