com.ebay.sdk
Class ApiCall

java.lang.Object
  com.ebay.sdk.ApiCall

Direct Known Subclasses:

AddDisputeCall, AddDisputeResponseCall, AddItemCall, AddLiveAuctionItemCall, AddMemberMessageAAQToPartnerCall, AddMemberMessageRTQCall, AddMemberMessagesAAQToBidderCall, AddOrderCall, AddSecondChanceItemCall, AddToItemDescriptionCall, AddToWatchListCall, AddTransactionConfirmationItemCall, ApproveLiveAuctionBiddersCall, CompleteSaleCall, DeleteMyMessagesCall, EndItemCall, FetchTokenCall, GetAccountCall, GetAdFormatLeadsCall, GetAllBiddersCall, GetApiAccessRulesCall, GetAttributesCSCall, GetAttributesXSLCall, GetBestOffersCall, GetBidderListCall, GetCartCall, GetCategoriesCall, GetCategory2CSCall, GetCategoryFeaturesCall, GetCategoryListingsCall, GetCategoryMappingsCall, GetCategorySpecificsCall, GetChallengeTokenCall, GetCharitiesCall, GetClientAlertsAuthTokenCall, GetContextualKeywordsCall, GetCrossPromotionsCall, GetDescriptionTemplatesCall, GetDisputeCall, GeteBayDetailsCall, GeteBayOfficialTimeCall, GetExpressWishListCall, GetFeedbackCall, GetHighBiddersCall, GetItemCall, GetItemRecommendationsCall, GetItemsAwaitingFeedbackCall, GetItemShippingCall, GetItemTransactionsCall, GetLiveAuctionBiddersCall, GetLiveAuctionCatalogDetailsCall, GetMemberMessagesCall, GetMessagePreferencesCall, GetMyeBayBuyingCall, GetMyeBayRemindersCall, GetMyeBaySellingCall, GetMyMessagesCall, GetNotificationPreferencesCall, GetNotificationsUsageCall, GetOrdersCall, GetOrderTransactionsCall, GetPictureManagerDetailsCall, GetPictureManagerOptionsCall, GetPopularKeywordsCall, GetProductFamilyMembersCall, GetProductFinderCall, GetProductFinderXSLCall, GetProductsCall, GetProductSearchPageCall, GetProductSearchResultsCall, GetProductSellingPagesCall, GetPromotionalSaleDetailsCall, GetPromotionRulesCall, GetReturnURLCall, GetRuNameCall, GetSearchResultsCall, GetSearchResultsExpressCall, GetSellerDashboardCall, GetSellerEventsCall, GetSellerListCall, GetSellerPaymentsCall, GetSellerTransactionsCall, GetSessionIDCall, GetShippingDiscountProfilesCall, GetStoreCall, GetStoreCategoryUpdateStatusCall, GetStoreCustomPageCall, GetStoreOptionsCall, GetStorePreferencesCall, GetSuggestedCategoriesCall, GetTaxTableCall, GetTokenStatusCall, GetUserCall, GetUserContactDetailsCall, GetUserDisputesCall, GetUserPreferencesCall, GetVeROReasonCodeDetailsCall, GetVeROReportStatusCall, GetWantItNowPostCall, GetWantItNowSearchResultsCall, IssueRefundCall, LeaveFeedbackCall, PlaceOfferCall, RelistItemCall, RemoveFromWatchListCall, RespondToBestOfferCall, RespondToFeedbackCall, RespondToWantItNowPostCall, ReviseCheckoutStatusCall, ReviseItemCall, ReviseLiveAuctionItemCall, ReviseMyMessagesCall, ReviseMyMessagesFoldersCall, RevokeTokenCall, SellerReverseDisputeCall, SendInvoiceCall, SetCartCall, SetMessagePreferencesCall, SetNotificationPreferencesCall, SetPictureManagerDetailsCall, SetPromotionalSaleCall, SetPromotionalSaleListingsCall, SetReturnURLCall, SetShippingDiscountProfilesCall, SetStoreCall, SetStoreCategoriesCall, SetStoreCustomPageCall, SetStorePreferencesCall, SetTaxTableCall, SetUserNotesCall, SetUserPreferencesCall, ValidateChallengeInputCall, ValidateTestUserRegistrationCall, VerifyAddItemCall, VerifyAddSecondChanceItemCall, VeROReportItemsCall

