com.wallee.android.sdk.request.api

Class VolleyWebServiceApiClient

java.lang.Object

com.wallee.android.sdk.request.api.VolleyWebServiceApiClient

All Implemented Interfaces:

WebServiceApiClient

public final class VolleyWebServiceApiClient
extends java.lang.Object
implements WebServiceApiClient

The request manager is responsible for the communication with the wallee web service.

The request manager is implemented in an asynchronous way. This implies to call the remote service a callback as to be provided which is invoked once the request has completed.

The request manager uses the CredentialsProvider to fetch the Credentials to access the web service.

The request manager is not responsible to cache the returned result.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_BASE_URL The default URL to which the requests will be sent to.

Constructor Summary

Constructors

Constructor and Description
VolleyWebServiceApiClient(RequestQueue requestQueue, CredentialsProvider credentialsProvider) Constructs a new request manager.
VolleyWebServiceApiClient(RequestQueue requestQueue, CredentialsProvider credentialsProvider, java.lang.String baseUrl) Constructs a new request manager.

Method Summary

Modifier and Type	Method and Description
void	buildMobileSdkUrl(RequestCallback<MobileSdkUrl> callback) This method constructs the URL which can be used to render the payment form within a WebView.
void	fetchPaymentMethodConfigurations(RequestCallback<java.util.List<PaymentMethodConfiguration>> callback) This method fetches the possible payment methods from the remote server.
void	fetchTokenVersions(RequestCallback<java.util.List<TokenVersion>> callback) This method fetches the TokenVersion which may be used by the app user.
void	processOneClickToken(Token token, RequestCallback<Transaction> callback) This method processes the transaction with the given token.
void	readTransaction(RequestCallback<Transaction> callback) This method fetches the transaction object.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_BASE_URL

public static final java.lang.String DEFAULT_BASE_URL

The default URL to which the requests will be sent to.

See Also:

Constant Field Values

Constructor Detail

VolleyWebServiceApiClient

public VolleyWebServiceApiClient(RequestQueue requestQueue,
                                 CredentialsProvider credentialsProvider)

Constructs a new request manager. The created instance will use the DEFAULT_BASE_URL URL.

Parameters:

requestQueue - the request queue which should be used. The request queue pools the requests which the request manager sends to the remote server. The request queue may be shared with the rest of the app.

credentialsProvider - the credential provider which should be used. The credential provider gives access to the credentials which the request manager requires to access the remote server.

VolleyWebServiceApiClient

public VolleyWebServiceApiClient(RequestQueue requestQueue,
                                 CredentialsProvider credentialsProvider,
                                 java.lang.String baseUrl)

Constructs a new request manager.

Parameters:

requestQueue - the request queue which should be used. The request queue pools the requests which the request manager sends to the remote server. The request queue may be shared with the rest of the app.

credentialsProvider - the credential provider which should be used. The credential provider gives access to the credentials which the request manager requires to access the remote server.

baseUrl - the base URL to which the requests should be sent to. This may differ when using another environment. This is mainly here for testing purposes.

Method Detail

fetchTokenVersions

public void fetchTokenVersions(RequestCallback<java.util.List<TokenVersion>> callback)

Description copied from interface: WebServiceApiClient

This method fetches the TokenVersion which may be used by the app user. The returned tokens are intended to be uses as one-click tokens. The method will only return valid tokens.

Specified by:

fetchTokenVersions in interface WebServiceApiClient

Parameters:

callback - the callback which is invoked once the token versions have been loaded.

See Also:

Service Definition

buildMobileSdkUrl

public void buildMobileSdkUrl(RequestCallback<MobileSdkUrl> callback)

Description copied from interface: WebServiceApiClient

This method constructs the URL which can be used to render the payment form within a WebView. The URL is used for example in DefaultPaymentFormView.

Specified by:

buildMobileSdkUrl in interface WebServiceApiClient

Parameters:

callback - the callback which is invoked once the URL has been loaded.

See Also:

Service Definition

fetchPaymentMethodConfigurations

public void fetchPaymentMethodConfigurations(RequestCallback<java.util.List<PaymentMethodConfiguration>> callback)

Description copied from interface: WebServiceApiClient

This method fetches the possible payment methods from the remote server. The returned methods depend on the transaction which is linked with the Credentials. As such the method may return less payment methods as configured in the wallee backend.

The payment method configuration is linked with an icon. This icon can be loaded by IconRequestManager.fetchIcon(PaymentMethodConfiguration, RequestCallback).

Specified by:

fetchPaymentMethodConfigurations in interface WebServiceApiClient

Parameters:

callback - the callback which is invoked once all the payment methods has been loaded.

See Also:

Service Definition

readTransaction

public void readTransaction(RequestCallback<Transaction> callback)

Description copied from interface: WebServiceApiClient

This method fetches the transaction object. This is useful to determine the current state of the transaction or to fetch the details of the transaction.

Specified by:

readTransaction in interface WebServiceApiClient

Parameters:

callback - the callback which is invoked once the transaction has been loaded.

See Also:

Service Definition

processOneClickToken

public void processOneClickToken(Token token,
                                 RequestCallback<Transaction> callback)

Description copied from interface: WebServiceApiClient

This method processes the transaction with the given token. Processing means the remote server is invoked to authorize the transaction.

Specified by:

processOneClickToken in interface WebServiceApiClient

Parameters:

token - the token which should be used to process the transaction.

callback - the callback which is invoked once the remote server gives a response.

See Also:

Service Definition