cloud.metaapi.sdk.clients

Class HttpClient

java.lang.Object

cloud.metaapi.sdk.clients.HttpClient

public class HttpClient
extends Object

HTTP client library based on request-promise

Constructor Summary

Constructors

Constructor and Description
HttpClient() Constructs HttpClient class instance.
HttpClient(int requestTimeout, int connectTimeout) Constructs HttpClient class instance

Method Summary

Modifier and Type	Method and Description
protected CompletableFuture<kong.unirest.HttpResponse<String>>	makeCheckedRequest(HttpRequestOptions options) Performs a request.
CompletableFuture<String>	request(HttpRequestOptions options) Performs a request.
<T> CompletableFuture<T>	requestJson(HttpRequestOptions options, Class<T> valueType) Does the same as request(HttpRequestOptions) but automatically converts response into json.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpClient

public HttpClient()

Constructs HttpClient class instance. Connect and request timeout are 1 minute each.

HttpClient

public HttpClient(int requestTimeout,
                  int connectTimeout)

Constructs HttpClient class instance

Parameters:

requestTimeout - request timeout in milliseconds

connectTimeout - connect timeout in milliseconds

Method Detail

request

public CompletableFuture<String> request(HttpRequestOptions options)

Performs a request. Completable future response errors are returned as ApiError or subclasses. Also see makeRequest(HttpRequestOptions) for more information about the result completion cases.

Parameters:

options - request options

Returns:

completable future with request results

requestJson

public <T> CompletableFuture<T> requestJson(HttpRequestOptions options,
                                            Class<T> valueType)

Does the same as request(HttpRequestOptions) but automatically converts response into json. If there is a json parsing error, completes exceptionally with JsonProcessingException.

Type Parameters:

T - any DTO object that can be converted from json

Parameters:

options - request options

valueType - class into which the response will be transformed

Returns:

completable future with request results as json

makeCheckedRequest

protected CompletableFuture<kong.unirest.HttpResponse<String>> makeCheckedRequest(HttpRequestOptions options)

Performs a request. Completable future response errors are returned as ApiError or subclasses. Also see makeRequest(HttpRequestOptions) for more information about the result completion cases.

Parameters:

options - request options

Returns:

completable future with request response