public class ApiCall
extends Object

The base class of all API call classes (AddItemCall, GetItemCall, etc). Each ApiCall object requires an ApiContext object to control the common context under which the API call will be made.

View UML diagram of the class.

Title:

Description:

Copyright: Copyright (c) 2004

Company: eBay Inc.

Field Summary

protected ApiException	apiException Set the API exception object.
protected boolean	fullCredentials
protected EventListenerList	sendReqListeners

Constructor Summary

ApiCall()
Constructor.

ApiCall(ApiContext apiContext)
Constructor.

Method Summary

void	addDetailLevel(DetailLevelCodeType detail) Add a detail level value to for call object.
void	addSendRequestListener(SendApiRequestListener l) Add listner to filter the AbstractRequestType object right before it is sent to eBay server.
AbstractResponseType	execute(AbstractRequestType request) Executing the API call.
AbstractResponseType	executeByApiName(String apiName, AbstractRequestType request) Executing the API call by providing API name string (e.g., AddItem, GetItem).
ApiContext	getApiContext() Get the ApiContext object to be used.
ApiException	getApiException() After making the API call, returns the ApiExceptin object of the call.
CallRetry	getCallRetry() Get the CallRetry object that is being used.
DetailLevelCodeType[]	getDetailLevel() Get the DetailLevels to of the API call.
boolean	getEnableCompression() Determine if GZIP or DEFLATE compression is enabled for this ApiCall object.
String	getRequestXml() After making the API call, returns the SOAP request Xml text.
AbstractResponseType	getResponseObject() After calling Execute(), returns the AbstractResponseType object.
String	getResponseXml() After making the API call, returns the SOAP response Xml text.
SiteCodeType	getSite() Gets the eBay site that is the call is associated with.
boolean	hasError() After calling Exceute(), gets if there are errors returned from eBay API server.
boolean	hasWarning() After calling Exceute(), gets if there are warnning returned from eBay API server.
void	removeSendRequestListener(SendApiRequestListener l) Remove a listener.
void	setApiContext(ApiContext apiContext) Set the ApiContext object to be used.
void	setCallRetry(CallRetry callRetry) Set the CallRetry object to be used.
void	setDetailLevel(DetailLevelCodeType[] detailLevel) Set the DetaiLevels of the API call.
void	setEnableCompression(boolean enableCompression) Sets to true to enable GZIP or DEFLATE compression for this ApiCall object.
void	setSite(SiteCodeType site) Sets the eBay site that is the call is associated with.

Methods inherited from class java.lang.Object

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

Field Detail

sendReqListeners

protected EventListenerList sendReqListeners

fullCredentials

protected boolean fullCredentials

apiException

protected ApiException apiException

Set the API exception object.

Constructor Detail

ApiCall

public ApiCall()

Constructor. This method will always set the EnableCompression property to true.

ApiCall

public ApiCall(ApiContext apiContext)

Constructor.

Parameters:

apiContext - The ApiContext object for the ApiCall object.

Method Detail

getApiContext

public ApiContext getApiContext()

Get the ApiContext object to be used.

Returns:

The ApiContext object to be used.

setApiContext

public void setApiContext(ApiContext apiContext)

Set the ApiContext object to be used.

Parameters:

apiContext - The ApiContext objec to be set to.

addSendRequestListener

public void addSendRequestListener(SendApiRequestListener l)

Add listner to filter the AbstractRequestType object right before it is sent to eBay server.

Parameters:

l - SendApiRequestListener

removeSendRequestListener

public void removeSendRequestListener(SendApiRequestListener l)

Remove a listener.

Parameters:

