com.cybersource.payments

Class ApiClient

java.lang.Object

com.cybersource.payments.ApiClient

public class ApiClient
extends Object

Constructor Summary

Constructors

Constructor and Description
ApiClient(Configuration configuration)

Method Summary

Modifier and Type	Method and Description
ApiClient	addDefaultHeader(String key, String value) Add a default header.
<T> T	deserialize(com.sun.jersey.api.client.ClientResponse response, TypeRef returnType) Deserialize response body to Java object according to the Content-Type.
String	escapeString(String str) Escape the given string to be used as URL query value.
String	formatDate(Date date) Format the given Date object into string.
String	getBasePath()
DateFormat	getDateFormat() Get the date format used to parse/format date parameters.
ApiClient	getDateFormat(DateFormat dateFormat) Set the date format used to parse/format date parameters.
Map<String,com.sun.jersey.api.client.Client>	getHostMap() Get the map of API base paths to Jersey Client objects
<T> T	invokeAPI(String path, String method, List<Pair> queryParams, Object body, Map<String,String> headerParams, Map<String,Object> formParams, String accept, String contentType, TypeRef returnType) Invoke API by sending HTTP request with the given options.
boolean	isDebugging() Check that whether debugging is enabled for this API client.
List<Pair>	parameterToPairs(String collectionFormat, String name, Object value)
String	parameterToString(Object param) Format the given parameter object into string.
Date	parseDate(String str) Parse the given string into Date object.
String	selectHeaderAccept(String[] accepts) Select the Accept header's value from the given accepts array: if JSON exists in the given array, use it; otherwise use all of them (joining into a string)
String	selectHeaderContentType(String[] contentTypes) Select the Content-Type header's value from the given array: if JSON exists in the given array, use it; otherwise use the first one of the array.
String	serialize(Object obj, String contentType) Serialize the given Java object into string according the given Content-Type (only JSON is supported for now).
ApiClient	setBasePath(String basePath)
ApiClient	setDebugging(boolean debugging) Enable/disable debugging for this API client.
ApiClient	setUserAgent(String userAgent) Set the User-Agent header's value (by adding to the default header map).

Methods inherited from class java.lang.Object

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

Constructor Detail

ApiClient

public ApiClient(Configuration configuration)

Method Detail

getBasePath

public String getBasePath()

setBasePath

public ApiClient setBasePath(String basePath)

getHostMap

public Map<String,com.sun.jersey.api.client.Client> getHostMap()

Get the map of API base paths to Jersey Client objects

setUserAgent

public ApiClient setUserAgent(String userAgent)

Set the User-Agent header's value (by adding to the default header map).

addDefaultHeader

public ApiClient addDefaultHeader(String key,
                                  String value)

Add a default header.

Parameters:

key - The header's key

value - The header's value

isDebugging

public boolean isDebugging()

Check that whether debugging is enabled for this API client.

setDebugging

public ApiClient setDebugging(boolean debugging)

Enable/disable debugging for this API client.

Parameters:

debugging - To enable (true) or disable (false) debugging

getDateFormat

public DateFormat getDateFormat()

Get the date format used to parse/format date parameters.

getDateFormat

public ApiClient getDateFormat(DateFormat dateFormat)

Set the date format used to parse/format date parameters.

parseDate

public Date parseDate(String str)

Parse the given string into Date object.

formatDate

public String formatDate(Date date)

Format the given Date object into string.

parameterToString

public String parameterToString(Object param)

Format the given parameter object into string.

parameterToPairs

public List<Pair> parameterToPairs(String collectionFormat,
                                   String name,
                                   Object value)

selectHeaderAccept

public String selectHeaderAccept(String[] accepts)

Select the Accept header's value from the given accepts array: if JSON exists in the given array, use it; otherwise use all of them (joining into a string)

Parameters:

accepts - The accepts array to select from

Returns:

The Accept header to use. If the given array is empty, null will be returned (not to set the Accept header explicitly).

selectHeaderContentType

public String selectHeaderContentType(String[] contentTypes)

Select the Content-Type header's value from the given array: if JSON exists in the given array, use it; otherwise use the first one of the array.

Parameters:

contentTypes - The Content-Type array to select from

Returns:

The Content-Type header to use. If the given array is empty, JSON will be used.

escapeString

public String escapeString(String str)

Escape the given string to be used as URL query value.

serialize

public String serialize(Object obj,
                        String contentType)
                 throws ApiException

Serialize the given Java object into string according the given Content-Type (only JSON is supported for now).

Throws:

ApiException

deserialize

public <T> T deserialize(com.sun.jersey.api.client.ClientResponse response,
                         TypeRef returnType)
                  throws ApiException

Deserialize response body to Java object according to the Content-Type.

Throws:

ApiException

invokeAPI

public <T> T invokeAPI(String path,
                       String method,
                       List<Pair> queryParams,
                       Object body,
                       Map<String,String> headerParams,
                       Map<String,Object> formParams,
                       String accept,
                       String contentType,
                       TypeRef returnType)
                throws ApiException

Invoke API by sending HTTP request with the given options.

Parameters:

path - The sub-path of the HTTP URL

method - The request method, one of "GET", "POST", "PUT", and "DELETE"

queryParams - The query parameters

body - The request body object

headerParams - The header parameters

formParams - The form parameters

accept - The request's Accept header

contentType - The request's Content-Type header

returnType - The return type into which to deserialize the response

Returns:

The response body in type of string

Throws:

ApiException