com.stripe.net

Class APIResource

java.lang.Object

com.stripe.model.StripeObject

com.stripe.net.APIResource

Direct Known Subclasses:

Account, ApplicationFee, Balance, BalanceTransaction, BitcoinTransaction, Charge, CountrySpec, Coupon, Customer, Dispute, Event, ExternalAccount, Fee, FeeRefund, FileUpload, Invoice, InvoiceItem, Order, OrderReturn, PagingIterator, Plan, Product, Recipient, Refund, Reversal, SKU, StatusTransitions, Subscription, ThreeDSecure, Token, Transfer

public abstract class APIResource
extends StripeObject

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	APIResource.RequestMethod
static class	APIResource.RequestType

Field Summary

Fields

Modifier and Type	Field and Description
static String	CHARSET
static com.google.gson.Gson	GSON

Fields inherited from class com.stripe.model.StripeObject

PRETTY_PRINT_GSON

Constructor Summary

Constructors

Constructor and Description
APIResource()

Method Summary

Modifier and Type	Method and Description
protected static String	classURL(Class<?> clazz)
protected static String	classURL(Class<?> clazz, String apiBase)
protected static String	instanceURL(Class<?> clazz, String id)
protected static String	instanceURL(Class<?> clazz, String id, String apiBase)
static <T> T	multipartRequest(APIResource.RequestMethod method, String url, Map<String,Object> params, Class<T> clazz, RequestOptions options)
static <T> T	request(APIResource.RequestMethod method, String url, Map<String,Object> params, Class<T> clazz, RequestOptions options)
static <T extends StripeCollectionInterface> T	requestCollection(String url, Map<String,Object> params, Class<T> clazz, RequestOptions options) Similar to #request, but specific for use with collection types that come from the API (i.e.
static void	setStripeResponseGetter(StripeResponseGetter srg)
protected static String	singleClassURL(Class<?> clazz)
protected static String	singleClassURL(Class<?> clazz, String apiBase)
static String	urlEncode(String str)

Methods inherited from class com.stripe.model.StripeObject

equals, toString

Methods inherited from class java.lang.Object

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

Field Detail

GSON

public static final com.google.gson.Gson GSON

CHARSET

public static final String CHARSET

See Also:

Constant Field Values

Constructor Detail

APIResource

public APIResource()

Method Detail

setStripeResponseGetter

public static void setStripeResponseGetter(StripeResponseGetter srg)

singleClassURL

protected static String singleClassURL(Class<?> clazz)

singleClassURL

protected static String singleClassURL(Class<?> clazz,
                                       String apiBase)

classURL

protected static String classURL(Class<?> clazz)

classURL

protected static String classURL(Class<?> clazz,
                                 String apiBase)

instanceURL

protected static String instanceURL(Class<?> clazz,
                                    String id)
                             throws InvalidRequestException

Throws:

InvalidRequestException

instanceURL

protected static String instanceURL(Class<?> clazz,
                                    String id,
                                    String apiBase)
                             throws InvalidRequestException

Throws:

InvalidRequestException

urlEncode

public static String urlEncode(String str)
                        throws UnsupportedEncodingException

Throws:

UnsupportedEncodingException

multipartRequest

public static <T> T multipartRequest(APIResource.RequestMethod method,
                                     String url,
                                     Map<String,Object> params,
                                     Class<T> clazz,
                                     RequestOptions options)
                              throws AuthenticationException,
                                     InvalidRequestException,
                                     APIConnectionException,
                                     CardException,
                                     APIException

Throws:

AuthenticationException

InvalidRequestException

APIConnectionException

CardException

APIException

request

public static <T> T request(APIResource.RequestMethod method,
                            String url,
                            Map<String,Object> params,
                            Class<T> clazz,
                            RequestOptions options)
                     throws AuthenticationException,
                            InvalidRequestException,
                            APIConnectionException,
                            CardException,
                            APIException

Throws:

AuthenticationException

InvalidRequestException

APIConnectionException

CardException

APIException

requestCollection

public static <T extends StripeCollectionInterface> T requestCollection(String url,
                                                                        Map<String,Object> params,
                                                                        Class<T> clazz,
                                                                        RequestOptions options)
                                                                 throws AuthenticationException,
                                                                        InvalidRequestException,
                                                                        APIConnectionException,
                                                                        CardException,
                                                                        APIException

Similar to #request, but specific for use with collection types that come from the API (i.e. lists of resources). Collections need a little extra work because we need to plumb request options and params through so that we can iterate to the next page if necessary.

Throws:

AuthenticationException

InvalidRequestException

APIConnectionException

CardException

APIException