l - SendApiRequestListener

getDetailLevel

public DetailLevelCodeType[] getDetailLevel()

Get the DetailLevels to of the API call. DetailLevel controls what fields should be returned by the API call.

Returns:

Array of DetailLevelCodeType.

setDetailLevel

public void setDetailLevel(DetailLevelCodeType[] detailLevel)

Set the DetaiLevels of the API call.

Parameters:

detailLevel - Array of DetailLevels to be set to.

addDetailLevel

public void addDetailLevel(DetailLevelCodeType detail)

Add a detail level value to for call object.

Parameters:

detail - DetailLevelCodeType

getCallRetry

public CallRetry getCallRetry()

Get the CallRetry object that is being used.

Returns:

the CallRetry object.

setCallRetry

public void setCallRetry(CallRetry callRetry)

Set the CallRetry object to be used. CallRetry controls the behaviour of failure-retry. If you set this property, the CallRetry proper of ApiContext will be ignored.

Parameters:

callRetry - The CallRetry object to use.

getApiException

public ApiException getApiException()

After making the API call, returns the ApiExceptin object of the call.

Returns:

the ApiException object if there's failure. Information contained in ApiException object is returned by eBay API server.

hasWarning

public boolean hasWarning()

After calling Exceute(), gets if there are warnning returned from eBay API server.

Returns:

true means warnnings are returned. Use getApiException().getErrors() to find all warnnings.

hasError

public boolean hasError()

After calling Exceute(), gets if there are errors returned from eBay API server.

Returns:

true means errors are returned. Use getApiException().getErrors() to find all errors.

getRequestXml

public String getRequestXml()

After making the API call, returns the SOAP request Xml text.

Returns:

the request SOAP Xml text.

getResponseXml

public String getResponseXml()

After making the API call, returns the SOAP response Xml text. This field is only set if the server returned response SOAP xml.

Returns:

the response SOAP xml text.

getSite

public SiteCodeType getSite()

Gets the eBay site that is the call is associated with.

Returns:

SiteCodeType

getEnableCompression

public boolean getEnableCompression()

Determine if GZIP or DEFLATE compression is enabled for this ApiCall object. This is a thread level property, i.e., all instances of ApiCall or derived classes will share the same copy of EnableCompression for each thread.

Returns:

boolean

setSite

public void setSite(SiteCodeType site)

Sets the eBay site that is the call is associated with. Setting this property will overrides the Site property in ApiCall.ApiContext.

Parameters:

site - SiteCodeType

setEnableCompression

public void setEnableCompression(boolean enableCompression)

Sets to true to enable GZIP or DEFLATE compression for this ApiCall object. This is a thread level property, i.e., all instances of ApiCall or derived classes will share the same copy of EnableCompression for each thread.

Parameters:

enableCompression - boolean

getResponseObject

public AbstractResponseType getResponseObject()

After calling Execute(), returns the AbstractResponseType object. All eBay SOAP API call returne types that are derived from AbstractResponseType. You can cast it back to the concrete response type (e.g., AddItemResponseType, GetItemResponseType).

Returns:

The returned AbstractResponseType object.

execute

public AbstractResponseType execute(AbstractRequestType request)
                             throws ApiException,
                                    SdkSoapException,
                                    SdkException

Executing the API call. This method assumes that the request type name contains the api name. E.g., AddItemRequestType contains "addItem".

Parameters:

request - The request object.

Returns:

The response type that you can cast back to its concrete type.

Throws:

ApiException

SdkSoapException

SdkException

executeByApiName

public AbstractResponseType executeByApiName(String apiName,
                                             AbstractRequestType request)
                                      throws ApiException,
                                             SdkSoapException,
                                             SdkException

Executing the API call by providing API name string (e.g., AddItem, GetItem).

Parameters:

apiName - The name of the API call. e.g., addItem, getItem, etc.

request - The AbstractRequestType object.

Returns:

The AbstractResponseType object.

Throws:

ApiException

SdkSoapException

SdkException