com.google.api.ads.adwords.axis.utility.extension.delegates

Class AbstractGetMutateDelegate<T,OperationT extends com.google.api.ads.adwords.axis.v201309.cm.Operation,S>

java.lang.Object

com.google.api.ads.adwords.axis.utility.extension.delegates.AbstractBaseDelegate<S>

com.google.api.ads.adwords.axis.utility.extension.delegates.AbstractGetDelegate<T,S>

com.google.api.ads.adwords.axis.utility.extension.delegates.AbstractGetMutateDelegate<T,OperationT,S>

Type Parameters:

T - type of object that the Service works with, for example Campaign, AdGroup, etc.

OperationT - type of the com.google.api.adwords.v201309.cm.Operation specific for the object T for example: CampaignOperation, AdGroupOperation, etc.

S - the service interface class. This is a class representing a SOAP service.

Implementation is not thread-safe, because AdWordsSession and Apache Axis service objects are not thread-safe.

Direct Known Subclasses:

AdGroupAdDelegate, AdGroupBidModifierDelegate, AdGroupCriterionDelegate, AdGroupDelegate, AdGroupFeedDelegate, AdParamDelegate, BudgetDelegate, BudgetOrderDelegate, CampaignAdExtensionDelegate, CampaignCriterionDelegate, CampaignDelegate, CampaignFeedDelegate, ConversionTrackerDelegate, ExperimentDelegate, FeedDelegate, FeedItemDelegate, FeedMappingDelegate, ManagedCustomerDelegate, UserListDelegate

public abstract class AbstractGetMutateDelegate<T,OperationT extends com.google.api.ads.adwords.axis.v201309.cm.Operation,S>
extends AbstractGetDelegate<T,S>

Abstract class that encapsulates mutates and operations.

Author:

Julian Toledo

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractGetMutateDelegate(AdWordsSession adWordsSession, Class<T> classT, Class<OperationT> classOperationT, Class<S> classS) Constructor without fields, used in services that do not support Generic Selectors.
protected	AbstractGetMutateDelegate(AdWordsSession adWordsSession, Class<T> classT, Class<OperationT> classOperationT, S service) Constructor without fields, used in services that do not support Generic Selectors and with custom service.
protected	AbstractGetMutateDelegate(AdWordsSession adWordsSession, List<? extends SelectorFields.FieldType<T>> selectorFields, Class<T> classT, Class<OperationT> classOperationT, Class<S> classS) Constructor with fields, used in services that support Generic Selectors.
protected	AbstractGetMutateDelegate(AdWordsSession adWordsSession, List<? extends SelectorFields.FieldType<T>> selectorFields, Class<T> classT, Class<OperationT> classOperationT, S service) Constructor with fields, used in services that support Generic Selectors.

Method Summary

Methods

Modifier and Type	Method and Description
List<T>	insert(List<T> list) Encapsulates one ADD mutate operation per item on the list.
T	insert(T object) Encapsulates one ADD mutate operation for the object.
protected Object	mutate(List<OperationT> operations) Method to execute by reflection getService().mutate(operations).
List<T>	remove(List<T> list) Encapsulates one REMOVE mutate operation per item on the list.
T	remove(T object) Encapsulates one REMOVE mutate operation for the object.
List<T>	update(List<T> list) Encapsulates one SET mutate operation per item on the list.
T	update(T object) Encapsulates one SET mutate operation for the object.

Methods inherited from class com.google.api.ads.adwords.axis.utility.extension.delegates.AbstractGetDelegate

createSelectorBuilder, get, get, get, getByField, getByField, getByField, getByField, getClassT, getOneByField, getPage, setGetMethodName

Methods inherited from class com.google.api.ads.adwords.axis.utility.extension.delegates.AbstractBaseDelegate

getAdWordsSession, getService

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractGetMutateDelegate

protected AbstractGetMutateDelegate(AdWordsSession adWordsSession,
                         Class<T> classT,
                         Class<OperationT> classOperationT,
                         Class<S> classS)

Constructor without fields, used in services that do not support Generic Selectors.

Parameters:

adWordsSession - the adWordsSession to use with the service

classT - type of object that the Service works with, for example Campaign, AdGroup, etc.

