com.messners.gitlab.api

Class GitLabApiClient

java.lang.Object

com.messners.gitlab.api.GitLabApiClient

public class GitLabApiClient
extends Object

This class utilizes the Jersey client package to communicate with a GitLab API endpoint.

Author:

Greg Messner

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	GitLabApiClient.AcceptAllHostnameVerifier

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	API_NAMESPACE
protected static String	PRIVATE_TOKEN_HEADER

Constructor Summary

Constructors

Constructor and Description
GitLabApiClient(String hostUrl, String privateToken) Construct an instance to communicate with a GitLab API server using the specified server URL and private token.

Method Summary

Methods

Modifier and Type	Method and Description
protected javax.ws.rs.core.Response	delete(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 Response instance with the data returned from the endpoint.
protected javax.ws.rs.core.Response	delete(javax.ws.rs.core.MultivaluedMap<String,String> queryParams, URL url) Perform an HTTP DELETE call with the specified form data and URL, returning a Response instance with the data returned from the endpoint.
protected javax.ws.rs.core.Response	get(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.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 URL	getApiUrl(Object... pathArgs) Construct a REST URL with the specified path arguments.
boolean	getIgnoreCertificateErrors() Returns true if the API is setup to ignore SSL certificate errors, otherwise returns false.
protected javax.ws.rs.client.Invocation.Builder	invocation(URL url, javax.ws.rs.core.MultivaluedMap<String,String> queryParams)
protected javax.ws.rs.core.Response	post(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.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	put(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.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.
void	setIgnoreCerificateErrors(boolean ignoreCertificateErrors) Sets up the Jersey system ignore SSL certificate errors or not.

Methods inherited from class java.lang.Object

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

Field Detail

PRIVATE_TOKEN_HEADER

protected static final String PRIVATE_TOKEN_HEADER

See Also:

Constant Field Values

API_NAMESPACE

protected static final String API_NAMESPACE

See Also:

Constant Field Values

Constructor Detail

GitLabApiClient

public GitLabApiClient(String hostUrl,
               String privateToken)

Construct an instance to communicate with a GitLab API server using the specified server URL and private token.

Parameters:

hostUrl - the URL to the GitLab API server

privateToken - the private token to authenticate with

Method Detail

getIgnoreCertificateErrors

public boolean getIgnoreCertificateErrors()

Returns true if the API is setup to ignore SSL certificate errors, otherwise returns false.

Returns:

true if the API is setup to ignore SSL certificate errors, otherwise returns false

setIgnoreCerificateErrors

public void setIgnoreCerificateErrors(boolean ignoreCertificateErrors)

Sets up the Jersey system ignore SSL certificate errors or not.

WARNING: Setting this to true will affect ALL uses of HttpsURLConnection and Jersey.

Parameters:

ignoreCertificateErrors -

getApiUrl

protected URL getApiUrl(Object... pathArgs)
                 throws IOException

Construct a REST URL with the specified path arguments.

Parameters:

pathArgs -

Returns:

a REST URL with the specified path arguments

Throws:

IOException

get

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

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:

queryParams -

pathArgs -

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

IOException

get

protected javax.ws.rs.core.Response get(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.

Parameters:

queryParams -

url -

Returns:

a ClientResponse instance with the data returned from the endpoint

post

protected javax.ws.rs.core.Response post(javax.ws.rs.core.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.

Parameters:

formData -

pathArgs -

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

IOException

post

protected javax.ws.rs.core.Response post(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.

Parameters:

formData -

url -

Returns:

a ClientResponse instance with the data returned from the endpoint

put

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

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:

queryParams -

pathArgs -

Returns:

a ClientResponse instance with the data returned from the endpoint

Throws:

IOException

put

protected javax.ws.rs.core.Response put(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.

Parameters:

queryParams -

url -

Returns:

a ClientResponse instance with the data returned from the endpoint

delete

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

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

Parameters:

queryParams -

pathArgs -

Returns:

a Response instance with the data returned from the endpoint

Throws:

IOException

delete

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

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

Parameters:

queryParams -

url -

Returns:

a Response instance with the data returned from the endpoint

invocation

protected javax.ws.rs.client.Invocation.Builder invocation(URL url,
                                               javax.ws.rs.core.MultivaluedMap<String,String> queryParams)