Package org.stellar.sdk.requests

Class ClaimableBalancesRequestBuilder

java.lang.Object

org.stellar.sdk.requests.RequestBuilder

org.stellar.sdk.requests.ClaimableBalancesRequestBuilder

public class ClaimableBalancesRequestBuilder
extends RequestBuilder

Builds requests connected to claimable balances.

Nested Class Summary

Nested classes/interfaces inherited from class org.stellar.sdk.requests.RequestBuilder

RequestBuilder.Order

Constructor Summary

Constructors

Constructor	Description
ClaimableBalancesRequestBuilder(okhttp3.OkHttpClient httpClient, okhttp3.HttpUrl serverURI)

Method Summary

Modifier and Type	Method	Description
ClaimableBalanceResponse	claimableBalance(String id)	The claimable balance details endpoint provides information on a claimable balance.
ClaimableBalanceResponse	claimableBalance(okhttp3.HttpUrl uri)	Requests specific uri and returns ClaimableBalanceResponse.
ClaimableBalancesRequestBuilder	cursor(String token)	Sets cursor parameter on the request.
Page<ClaimableBalanceResponse>	execute()	Build and execute request.
static Page<ClaimableBalanceResponse>	execute(okhttp3.OkHttpClient httpClient, okhttp3.HttpUrl uri)	Requests specific uri and returns Page of ClaimableBalanceResponse.
ClaimableBalancesRequestBuilder	forAsset(Asset asset)	Returns all claimable balances which hold a given asset.
ClaimableBalancesRequestBuilder	forClaimant(String claimant)	Returns all claimable balances which can be claimed by a given account id.
ClaimableBalancesRequestBuilder	forSponsor(String sponsor)	Returns all claimable balances sponsored by a given account.
ClaimableBalancesRequestBuilder	limit(int number)	Sets limit parameter on the request.
ClaimableBalancesRequestBuilder	order(RequestBuilder.Order direction)	Sets order parameter on the request.

Methods inherited from class org.stellar.sdk.requests.RequestBuilder

setAssetParameter, setAssetsParameter

Methods inherited from class java.lang.Object

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

Constructor Details

ClaimableBalancesRequestBuilder

public ClaimableBalancesRequestBuilder(okhttp3.OkHttpClient httpClient,
 okhttp3.HttpUrl serverURI)

Method Details

claimableBalance

public ClaimableBalanceResponse claimableBalance(okhttp3.HttpUrl uri)
                                          throws IOException

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

Throws:

IOException - if the request fails due to an IOException, including but not limited to a timeout, connection failure etc.

claimableBalance

public ClaimableBalanceResponse claimableBalance(String id)
                                          throws IOException

The claimable balance details endpoint provides information on a claimable balance.

Parameters:

id - specifies which claimable balance to load.

Returns:

The claimable balance details.

Throws:

IOException - if the request fails due to an IOException, including but not limited to a timeout, connection failure etc.

forSponsor

public ClaimableBalancesRequestBuilder forSponsor(String sponsor)

Returns all claimable balances sponsored by a given account.

Parameters:

sponsor - Account ID of the sponsor.

Returns:

current ClaimableBalancesRequestBuilder instance

forAsset

public ClaimableBalancesRequestBuilder forAsset(Asset asset)

Returns all claimable balances which hold a given asset.

Parameters:

asset - The Asset held by the claimable balance.

Returns:

current ClaimableBalancesRequestBuilder instance

forClaimant

public ClaimableBalancesRequestBuilder forClaimant(String claimant)

Returns all claimable balances which can be claimed by a given account id.

Parameters:

claimant - Account ID of the address which can claim the claimable balance.

Returns:

current ClaimableBalancesRequestBuilder instance

execute

public static Page<ClaimableBalanceResponse> execute(okhttp3.OkHttpClient httpClient,
 okhttp3.HttpUrl uri)
                                              throws IOException,
TooManyRequestsException

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

Returns:

Page of ClaimableBalanceResponse

Throws:

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

IOException - if the request fails due to an IOException, including but not limited to a timeout, connection failure etc.

execute

public Page<ClaimableBalanceResponse> execute()
                                       throws IOException,
TooManyRequestsException

Build and execute request.

Returns:

Page of ClaimableBalanceResponse

Throws:

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

IOException - if the request fails due to an IOException, including but not limited to a timeout, connection failure etc.

cursor

public ClaimableBalancesRequestBuilder cursor(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

Parameters:

token - A cursor is a value that points to a specific location in a collection of resources.

See Also:

• Page documentation

limit

public ClaimableBalancesRequestBuilder 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 ClaimableBalancesRequestBuilder order(RequestBuilder.Order direction)

Description copied from class: RequestBuilder

Sets order parameter on the request.

Overrides:

order in class RequestBuilder

Parameters:

direction - RequestBuilder.Order