classOperationT - sub-class of the com.google.api.adwords.v201309.cm.Operation specific for classT

classS - the service interface class for the SOAP service

AbstractGetMutateDelegate

protected AbstractGetMutateDelegate(AdWordsSession adWordsSession,
                         Class<T> classT,
                         Class<OperationT> classOperationT,
                         S service)

Constructor without fields, used in services that do not support Generic Selectors and with custom service.

Parameters:

adWordsSession - the adWordsSession to use with the service

classT - type of object that the Service works with, for example Campaign, AdGroup, etc.

classOperationT - sub-class of the com.google.api.adwords.v201309.cm.Operation specific for classT

service - the custom service class for the SOAP service

AbstractGetMutateDelegate

protected AbstractGetMutateDelegate(AdWordsSession adWordsSession,
                         List<? extends SelectorFields.FieldType<T>> selectorFields,
                         Class<T> classT,
                         Class<OperationT> classOperationT,
                         Class<S> classS)

Constructor with fields, used in services that support Generic Selectors.

Parameters:

adWordsSession - the adWordsSession to use with the service

selectorFields - for the Generic Selectors using the SelectorField class

classT - type of object that the Service works with, for example Campaign, AdGroup, etc.

classOperationT - sub-class of the com.google.api.adwords.v201309.cm.Operation specific for classT

classS - the service interface class for the SOAP service

AbstractGetMutateDelegate

protected AbstractGetMutateDelegate(AdWordsSession adWordsSession,
                         List<? extends SelectorFields.FieldType<T>> selectorFields,
                         Class<T> classT,
                         Class<OperationT> classOperationT,
                         S service)

Constructor with fields, used in services that support Generic Selectors.

Parameters:

adWordsSession - the adWordsSession to use with the service

selectorFields - for the Generic Selectors using the SelectorField class

classT - type of object that the Service works with, for example Campaign, AdGroup, etc.

classOperationT - sub-class of the com.google.api.adwords.v201309.cm.Operation specific for classT

service - the custom service class for the SOAP service

Method Detail

mutate

protected Object mutate(List<OperationT> operations)
                 throws RemoteException

Method to execute by reflection getService().mutate(operations).

Parameters:

operations - a List of operations for the mutate call

Returns:

a generic Object for ListReturnValue or T[] the return object depends on the interface S

Throws:

UtilityLibraryException - if there is an error in the reflection call

RemoteException - for communication-related exceptions

insert

public List<T> insert(List<T> list)
               throws RemoteException

Encapsulates one ADD mutate operation per item on the list.

Parameters:

list - a list of T object to insert

Returns:

a list of T objects

Throws:

UtilityLibraryException - if there is an error in the reflection call

RemoteException - for communication-related exceptions

insert

public T insert(T object)
         throws RemoteException

Encapsulates one ADD mutate operation for the object.

Parameters:

object - the T object to insert

Returns:

one T object

Throws:

UtilityLibraryException - if there is an error in the reflection call

RemoteException - for communication-related exceptions

update

public List<T> update(List<T> list)
               throws RemoteException

Encapsulates one SET mutate operation per item on the list.

Parameters:

list - a list of T object to update

Returns:

a list of T objects

Throws:

UtilityLibraryException - if there is an error in the reflection call

RemoteException - for communication-related exceptions

update

public T update(T object)
         throws RemoteException

Encapsulates one SET mutate operation for the object.

Parameters:

object - the T object to update

Returns:

one T object

Throws:

UtilityLibraryException - if there is an error in the reflection call

RemoteException - for communication-related exceptions

remove

public List<T> remove(List<T> list)
               throws RemoteException

Encapsulates one REMOVE mutate operation per item on the list.

Parameters:

list - a list of T object to remove

Returns:

a list of objects

Throws:

UtilityLibraryException - if there is an error in the reflection call

RemoteException - for communication-related exceptions

remove

public T remove(T object)
         throws RemoteException

Encapsulates one REMOVE mutate operation for the object.

Parameters:

object - the T object to remove

Returns:

one T object

Throws:

UtilityLibraryException - if there is an error in the reflection call

RemoteException - for communication-related exceptions