com.softwareag.mobile.runtime.toolkit.delegates

Class DatasourceAwareDelegateTransformer

java.lang.Object

com.softwareag.mobile.runtime.toolkit.delegates.AbstractOperationDelegate

com.softwareag.mobile.runtime.toolkit.delegates.DatasourceAwareDelegateTransformer

All Implemented Interfaces:

IOperationDelegate

public class DatasourceAwareDelegateTransformer
extends AbstractOperationDelegate

The DatasourceAwareDelegateTransformer is an IOperationDelegate implementation for AbstractRestOperations which also takes a IDataTransformer into account.

It's added as IOperationDelegate to a AbstractRestOperation and gets notified when the REST call is finished (see AbstractOperationDelegate.onOperationFinished(IOperation) and AbstractOperationDelegate.onOperationFailed(IOperation). It will fetch all filtered elements (based on the given filterExpression) from the executed REST service and attach those elements to the AbstractListDatasource passed in the constructor.

The optional IDataTransformer will be used to convert each object returned from the executed AbstractRestOperation into an object of the correct type for the targetDatesource.

Version:

9.12.0.0000-0266

Constructor Summary

Constructors

Constructor and Description
DatasourceAwareDelegateTransformer(AbstractListDatasource targetDatasource, IDataTransformer transformer, java.lang.String expression) Creates this IOperationDelegate by passing the target datasource as well a IDataTransformer.
DatasourceAwareDelegateTransformer(AbstractListDatasource targetDatasource, IDataTransformer transformer, java.lang.String expression, java.lang.String filterExpression) Creates this IOperationDelegate by passing the target datasource as well a IDataTransformer.

Method Summary

Modifier and Type	Method and Description
void	notifyObservers(DatasourceException exception) Is called when the operation failed.
void	onOperationSuccessful(IOperation operation) reads the result from the operation (takes "expression" and "filterExpression" into account) and calls the attachElements(AbstractListDatasource) method

Methods inherited from class com.softwareag.mobile.runtime.toolkit.delegates.AbstractOperationDelegate

onOperationFailed, onOperationFinished

Methods inherited from class java.lang.Object

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

Constructor Detail

DatasourceAwareDelegateTransformer

public DatasourceAwareDelegateTransformer(AbstractListDatasource targetDatasource,
                                          IDataTransformer transformer,
                                          java.lang.String expression)

Creates this IOperationDelegate by passing the target datasource as well a IDataTransformer.

Parameters:

targetDatasource - the datasource to which the elements should be added to

transformer - might be null; used to transform the objects from the format of the AbstractRestOperation into the required format of the targetDatasource

expression - the JSON expression required to get the desired objects from the returned REST result string

filterExpression - the JSON expression used to filter the matched elements

DatasourceAwareDelegateTransformer

public DatasourceAwareDelegateTransformer(AbstractListDatasource targetDatasource,
                                          IDataTransformer transformer,
                                          java.lang.String expression,
                                          java.lang.String filterExpression)

Creates this IOperationDelegate by passing the target datasource as well a IDataTransformer.

Parameters:

targetDatasource - the datasource to which the elements should be added to

transformer - might be null; used to transform the objects from the format of the AbstractRestOperation into the required format of the targetDatasource

expression - the JSON expression required to get the desired objects from the returned REST result string

filterExpression - the JSON expression used to filter the matched elements

Method Detail

onOperationSuccessful

public void onOperationSuccessful(IOperation operation)

reads the result from the operation (takes "expression" and "filterExpression" into account) and calls the attachElements(AbstractListDatasource) method

Specified by:

onOperationSuccessful in class AbstractOperationDelegate

Parameters:

operation - the successful IOperation (incl. the result string)

notifyObservers

public void notifyObservers(DatasourceException exception)

Description copied from class: AbstractOperationDelegate

Is called when the operation failed. Used to notify the observers that an exception occurred.

Overrides:

notifyObservers in class AbstractOperationDelegate

Parameters:

exception - the DatasourceException that had beed created for the occurred error