# gerrit-rest-java-client
**Repository Path**: geekjoker/gerrit-rest-java-client
## Basic Information
- **Project Name**: gerrit-rest-java-client
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-11-25
- **Last Updated**: 2021-11-25
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
gerrit-rest-java-client
======================
[](https://travis-ci.org/uwolfer/gerrit-rest-java-client)
[](https://ci.appveyor.com/project/uwolfer/gerrit-rest-java-client/branch/master)
[](https://coveralls.io/r/uwolfer/gerrit-rest-java-client)
[](https://sonarcloud.io/dashboard/index/com.urswolfer.gerrit.client.rest:gerrit-rest-java-client)
[](https://sonarcloud.io/dashboard/index/com.urswolfer.gerrit.client.rest:gerrit-rest-java-client)
[](https://maven-badges.herokuapp.com/maven-central/com.urswolfer.gerrit.client.rest/gerrit-rest-java-client)
Introduction
-----------
Java implementation of the [Gerrit Code Review Tool] REST API.
Only Gerrit 2.6 or newer is supported (missing / incomplete REST API in older versions).
This implementation is used for example as base for the [Gerrit IntelliJ Plugin].
Many different authentication-methods are supported (HTTP basic, HTTP digest, LDAP with form,
HTTP password from Gerrit setting, ...).
[Gerrit Code Review Tool]: https://www.gerritcodereview.com/
[Gerrit IntelliJ Plugin]: https://github.com/uwolfer/gerrit-intellij-plugin
Usage
-------
This library implements [com.google.gerrit.extensions.api.GerritApi].
You just need a few lines to get it working:
```java
GerritRestApiFactory gerritRestApiFactory = new GerritRestApiFactory();
GerritAuthData.Basic authData = new GerritAuthData.Basic("http://localhost:8080");
// or: authData = new GerritAuthData.Basic("https://example.com/gerrit", "user", "password");
GerritApi gerritApi = gerritRestApiFactory.create(authData);
List changes = gerritApi.changes().query("status:merged").withLimit(10).get();
```
If you like to write a script instead of a full Java application, you might want to use [Groovy].
There is a [basic Groovy example] available.
_Note:_ It is not guaranteed that all interfaces are implemented. If an implementation is missing, you get a
com.google.gerrit.extensions.restapi.NotImplementedException. Feel free to implement it and create a pull
request at GitHub - it is quite easy! :)
_Note:_ The source of com.google.gerrit.extensions is included in this repository at the
moment because not all extensions to this API are merged into Gerrit repository yet.
[com.google.gerrit.extensions.api.GerritApi]: https://gerrit.googlesource.com/gerrit/+/HEAD/gerrit-extension-api/src/main/java/com/google/gerrit/extensions/api/GerritApi.java
[Groovy]: http://www.groovy-lang.org/
[basic Groovy example]: https://github.com/uwolfer/gerrit-rest-java-client/blob/master/examples/Basic.groovy
Maven Artifact
--------------
Releases are available with Maven:
```xml
com.urswolfer.gerrit.client.rest
gerrit-rest-java-client
0.9.3
```
Android Support
---------------
Apache HttpClient causes problems on Android platform. There is a workaround by using [HttpClient for Android].
Android support builds are not officially released, but you should be able to create your own build by using the
[httpclient-android branch]. You probably want to merge master branch into this branch before building it.
[HttpClient for Android]: https://hc.apache.org/httpcomponents-client-4.3.x/android-port.html
[httpclient-android branch]: https://github.com/uwolfer/gerrit-rest-java-client/tree/httpclient-android
Dependencies
------------
This library depends on [Apache HttpClient], [Gson] and [Guava].
[Apache HttpClient]: https://hc.apache.org/httpcomponents-client-ga/
[Gson]: https://github.com/google/gson
[Guava]: https://github.com/google/guava
Your Support
------------
If you like this library, you can support it:
* Star it: [Star it at GitHub](https://github.com/uwolfer/gerrit-rest-java-client). GitHub account required.
* Improve it: Report bugs or feature requests. Or even fix / implement them by yourself - everything is open source!
* Donate: You can find donation-possibilities at the bottom of this file.
Donations
--------
If you like this work, you can support it with
[this donation link](https://www.paypal.com/webscr?cmd=_s-xclick&hosted_button_id=8F2GZVBCVEDUQ).
If you don't like Paypal (Paypal takes 2.9% plus $0.30 per transaction fee from your donation), please contact me.
Please only use the link from github.com/uwolfer/gerrit-intellij-plugin to verify that it is correct.
Copyright and license
--------------------
Copyright 2013 - 2018 Urs Wolfer
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this work except in compliance with the License.
You may obtain a copy of the License in the LICENSE file, or at:
[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.