org.gitlab4j.api

Class AbstractApi

java.lang.Object

org.gitlab4j.api.AbstractApi

Direct Known Subclasses:

CommitsApi, GroupApi, MergeRequestApi, ProjectApi, RepositoryApi, RepositoryFileApi, ServicesApi, SessionApi, UserApi

public abstract class AbstractApi
extends Object

This class is the base class for all the sub API classes. It provides implementations of delete(), get(), post() and put() that are re-used by all the sub-classes.

Constructor Summary

Constructors

Constructor and Description
AbstractApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method and Description
protected void	addFormParam(javax.ws.rs.core.Form formData, String name, Object value) Convenience method for adding query and form parameters to a get() or post() call.
protected void	addFormParam(javax.ws.rs.core.Form formData, String name, Object value, boolean required) Convenience method for adding query and form parameters to a get() or post() call.
protected javax.ws.rs.core.Response	delete(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.MultivaluedMap<String,String> queryParams, Object... pathArgs) Perform an HTTP DELETE call with the specified form data and path objects, returning a ClientResponse instance with the data returned from the endpoint.
protected javax.ws.rs.core.Response	delete(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.MultivaluedMap<String,String> queryParams, URL url) Perform an HTTP DELETE call with the specified form data and URL, returning a ClientResponse instance with the data returned from the endpoint.
protected javax.ws.rs.core.Response	get(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.MultivaluedMap<String,String> queryParams, Object... pathArgs) Perform an HTTP GET call with the specified query parameters and path objects, returning a ClientResponse instance with the data returned from the endpoint.
protected javax.ws.rs.core.Response	get(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.MultivaluedMap<String,String> queryParams, URL url) Perform an HTTP GET call with the specified query parameters and URL, returning a ClientResponse instance with the data returned from the endpoint.
protected GitLabApiClient	getApiClient()
protected GitLabApiException	handle(Exception thrown) Wraps an exception in a GitLabApiException if needed.
protected javax.ws.rs.core.Response	post(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.Form formData, Object... pathArgs) Perform an HTTP POST call with the specified form data and path objects, returning a ClientResponse instance with the data returned from the endpoint.
protected javax.ws.rs.core.Response	post(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.Form formData, URL url) Perform an HTTP POST call with the specified form data and URL, returning a ClientResponse instance with the data returned from the endpoint.
protected javax.ws.rs.core.Response	post(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.MultivaluedMap<String,String> queryParams, Object... pathArgs) Perform an HTTP POST call with the specified form data and path objects, returning a ClientResponse instance with the data returned from the endpoint.
protected javax.ws.rs.core.Response	put(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.MultivaluedMap<String,String> queryParams, Object... pathArgs) Perform an HTTP PUT call with the specified form data and path objects, returning a ClientResponse instance with the data returned from the endpoint.
protected javax.ws.rs.core.Response	put(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.MultivaluedMap<String,String> queryParams, URL url) Perform an HTTP PUT call with the specified form data and URL, returning a ClientResponse instance with the data returned from the endpoint.
protected javax.ws.rs.core.Response	validate(javax.ws.rs.core.Response response, javax.ws.rs.core.Response.Status expected) Validates response the response from the server against the expected HTTP status and the returned secret token, if either is not correct will throw a GitLabApiException.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractApi

public AbstractApi(GitLabApi gitLabApi)

Method Detail

getApiClient

protected GitLabApiClient getApiClient()

get

protected javax.ws.rs.core.Response get(javax.ws.rs.core.Response.Status expectedStatus,
                                        javax.ws.rs.core.MultivaluedMap<String,String> queryParams,
                                        Object... pathArgs)
                                 throws GitLabApiException

Perform an HTTP GET call with the specified query parameters and path objects, returning a ClientResponse instance with the data returned from the endpoint.

Parameters:

expectedStatus - the HTTP status that should be returned from the server

queryParams - multivalue map of request parameters

pathArgs - variable list of arguments used to build the URI

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

GitLabApiException - if any exception occurs during execution

get

protected javax.ws.rs.core.Response get(javax.ws.rs.core.Response.Status expectedStatus,
                                        javax.ws.rs.core.MultivaluedMap<String,String> queryParams,
                                        URL url)
                                 throws GitLabApiException

Perform an HTTP GET call with the specified query parameters and URL, returning a ClientResponse instance with the data returned from the endpoint.

Parameters:

expectedStatus - the HTTP status that should be returned from the server

queryParams - multivalue map of request parameters

url - the fully formed path to the GitLab API endpoint

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

GitLabApiException - if any exception occurs during execution

post

protected javax.ws.rs.core.Response post(javax.ws.rs.core.Response.Status expectedStatus,
                                         javax.ws.rs.core.Form formData,
                                         Object... pathArgs)
                                  throws GitLabApiException

Perform an HTTP POST call with the specified form data and path objects, returning a ClientResponse instance with the data returned from the endpoint.

Parameters:

expectedStatus - the HTTP status that should be returned from the server

formData - the Form containing the name/value pairs for the POST data

pathArgs - variable list of arguments used to build the URI

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

GitLabApiException - if any exception occurs during execution

