io.digitalbits.sdk.requests

Class TransactionsRequestBuilder

java.lang.Object

io.digitalbits.sdk.requests.RequestBuilder

io.digitalbits.sdk.requests.TransactionsRequestBuilder

public class TransactionsRequestBuilder
extends RequestBuilder

Builds requests connected to transactions.

Nested Class Summary

Nested classes/interfaces inherited from class io.digitalbits.sdk.requests.RequestBuilder

RequestBuilder.Order

Constructor Summary

Constructors

Constructor and Description
TransactionsRequestBuilder(OkHttpClient httpClient, HttpUrl serverURI)

Method Summary

Modifier and Type	Method and Description
TransactionsRequestBuilder	cursor(java.lang.String token) Sets cursor parameter on the request.
Page<TransactionResponse>	execute() Build and execute request.
static Page<TransactionResponse>	execute(OkHttpClient httpClient, HttpUrl uri) Requests specific uri and returns Page of TransactionResponse.
TransactionsRequestBuilder	forAccount(KeyPair account) Builds request to GET /accounts/{account}/transactions
TransactionsRequestBuilder	forLedger(long ledgerSeq) Builds request to GET /ledgers/{ledgerSeq}/transactions
TransactionsRequestBuilder	limit(int number) Sets limit parameter on the request.
TransactionsRequestBuilder	order(RequestBuilder.Order direction) Sets order parameter on the request.
EventSource	stream(EventListener<TransactionResponse> listener) Allows to stream SSE events from horizon.
TransactionResponse	transaction(HttpUrl uri) Requests specific uri and returns TransactionResponse.

Methods inherited from class java.lang.Object

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

Constructor Detail

TransactionsRequestBuilder

public TransactionsRequestBuilder(OkHttpClient httpClient,
                                  HttpUrl serverURI)

Method Detail

transaction

public TransactionResponse transaction(HttpUrl uri)
                                throws java.io.IOException

Requests specific uri and returns TransactionResponse. This method is helpful for getting the links.

Throws:

java.io.IOException

forAccount

public TransactionsRequestBuilder forAccount(KeyPair account)

Builds request to GET /accounts/{account}/transactions

Parameters:

account - Account for which to get transactions

See Also:

Transactions for Account

forLedger

public TransactionsRequestBuilder forLedger(long ledgerSeq)

Builds request to GET /ledgers/{ledgerSeq}/transactions

Parameters:

ledgerSeq - Ledger for which to get transactions

See Also:

Transactions for Ledger

execute

public static Page<TransactionResponse> execute(OkHttpClient httpClient,
                                                HttpUrl uri)
                                         throws java.io.IOException,
                                                TooManyRequestsException

Requests specific uri and returns Page of TransactionResponse. This method is helpful for getting the next set of results.

Returns:

Page of TransactionResponse

Throws:

TooManyRequestsException - when too many requests were sent to the Horizon server.

java.io.IOException

stream

public EventSource stream(EventListener<TransactionResponse> listener)

Allows to stream SSE events from horizon. Certain endpoints in Horizon can be called in streaming mode using Server-Sent Events. This mode will keep the connection to horizon open and horizon will continue to return responses as ledgers close.

Parameters:

listener - EventListener implementation with TransactionResponse type

Returns:

EventSource object, so you can close() connection when not needed anymore

See Also:

Server-Sent Events, Response Format documentation

execute

public Page<TransactionResponse> execute()
                                  throws java.io.IOException,
                                         TooManyRequestsException

Build and execute request.

Returns:

Page of TransactionResponse

Throws:

TooManyRequestsException - when too many requests were sent to the Horizon server.

java.io.IOException

cursor

public TransactionsRequestBuilder cursor(java.lang.String token)

Description copied from class: RequestBuilder

Sets cursor parameter on the request. A cursor is a value that points to a specific location in a collection of resources. The cursor attribute itself is an opaque value meaning that users should not try to parse it.

Overrides:

cursor in class RequestBuilder

See Also:

Page documentation

limit

public TransactionsRequestBuilder limit(int number)

Description copied from class: RequestBuilder

Sets limit parameter on the request. It defines maximum number of records to return. For range and default values check documentation of the endpoint requested.

Overrides:

limit in class RequestBuilder

Parameters:

number - maxium number of records to return

order

public TransactionsRequestBuilder order(RequestBuilder.Order direction)

Description copied from class: RequestBuilder

Sets order parameter on the request.

Overrides:

order in class RequestBuilder

Parameters:

direction - RequestBuilder.Order