使用uwolfer gerrit-rest-java-client获取Gerrit信息

使用Gerrit来做代码管理工具的话，难免要调用Gerrit的API。

Gerrit rest api

我们来看个例子，体会下gerrit rest api的交互过程：

请求如下, changes是API，q字符串想必gerrit的用户是熟悉的，n是限定个数：

GET /changes/?q=status:open+is:watched&n=2 HTTP/1.0

响应信息例：

HTTP/1.1 200 OK  Content-Disposition: attachment  Content-Type: application/json; charset=UTF-8  )]}'  [    {      "id": "demo~master~Idaf5e098d70898b7119f6f4af5a6c13343d64b57",      "project": "demo",      "branch": "master",      "change_id": "Idaf5e098d70898b7119f6f4af5a6c13343d64b57",      "subject": "One change",      "status": "NEW",      "created": "2012-07-17 07:18:30.854000000",      "updated": "2012-07-17 07:19:27.766000000",      "mergeable": true,      "insertions": 26,      "deletions": 10,      "_number": 1756,      "owner": {        "name": "John Doe"      },    },    {      "id": "demo~master~I09c8041b5867d5b33170316e2abc34b79bbb8501",      "project": "demo",      "branch": "master",      "change_id": "I09c8041b5867d5b33170316e2abc34b79bbb8501",      "subject": "Another change",      "status": "NEW",      "created": "2012-07-17 07:18:30.884000000",      "updated": "2012-07-17 07:18:30.885000000",      "mergeable": true,      "insertions": 12,      "deletions": 18,      "_number": 1757,      "owner": {        "name": "John Doe"      },      "_more_changes": true    }  ]

gerrit的网站上有Rest API的指南和文档。指南：，文档：

uwolfer gerrit rest java client

我们要编程调用gerrit api时发现，光是pojo对象就得写好多。这样例行公事的工作当然是交给开源库来实现最划算了。

比如我们可以使用 uwolfer gerrit rest java client.

引入依赖

大家的后端工程应该是使用maven管理的，我们就先引入maven依赖：

        
             
      
       com.urswolfer.gerrit.client.rest
              
      
       gerrit-rest-java-client
              
      
       0.8.16
          
     
    

鉴权

下一步我们就可以调用gerrit-rest-java-client封装的API来调用gerrit rest api了。

首先要鉴权，记得gerrit的设置中有一项是HTTP password么，这里就该它发挥作用了。

GerritRestApiFactory gerritRestApiFactory = new GerritRestApiFactory();        GerritAuthData.Basic authData = new GerritAuthData.Basic("http://gerrit网址", "用户名", "HTTP password");        GerritApi gerritApi = gerritRestApiFactory.create(authData);

访问gerrit数据

鉴权成功之后，我们就可以通过gerritApi为所欲为了。

例1，查询10个status为merged的change:

List
    
      changes = gerritApi.changes().query("status:merged").withLimit(10).get();            for (ChangeInfo ci : changes) {                System.out.println("Change ID:"+ci.changeId);                System.out.println("Project:"+ci.project);                System.out.println("Branch:"+ci.branch);                System.out.println("Subject:"+ci.subject);                System.out.println("=======================");            }
    

运行例：

Change ID:I5c490fba0f109824ae5c5cd91e7222787da9f41dProject:xxxBranch:yyySubject:zzz

例2，遍历当前gerrit下都有些什么工程

List
    
      projects = gerritApi.projects().list().get();            for (ProjectInfo pi: projects){                System.out.println(pi.name);                System.out.println(pi.description);                System.out.println("~~~~~~~~~~~~~~");            }
    

输出例：

code/device/asus/fugunull

code/device/asus/fugu-kernel

null

code/device/commonnull

code/device/coolpad/common

null

完整代码

下面是上面两例的完整代码：

pom.xml:

    
        
     
      4.0.0
         
     
      cn.alios.basic.test
         
     
      TestGerrit3
         
     
      1.0.0-SNAPSHOT
     
         
              
       
        com.urswolfer.gerrit.client.rest
               
       
        gerrit-rest-java-client
               
       
        0.8.16
           
      
     
    

Java代码：

package cn.alios.basic.tools;import com.google.gerrit.extensions.api.GerritApi;import com.google.gerrit.extensions.common.ChangeInfo;import com.google.gerrit.extensions.common.ProjectInfo;import com.google.gerrit.extensions.restapi.RestApiException;import com.urswolfer.gerrit.client.rest.GerritAuthData;import com.urswolfer.gerrit.client.rest.GerritRestApiFactory;import java.util.List;public class TestGerrit {    public static void main(String[] args) {        GerritRestApiFactory gerritRestApiFactory = new GerritRestApiFactory();        GerritAuthData.Basic authData = new GerritAuthData.Basic("http://gerrit.com", "user", "HttpPassword");        GerritApi gerritApi = gerritRestApiFactory.create(authData);        try {            List
    
      changes = gerritApi.changes().query("status:merged").withLimit(10).get();            for (ChangeInfo ci : changes) {                System.out.println("Change ID:"+ci.changeId);                System.out.println("Project:"+ci.project);                System.out.println("Branch:"+ci.branch);                System.out.println("Subject:"+ci.subject);                System.out.println("=======================");            }            List
     
       projects = gerritApi.projects().list().get();            for (ProjectInfo pi: projects){                System.out.println(pi.name);                System.out.println(pi.description);                System.out.println("~~~~~~~~~~~~~~");            }        } catch (RestApiException e) {            e.printStackTrace();        }    }}