post

protected javax.ws.rs.core.Response post(javax.ws.rs.core.Response.Status expectedStatus,
                                         javax.ws.rs.core.MultivaluedMap<String,String> queryParams,
                                         Object... pathArgs)
                                  throws GitLabApiException

Perform an HTTP POST call with the specified form data and path objects, returning a ClientResponse instance with the data returned from the endpoint.

Parameters:

expectedStatus - the HTTP status that should be returned from the server

queryParams - multivalue map of request parameters

pathArgs - variable list of arguments used to build the URI

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

GitLabApiException - if any exception occurs during execution

post

protected javax.ws.rs.core.Response post(javax.ws.rs.core.Response.Status expectedStatus,
                                         javax.ws.rs.core.Form formData,
                                         URL url)
                                  throws GitLabApiException

Perform an HTTP POST call with the specified form data and URL, returning a ClientResponse instance with the data returned from the endpoint.

Parameters:

expectedStatus - the HTTP status that should be returned from the server

formData - the Form containing the name/value pairs for the POST data

url - the fully formed path to the GitLab API endpoint

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

GitLabApiException - if any exception occurs during execution

put

protected javax.ws.rs.core.Response put(javax.ws.rs.core.Response.Status expectedStatus,
                                        javax.ws.rs.core.MultivaluedMap<String,String> queryParams,
                                        Object... pathArgs)
                                 throws GitLabApiException

Perform an HTTP PUT call with the specified form data and path objects, returning a ClientResponse instance with the data returned from the endpoint.

Parameters:

expectedStatus - the HTTP status that should be returned from the server

queryParams - multivalue map of request parameters

pathArgs - variable list of arguments used to build the URI

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

GitLabApiException - if any exception occurs during execution

put

protected javax.ws.rs.core.Response put(javax.ws.rs.core.Response.Status expectedStatus,
                                        javax.ws.rs.core.MultivaluedMap<String,String> queryParams,
                                        URL url)
                                 throws GitLabApiException

Perform an HTTP PUT call with the specified form data and URL, returning a ClientResponse instance with the data returned from the endpoint.

Parameters:

expectedStatus - the HTTP status that should be returned from the server

queryParams - multivalue map of request parameters

url - the fully formed path to the GitLab API endpoint

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

GitLabApiException - if any exception occurs during execution

delete

protected javax.ws.rs.core.Response delete(javax.ws.rs.core.Response.Status expectedStatus,
                                           javax.ws.rs.core.MultivaluedMap<String,String> queryParams,
                                           Object... pathArgs)
                                    throws GitLabApiException

Perform an HTTP DELETE call with the specified form data and path objects, returning a ClientResponse instance with the data returned from the endpoint.

Parameters:

expectedStatus - the HTTP status that should be returned from the server

queryParams - multivalue map of request parameters

pathArgs - variable list of arguments used to build the URI

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

GitLabApiException - if any exception occurs during execution

delete

protected javax.ws.rs.core.Response delete(javax.ws.rs.core.Response.Status expectedStatus,
                                           javax.ws.rs.core.MultivaluedMap<String,String> queryParams,
                                           URL url)
                                    throws GitLabApiException

Perform an HTTP DELETE call with the specified form data and URL, returning a ClientResponse instance with the data returned from the endpoint.

Parameters:

expectedStatus - the HTTP status that should be returned from the server

queryParams - multivalue map of request parameters

url - the fully formed path to the GitLab API endpoint

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

GitLabApiException - if any exception occurs during execution

addFormParam

protected void addFormParam(javax.ws.rs.core.Form formData,
                            String name,
                            Object value)
                     throws IllegalArgumentException

Convenience method for adding query and form parameters to a get() or post() call.

Parameters:

formData - the Form containing the name/value pairs

name - the name of the field/attribute to add

value - the value of the field/attribute to add

Throws:

IllegalArgumentException

addFormParam

protected void addFormParam(javax.ws.rs.core.Form formData,
                            String name,
                            Object value,
                            boolean required)
                     throws IllegalArgumentException

Convenience method for adding query and form parameters to a get() or post() call. If required is true and value is null, will throw an IllegalArgumentException.

Parameters:

formData - the Form containing the name/value pairs

name - the name of the field/attribute to add

value - the value of the field/attribute to add

required - the field is required flag

Throws:

IllegalArgumentException - if a required parameter is null or empty

validate

protected javax.ws.rs.core.Response validate(javax.ws.rs.core.Response response,
                                             javax.ws.rs.core.Response.Status expected)
                                      throws GitLabApiException

Validates response the response from the server against the expected HTTP status and the returned secret token, if either is not correct will throw a GitLabApiException.

Parameters:

response - response

expected - expected respone status

Returns:

original response if the response status is expected

Throws:

GitLabApiException - if HTTP status is not as expected, or the secret token doesn't match

handle

protected GitLabApiException handle(Exception thrown)

Wraps an exception in a GitLabApiException if needed.

Parameters:

thrown - the exception that should be wrapped

Returns:

either the untouched GitLabApiException or a new GitLabApiExceptin wrapping a non-GitLabApiException