org.gitlab.api.http

Class GitlabHTTPRequestor

java.lang.Object

org.gitlab.api.http.GitlabHTTPRequestor

public class GitlabHTTPRequestor
extends Object

Gitlab HTTP Requestor Responsible for handling HTTP requests to the Gitlab API

Author:

@timols (Tim O)

Constructor Summary

Constructors

Constructor and Description
GitlabHTTPRequestor(GitlabAPI root)

Method Summary

Modifier and Type	Method and Description
<T> Iterator<T>	asIterator(String tailApiUrl, Class<T> type)
GitlabHTTPRequestor	authenticate(String token, TokenType type, AuthMethod method) Sets authentication data for the request.
<T> List<T>	getAll(String tailUrl, Class<T[]> type)
GitlabHTTPRequestor	method(Method method) Sets the HTTP Request method for the request.
<T> T	to(String tailAPIUrl, Class<T> type)
<T> T	to(String tailAPIUrl, Class<T> type, T instance) Opens the HTTP(S) connection, submits any data and parses the response.
<T> T	to(String tailAPIUrl, T instance)
GitlabHTTPRequestor	with(String key, Object value) Sets the HTTP Form Post parameters for the request Has a fluent api for method chaining
GitlabHTTPRequestor	withAttachment(String key, File file) Sets the HTTP Form Post parameters for the request Has a fluent api for method chaining

Methods inherited from class java.lang.Object

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

Constructor Detail

GitlabHTTPRequestor

public GitlabHTTPRequestor(GitlabAPI root)

Method Detail

authenticate

public GitlabHTTPRequestor authenticate(String token,
                                        TokenType type,
                                        AuthMethod method)

Sets authentication data for the request. Has a fluent api for method chaining.

Parameters:

token - The token value

type - The type of the token

method - The authentication method

Returns:

this

method

public GitlabHTTPRequestor method(Method method)

Sets the HTTP Request method for the request. Has a fluent api for method chaining.

Parameters:

method - The HTTP method

Returns:

this

with

public GitlabHTTPRequestor with(String key,
                                Object value)

Sets the HTTP Form Post parameters for the request Has a fluent api for method chaining

Parameters:

key - Form parameter Key

value - Form parameter Value

Returns:

this

withAttachment

public GitlabHTTPRequestor withAttachment(String key,
                                          File file)

Sets the HTTP Form Post parameters for the request Has a fluent api for method chaining

Parameters:

key - Form parameter Key

file - File data

Returns:

this

to

public <T> T to(String tailAPIUrl,
                T instance)
         throws IOException

Throws:

IOException

to

public <T> T to(String tailAPIUrl,
                Class<T> type)
         throws IOException

Throws:

IOException

to

public <T> T to(String tailAPIUrl,
                Class<T> type,
                T instance)
         throws IOException

Opens the HTTP(S) connection, submits any data and parses the response. Will throw an error

Type Parameters:

T - The return type of the method

Parameters:

tailAPIUrl - The url to open a connection to (after the host and namespace)

type - The type of the response to be deserialized from

instance - The instance to update from the response

Returns:

An object of type T

Throws:

IOException - on gitlab api error

getAll

public <T> List<T> getAll(String tailUrl,
                          Class<T[]> type)

asIterator

public <T> Iterator<T> asIterator(String tailApiUrl,
                                  Class<T> type)