sonarqube7.2版本web api简析
本文介绍sonarqube的部分实用Web API,并试图联系实际进行分析,方便集成.以7.2版本为例,下载移步官网.
Web API文档路径
安装并部署7.2版本的sonar之后(推荐在linux上安装),在浏览器上打开sonar,默认是ip:9000端口.
http://{ip}:9000/web_api即是sonar的api文档. 由于国内资源较少,当时在官网看了半天文档又查了一堆才发现这个预设的路径.这也是为什么写这篇文章,我认为这样的工具是值得推广的.
认证api
部分的sonar api功能需要依靠权限使用,sonar才用的是Basic Auth,就是最普通的认证.
web_api/api/authentication下可以查看对应的认证api.
例如:
POST api/authentication/login 参数是login和password 没有特别说明的话,这里的login和password都是admin,可以在sonar页面的最上方Administration里点进行密码修改,也可以直接修改config文件.
如果使用POSTMAN测试接口需要认证的sonar GET接口,可以在postman的认证里,选basic auth,然后填login和password,再发GET请求就可以了.
重复度api
GET api/duplications/show
例子参数是key=my_project:/src/foo/Bar.php,使用该接口可以拿某个代码文件的重复度分析,似乎作用不大.后面会讲另一个比较有用的.
issues api
页面在web_api/api/issues,issues意为问题,告警,github上常见这个单词,还是建议多熟悉英文.
这里的api很多是修改和添加注释等内容,这类api适合自己在sonar之上再封装一层.
如果只是客户端读取sonar的issues信息,可以使用GET api/issues/search,这个api的参数非常多,在我看来有几个好用,然后讲解一下.
componentKeys 这是可选参数,意思是组件key,查阅后发现这个key可以代表projectKey,模块的key,单个文件的key,而且可以用逗号隔开传入多个.
比如:my_project,my_project1,my_project2 这样是查了三个工程的issue情况.
这里讲解一下projectKey的概念:
点进自己的某一个扫描后的项目project,会在右下角发现一个projectKey.如果是maven工程,默认是
severities 问题的等级,如果只需要修改最重要等级的,直接用这个参数去获取要改的部分吧.好用.
其他参数都写挺清晰了.
issue 返回json
"paging": { "pageIndex": 1, "pageSize": 100, "total": 1 },
这部分其实是第一页,每页100个,实际上可以用参数分页查询.
issues节点里是个json数组,内容比较多,讲解几个参数.
{
"key": "01fc972e-2a3c-433e-bcae-0bd7f88f5123", issue的唯一key
"component": "com.github.kevinsawicki:http-request:com.github.kevinsawicki.http.HttpRequest", 组件Key,这里是具体到类的
"project": "com.github.kevinsawicki:http-request", projectKe
"rule": "checkstyle:com.puppycrawl.tools.checkstyle.checks.coding.MagicNumberCheck", 规则
"status": "RESOLVED", 解决状态
"resolution": "FALSE-POSITIVE", 是否误报
"severity": "MINOR", 告警等级
"message": "‘3‘ is a magic number.", 告警信息
"line": 81,
"hash": "a227e508d6646b55a086ee11d63b21e9",
"author": "Developer 1",
"effort": "2h1min", 解决问题需要的时间
"creationDate": "2013-05-13T17:55:39+0200",
"updateDate": "2013-05-13T17:55:39+0200",
"tags": [
"bug"
], 之后有个flow节点,这个是和数据流规则相关的.
"flows": [
{
"locations": [
{
"textRange": {
"startLine": 16,
"endLine": 16,
"startOffset": 0,
"endOffset": 30
},
"msg": "Expected position: 5"
}
]
},
{提供locations节点,指定具体的行数.照目前这例子看似乎还只是单文件数据流.
metrics api
metrics,意为度量,在代码扫描中,常常对复杂度,cpd重复代码等进行分析,这也都算metrics,度量的范畴.
Get information on automatic metrics获得自动度量的结果
GET api/metrics/search 这个api可以查找某个项目的所有度量,应该没大用处...
measures api
GET api/measures/component 以component 组件key和metricKeys 度量key作为参数,查询某个项目的度量情况,比如重复度,复杂度,行数统计,例如:
metricKeys=ncloc,complexity,violations
先这么多,之后可能继续更新.
原文地址：https://www.cnblogs.com/zhhiyp/p/9716158.html