com.stripe.net

Class APIResource

java.lang.Object

com.stripe.model.StripeObject

com.stripe.net.APIResource

Direct Known Subclasses:

Account, ApplePayDomain, ApplicationFee, Balance, BalanceTransaction, BitcoinTransaction, Charge, ChargeOutcome, CountrySpec, Coupon, Customer, Dispute, EphemeralKey, Event, ExchangeRate, ExternalAccount, Fee, FeeRefund, FileUpload, Invoice, InvoiceItem, IssuerFraudRecord, LoginLink, Order, OrderItem, OrderReturn, PagingIterator, PaymentIntent, Payout, Plan, PlanTier, Product, Recipient, Refund, Reversal, SKU, SourceMandateNotification, SourceTransaction, StatusTransitions, Subscription, SubscriptionItem, ThreeDSecure, Token, Topup, Transfer, UsageRecord

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 java.lang.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 java.lang.String	classURL(java.lang.Class<?> clazz)
protected static java.lang.String	classURL(java.lang.Class<?> clazz, java.lang.String apiBase)
protected static java.lang.String	instanceURL(java.lang.Class<?> clazz, java.lang.String id)
protected static java.lang.String	instanceURL(java.lang.Class<?> clazz, java.lang.String id, java.lang.String apiBase)
static <T> T	multipartRequest(APIResource.RequestMethod method, java.lang.String url, java.util.Map<java.lang.String,java.lang.Object> params, java.lang.Class<T> clazz, RequestOptions options)
static <T> T	request(APIResource.RequestMethod method, java.lang.String url, java.util.Map<java.lang.String,java.lang.Object> params, java.lang.Class<T> clazz, RequestOptions options)
static <T extends StripeCollectionInterface<?>> T	requestCollection(java.lang.String url, java.util.Map<java.lang.String,java.lang.Object> params, java.lang.Class<T> clazz, RequestOptions options) Similar to #request, but specific for use with collection types that come from the API (i.e.
static <T extends HasId> ExpandableField<T>	setExpandableFieldID(java.lang.String newId, ExpandableField<T> currentObject) When setting a String ID for an ExpandableField, we need to be careful about keeping the String ID and the expanded object in sync.
static void	setStripeResponseGetter(StripeResponseGetter srg)
protected static java.lang.String	singleClassURL(java.lang.Class<?> clazz)
protected static java.lang.String	singleClassURL(java.lang.Class<?> clazz, java.lang.String apiBase)
protected static java.lang.String	subresourceURL(java.lang.Class<?> clazz, java.lang.String id, java.lang.Class<?> subClazz)
static java.lang.String	urlEncode(java.lang.String str) URL-encodes a string.

Methods inherited from class com.stripe.model.StripeObject

equals, getLastResponse, setLastResponse, toJson, 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 java.lang.String CHARSET

See Also:

Constant Field Values

Constructor Detail

APIResource

public APIResource()

Method Detail

setStripeResponseGetter

public static void setStripeResponseGetter(StripeResponseGetter srg)

singleClassURL

protected static java.lang.String singleClassURL(java.lang.Class<?> clazz)

singleClassURL

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

classURL

protected static java.lang.String classURL(java.lang.Class<?> clazz)

classURL

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

instanceURL

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

Throws:

InvalidRequestException

instanceURL

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

Throws:

InvalidRequestException

subresourceURL

protected static java.lang.String subresourceURL(java.lang.Class<?> clazz,
                                                 java.lang.String id,
                                                 java.lang.Class<?> subClazz)
                                          throws InvalidRequestException

Throws:

InvalidRequestException

urlEncode

public static java.lang.String urlEncode(java.lang.String str)
                                  throws java.io.UnsupportedEncodingException

URL-encodes a string.

Throws:

java.io.UnsupportedEncodingException

multipartRequest

public static <T> T multipartRequest(APIResource.RequestMethod method,
                                     java.lang.String url,
                                     java.util.Map<java.lang.String,java.lang.Object> params,
                                     java.lang.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,
                            java.lang.String url,
                            java.util.Map<java.lang.String,java.lang.Object> params,
                            java.lang.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(java.lang.String url,
                                                                           java.util.Map<java.lang.String,java.lang.Object> params,
                                                                           java.lang.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

setExpandableFieldID

public static <T extends HasId> ExpandableField<T> setExpandableFieldID(java.lang.String newId,
                                                                        ExpandableField<T> currentObject)

When setting a String ID for an ExpandableField, we need to be careful about keeping the String ID and the expanded object in sync. If they specify a new String ID that is different from the ID within the expanded object, we don't keep the object.