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 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:

10.1.0.0000-0462

Constructor Summary

Constructors

Constructor and Description
DatasourceAwareDelegateTransformer(AbstractListDatasource targetDatasource, IDataTransformer transformer, java.lang.String filterExpression) 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	onOperationFailed(IOperation operation) Notifies this listener that the watched IOperation 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

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 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

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)

onOperationFailed

public void onOperationFailed(IOperation operation)

Description copied from interface: IOperationDelegate

Notifies this listener that the watched IOperation failed. This only indicates an exception during the execution and is independent from the operation's result code.

Specified by:

onOperationFailed in interface IOperationDelegate

Overrides:

onOperationFailed in class AbstractOperationDelegate

Parameters:

operation - The watched IOperation.

notifyObservers

public void notifyObservers(DatasourceException exception)

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

Parameters:

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