add Health Status Api support

Author: lamdav

README.md

@@ -139,6 +139,7 @@ The API has been broken up into sub APIs classes to make it easier to learn and
 &nbsp;&nbsp;[DeployKeysApi](#deploykeysapi)<br/>
 &nbsp;&nbsp;[EventsApi](#eventsapi)<br/>
 &nbsp;&nbsp;[GroupApi](#groupapi)<br/>
+&nbsp;&nbsp;[HealthCheckApi](#healthcheckapi)<br/>
 &nbsp;&nbsp;[IssuesApi](#issuesapi)<br/>
 &nbsp;&nbsp;[JobApi](#jobapi)<br/>
 &nbsp;&nbsp;[LabelsApi](#labelsapi)<br/>
@@ -191,6 +192,13 @@ List<Event> events = gitLabApi.getEventsApi().getAuthenticatedUserEvents(null, n
 List<Group> groups = gitLabApi.getGroupApi().getGroups();
 ```
 
+#### HealthCheckApi
+```java
+// Get the liveness endpoint health check results.
+// Assumes ip_whitelisted
+LivenessHealthCheck healthCheck = gitLabApi.getHealthCheckApi().getLiveness();
+```
+
 #### IssuesApi
 ```java
 // Get a list of issues for the specified project ID

src/main/java/org/gitlab4j/api/GitLabApi.java

@@ -48,6 +48,7 @@ public String getApiNamespace() {
     private CommitsApi commitsApi;
     private DeployKeysApi deployKeysApi;
     private GroupApi groupApi;
+    private HealthCheckApi healthCheckApi;
     private IssuesApi issuesApi;
     private MergeRequestApi mergeRequestApi;
     private MilestonesApi milestonesApi;
@@ -866,6 +867,25 @@ public GroupApi getGroupApi() {
         return (groupApi);
     }
 
+    /**
+     * Gets the HealthCheckApi instance owned by this GitLabApi instance. The HealthCheckApi is used
+     * to perform all admin level gitlab health monitoring.
+     *
+     * @return the HealthCheckApi instance owned by this GitLabApi instance
+     */
+    public HealthCheckApi getHealthCheckApi() {
+
+        if (healthCheckApi == null) {
+            synchronized (this) {
+                if (healthCheckApi == null) {
+                    healthCheckApi = new HealthCheckApi(this);
+                }
+            }
+        }
+
+        return (healthCheckApi);
+    }
+
     /**
      * Gets the IssuesApi instance owned by this GitLabApi instance. The IssuesApi is used
      * to perform all iossue related API calls.

src/main/java/org/gitlab4j/api/GitLabApiClient.java

@@ -46,6 +46,7 @@ public class GitLabApiClient {
 
     private ClientConfig clientConfig;
     private Client apiClient;
+    private String baseUrl;
     private String hostUrl;
     private TokenType tokenType = TokenType.PRIVATE;
     private String authToken;
@@ -83,7 +84,7 @@ public GitLabApiClient(ApiVersion apiVersion, String hostUrl, TokenType tokenTyp
     /**
      * Construct an instance to communicate with a GitLab API server using GitLab API version 4, and the specified
      * server URL, private token, and secret token.
-     * 
+     *
      * @param hostUrl the URL to the GitLab API server
      * @param privateToken the private token to authenticate with
      */
@@ -94,7 +95,7 @@ public GitLabApiClient(String hostUrl, String privateToken) {
     /**
      * Construct an instance to communicate with a GitLab API server using GitLab API version 4, and the specified
      * server URL, private token, and secret token.
-     * 
+     *
      * @param hostUrl the URL to the GitLab API server
      * @param tokenType the type of auth the token is for, PRIVATE or ACCESS
      * @param authToken the token to authenticate with
@@ -133,7 +134,7 @@ public GitLabApiClient(ApiVersion apiVersion, String hostUrl, TokenType tokenTyp
     /**
      * Construct an instance to communicate with a GitLab API server using GitLab API version 4, and the specified
      * server URL, private token, and secret token.
-     * 
+     *
      * @param hostUrl the URL to the GitLab API server
      * @param privateToken the private token to authenticate with
      * @param secretToken use this token to validate received payloads
@@ -145,7 +146,7 @@ public GitLabApiClient(String hostUrl, String privateToken, String secretToken)
     /**
      * Construct an instance to communicate with a GitLab API server using GitLab API version 4, and the specified
      * server URL, private token, and secret token.
-     * 
+     *
      * @param hostUrl the URL to the GitLab API server
      * @param tokenType the type of auth the token is for, PRIVATE or ACCESS
      * @param authToken the token to authenticate with
@@ -158,7 +159,7 @@ public GitLabApiClient(String hostUrl, TokenType tokenType, String authToken, St
     /**
      * Construct an instance to communicate with a GitLab API server using GitLab API version 4, and the specified
      * server URL and private token.
-     * 
+     *
      * @param hostUrl the URL to the GitLab API server
      * @param privateToken the private token to authenticate with
      * @param secretToken use this token to validate received payloads
@@ -169,7 +170,7 @@ public GitLabApiClient(String hostUrl, String privateToken, String secretToken,
     }
 
     /**
-     * Construct an instance to communicate with a GitLab API server using the specified GitLab API version, 
+     * Construct an instance to communicate with a GitLab API server using the specified GitLab API version,
      * server URL and private token.
      *
      * @param apiVersion the ApiVersion specifying which version of the API to use
@@ -183,7 +184,7 @@ public GitLabApiClient(ApiVersion apiVersion, String hostUrl, String privateToke
     }
 
     /**
-     * Construct an instance to communicate with a GitLab API server using the specified GitLab API version, 
+     * Construct an instance to communicate with a GitLab API server using the specified GitLab API version,
      * server URL and private token.
      *
      * @param apiVersion the ApiVersion specifying which version of the API to use
@@ -197,6 +198,7 @@ public GitLabApiClient(ApiVersion apiVersion, String hostUrl, TokenType tokenTyp
 
         // Remove the trailing "/" from the hostUrl if present
         this.hostUrl = (hostUrl.endsWith("/") ? hostUrl.replaceAll("/$", "") : hostUrl);
+        this.baseUrl = this.hostUrl;
         if (ApiVersion.OAUTH2_CLIENT != apiVersion) {
             this.hostUrl += apiVersion.getApiNamespace();
         }
@@ -256,7 +258,6 @@ TokenType getTokenType() {
     /**
      * Set the ID of the user to sudo as.
      *
-     * @param sudoAsId the ID of the user to sudo as
      */
     Integer getSudoAsId() {
         return (sudoAsId);
@@ -273,29 +274,44 @@ void setSudoAsId(Integer sudoAsId) {
 
     /**
      * Construct a REST URL with the specified path arguments.
-     * 
+     *
      * @param pathArgs variable list of arguments used to build the URI
      * @return a REST URL with the specified path arguments
      * @throws IOException if an error occurs while constructing the URL
      */
     protected URL getApiUrl(Object... pathArgs) throws IOException {
+        String url = appendPathArgs(this.hostUrl, pathArgs);
+        return (new URL(url));
+    }
+
+    /**
+     * Construct a REST URL with the specified path arguments using
+     * Gitlab base url.
+     *
+     * @param pathArgs variable list of arguments used to build the URI
+     * @return a REST URL with the specified path arguments
+     * @throws IOException if an error occurs while constructing the URL
+     */
+    protected URL getUrlWithBase(Object... pathArgs) throws IOException {
+        String url = appendPathArgs(this.baseUrl, pathArgs);
+        return (new URL(url));
+    }
 
-        StringBuilder url = new StringBuilder();
-        url.append(hostUrl);
+    private String appendPathArgs(String url, Object... pathArgs) {
+        StringBuilder urlBuilder = new StringBuilder(url);
         for (Object pathArg : pathArgs) {
             if (pathArg != null) {
-                url.append("/");
-                url.append(pathArg.toString());
+                urlBuilder.append("/");
+                urlBuilder.append(pathArg.toString());
             }
         }
-
-        return (new URL(url.toString()));
+        return urlBuilder.toString();
     }
 
     /**
      * Validates the secret token (X-GitLab-Token) header against the expected secret token, returns true if valid,
      * otherwise returns false.
-     * 
+     *
      * @param response the Response instance sent from the GitLab server
      * @return true if the response's secret token is valid, otherwise returns false
      */
@@ -314,7 +330,7 @@ protected boolean validateSecretToken(Response response) {
     /**
      * Perform an HTTP GET call with the specified query parameters and path objects, returning
      * a ClientResponse instance with the data returned from the endpoint.
-     * 
+     *
      * @param queryParams multivalue map of request parameters
      * @param pathArgs variable list of arguments used to build the URI
      * @return a ClientResponse instance with the data returned from the endpoint
@@ -328,7 +344,7 @@ protected Response get(MultivaluedMap<String, String> queryParams, Object... pat
     /**
      * Perform an HTTP GET call with the specified query parameters and URL, returning
      * a ClientResponse instance with the data returned from the endpoint.
-     * 
+     *
      * @param queryParams multivalue map of request parameters
      * @param url the fully formed path to the GitLab API endpoint
      * @return a ClientResponse instance with the data returned from the endpoint
@@ -340,7 +356,7 @@ protected Response get(MultivaluedMap<String, String> queryParams, URL url) {
     /**
      * Perform an HTTP GET call with the specified query parameters and path objects, returning
      * a ClientResponse instance with the data returned from the endpoint.
-     * 
+     *
      * @param queryParams multivalue map of request parameters
      * @param accepts if non-empty will set the Accepts header to this value
      * @param pathArgs variable list of arguments used to build the URI
@@ -355,7 +371,7 @@ protected Response getWithAccepts(MultivaluedMap<String, String> queryParams, St
     /**
      * Perform an HTTP GET call with the specified query parameters and URL, returning
      * a ClientResponse instance with the data returned from the endpoint.
-     * 
+     *
      * @param queryParams multivalue map of request parameters
      * @param url the fully formed path to the GitLab API endpoint
      * @param accepts if non-empty will set the Accepts header to this value
@@ -368,7 +384,7 @@ protected Response getWithAccepts(MultivaluedMap<String, String> queryParams, UR
     /**
      * Perform an HTTP POST call with the specified form data and path objects, returning
      * a ClientResponse instance with the data returned from the endpoint.
-     * 
+     *
      * @param formData the Form containing the name/value pairs
      * @param pathArgs variable list of arguments used to build the URI
      * @return a ClientResponse instance with the data returned from the endpoint
@@ -382,7 +398,7 @@ protected Response post(Form formData, Object... pathArgs) throws IOException {
     /**
      * Perform an HTTP POST call with the specified form data and path objects, returning
      * a ClientResponse instance with the data returned from the endpoint.
-     * 
+     *
      * @param queryParams multivalue map of request parameters
      * @param pathArgs variable list of arguments used to build the URI
      * @return a Response instance with the data returned from the endpoint
@@ -396,7 +412,7 @@ protected Response post(MultivaluedMap<String, String> queryParams, Object... pa
     /**
      * Perform an HTTP POST call with the specified form data and URL, returning
      * a ClientResponse instance with the data returned from the endpoint.
-     * 
+     *
      * @param formData the Form containing the name/value pairs
      * @param url the fully formed path to the GitLab API endpoint
      * @return a ClientResponse instance with the data returned from the endpoint
@@ -453,7 +469,7 @@ protected Response post(StreamingOutput stream, String mediaType, Object... path
     /**
      * Perform an HTTP PUT call with the specified form data and path objects, returning
      * a ClientResponse instance with the data returned from the endpoint.
-     * 
+     *
      * @param queryParams multivalue map of request parameters
      * @param pathArgs variable list of arguments used to build the URI
      * @return a ClientResponse instance with the data returned from the endpoint
@@ -513,7 +529,7 @@ protected Response put(Form formData, URL url) {
     /**
      * Perform an HTTP DELETE call with the specified form data and path objects, returning
      * a Response instance with the data returned from the endpoint.
-     * 
+     *
      * @param queryParams multivalue map of request parameters
      * @param pathArgs variable list of arguments used to build the URI
      * @return a Response instance with the data returned from the endpoint
@@ -526,7 +542,7 @@ protected Response delete(MultivaluedMap<String, String> queryParams, Object...
     /**
      * Perform an HTTP DELETE call with the specified form data and URL, returning
      * a Response instance with the data returned from the endpoint.
-     * 
+     *
      * @param queryParams multivalue map of request parameters
      * @param url the fully formed path to the GitLab API endpoint
      * @return a Response instance with the data returned from the endpoint

src/main/java/org/gitlab4j/api/HealthCheckApi.java

@@ -0,0 +1,80 @@
+package org.gitlab4j.api;
+
+import org.gitlab4j.api.models.LivenessHealthCheck;
+import org.gitlab4j.api.models.ReadinessHealthCheck;
+
+import javax.ws.rs.core.Response;
+import java.io.IOException;
+import java.net.URL;
+
+public class HealthCheckApi extends AbstractApi {
+    public HealthCheckApi(GitLabApi gitLabApi) {
+        super(gitLabApi);
+    }
+
+    /**
+     * Get Health Checks from the liveness endpoint.
+     * Requires ip_whitelist
+     *
+     * GET /-/liveness
+     *
+     * @return LivenessHealthCheck instance
+     * @throws GitLabApiException if any exception occurs
+     */
+    public LivenessHealthCheck getLiveness() throws GitLabApiException, IOException {
+        URL livenessUrl = getApiClient().getUrlWithBase("-", "liveness");
+        Response response = get(Response.Status.OK, null, livenessUrl);
+        return (response.readEntity(LivenessHealthCheck.class));
+    }
+
+    /**
+     * Get Health Checks from the liveness endpoint.
+     *
+     * GET /-/liveness
+     *
+     * @param token Health Status token
+     * @return LivenessHealthCheck instance
+     * @throws GitLabApiException if any exception occurs
+     * @deprecated
+     */
+    public LivenessHealthCheck getLiveness(String token) throws GitLabApiException, IOException {
+        URL livenessUrl = getApiClient().getUrlWithBase("-", "liveness");
+        GitLabApiForm formData = new GitLabApiForm()
+                .withParam("token", token, false);
+        Response response = get(Response.Status.OK, formData.asMap(), livenessUrl);
+        return (response.readEntity(LivenessHealthCheck.class));
+    }
+
+    /**
+     * Get Health Checks from the readiness endpoint.
+     * Requires ip_whitelist
+     *
+     * GET /-/readiness
+     *
+     * @return ReadinessHealthCheck instance
+     * @throws GitLabApiException if any exception occurs
+     */
+    public ReadinessHealthCheck getReadiness() throws GitLabApiException, IOException {
+        URL readinessUrl = getApiClient().getUrlWithBase("-", "readiness");
+        Response response = get(Response.Status.OK, null, readinessUrl);
+        return (response.readEntity(ReadinessHealthCheck.class));
+    }
+
+    /**
+     * Get Health Checks from the readiness endpoint.
+     *
+     * GET /-/readiness
+     *
+     * @param token Health Status token
+     * @return LivenessHealthCheck instance
+     * @throws GitLabApiException if any exception occurs
+     * @deprecated
+     */
+    public ReadinessHealthCheck getReadiness(String token) throws GitLabApiException, IOException {
+        URL readinessUrl = getApiClient().getUrlWithBase("-", "readiness");
+        GitLabApiForm formData = new GitLabApiForm()
+                .withParam("token", token, false);
+        Response response = get(Response.Status.OK, formData.asMap(), readinessUrl);
+        return (response.readEntity(ReadinessHealthCheck.class));
+    }
+}

src/main/java/org/gitlab4j/api/models/HealthCheckStatus.java

@@ -0,0 +1,17 @@
+package org.gitlab4j.api.models;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+
+@XmlAccessorType(XmlAccessType.FIELD)
+public class HealthCheckStatus {
+    private String status;
+
+    public String getStatus() {
+        return this.status;
+    }
+
+    public void setStatus(String status) {
+        this.status = status;
+    }
+}