org.gitlab4j.api

Class AbstractApi

java.lang.Object

org.gitlab4j.api.AbstractApi

All Implemented Interfaces:

Constants

Direct Known Subclasses:

CommitsApi, DeployKeysApi, EventsApi, GroupApi, IssuesApi, JobApi, MergeRequestApi, NamespaceApi, NotesApi, PipelineApi, ProjectApi, RepositoryApi, RepositoryFileApi, ServicesApi, SessionApi, UserApi

public abstract class AbstractApi
extends Object
implements Constants

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.

Nested Class Summary

Nested classes/interfaces inherited from interface org.gitlab4j.api.Constants

Constants.ActionType, Constants.IssueScope, Constants.IssueState, Constants.JobScope, Constants.LineType, Constants.PipelineOrderBy, Constants.PipelineScope, Constants.ProjectOrderBy, Constants.SortOrder, Constants.StateEvent, Constants.TargetType, Constants.TokenType

Field Summary

Fields inherited from interface org.gitlab4j.api.Constants

NEXT_PAGE_HEADER, PAGE_HEADER, PAGE_PARAM, PER_PAGE, PER_PAGE_PARAM, PREV_PAGE_HEADER, TOTAL_HEADER, TOTAL_PAGES_HEADER

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 GitLabApi.ApiVersion	getApiVersion()
protected int	getDefaultPerPage()
protected javax.ws.rs.core.MultivaluedMap<String,String>	getDefaultPerPageParam() Creates a MultivaluedMap instance containing the "per_page" param with the default value.
protected javax.ws.rs.core.MultivaluedMap<String,String>	getPageQueryParams(int page, int perPage) Creates a MultivaluedMap instance containing "page" and "per_page" params.
protected javax.ws.rs.core.Response	getWithAccepts(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.MultivaluedMap<String,String> queryParams, String accepts, 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 GitLabApiException	handle(Exception thrown) Wraps an exception in a GitLabApiException if needed.
protected boolean	isApiVersion(GitLabApi.ApiVersion apiVersion)
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	putWithFormData(javax.ws.rs.core.Response.Status expectedStatus, javax.ws.rs.core.Form formData, 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 String	urlEncode(String s)
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

getApiVersion

protected GitLabApi.ApiVersion getApiVersion()

isApiVersion

protected boolean isApiVersion(GitLabApi.ApiVersion apiVersion)

getDefaultPerPage

protected int getDefaultPerPage()

getApiClient

protected GitLabApiClient getApiClient()

urlEncode

protected String urlEncode(String s)
                    throws GitLabApiException

Throws:

GitLabApiException

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

getWithAccepts

protected javax.ws.rs.core.Response getWithAccepts(javax.ws.rs.core.Response.Status expectedStatus,
                                                   javax.ws.rs.core.MultivaluedMap<String,String> queryParams,
                                                   String accepts,
                                                   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

accepts - if non-empty will set the Accepts header to this value

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

putWithFormData

protected javax.ws.rs.core.Response putWithFormData(javax.ws.rs.core.Response.Status expectedStatus,
                                                    javax.ws.rs.core.Form formData,
                                                    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

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

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 response 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

getPageQueryParams

protected javax.ws.rs.core.MultivaluedMap<String,String> getPageQueryParams(int page,
                                                                            int perPage)

Creates a MultivaluedMap instance containing "page" and "per_page" params.

Parameters:

page - the page to get

perPage - the number of projects per page

Returns:

a MultivaluedMap instance containing "page" and "per_page" params

getDefaultPerPageParam

protected javax.ws.rs.core.MultivaluedMap<String,String> getDefaultPerPageParam()

Creates a MultivaluedMap instance containing the "per_page" param with the default value.

Returns:

a MultivaluedMap instance containing the "per_page" param with the default value