com.softwareag.mobile.runtime.toolkit.operations.queue.conditional

Class ConditionalOperationQueue

java.lang.Object

com.softwareag.mobile.runtime.toolkit.operations.queue.BasicOperationQueue

com.softwareag.mobile.runtime.toolkit.operations.queue.conditional.ConditionalOperationQueue

All Implemented Interfaces:

IOperationDelegate, IOperationQueue

public class ConditionalOperationQueue
extends BasicOperationQueue
implements IOperationDelegate

A specific implementation of the IOperationQueue which offers the ability to execute several IOperations. Using addConditionalOperation(ConditionalOperation), you can add a kind of operation tree. Based on the Response#getStatusCode() of an IOperation, the following operation is evaluated and executed. Using BasicOperationQueue.addOperation(IOperation), you can add an IOperation without a Condition, i.e. it is executed right away.
Beware: after creating the queue, it is in suspended mode. This allows to add as many ConditionalOperations as you like before you start the execution using BasicOperationQueue.resume().

 IOperation loginOperation = ...
 IOperation loadPrivileges = ...
 IOperation reportServerMisconfiguration = ...

 ConditionalOperation loginCondition = new ConditionalOperation(loginOperation);
 loginCondition.addOperation(Condition.SUCCESSFUL, loadPrivileges);
 loginCondition.addOperation(new BasicCondition(404), reportServerMisconfiguration);

 ConditionalOperationQueue queue = new ConditionalOperationQueue();
 queue.addOperation(loginOperation);
 queue.addConditionalOperation(loginCondition);
 queue.resume();
 

Version:

10.3.0.0002-0443

Constructor Summary

Constructors

Constructor and Description
ConditionalOperationQueue()

Method Summary

Modifier and Type	Method and Description
void	addConditionalOperation(ConditionalOperation conditionalOperation)
int	getSize()
void	onOperationFailed(IOperation operation) Notifies this listener that the watched IOperation failed.
void	onOperationFinished(IOperation operation) Notifies this listener that the watched IOperation finished.
void	reset() reset the queue as if it were new, i.e.

Methods inherited from class com.softwareag.mobile.runtime.toolkit.operations.queue.BasicOperationQueue

addDelegate, addDelegate, addOperation, addOperations, isIdle, removeDelegate, removeDelegate, resume, suspend

Methods inherited from class java.lang.Object

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

Constructor Detail

ConditionalOperationQueue

public ConditionalOperationQueue()

Method Detail

reset

public void reset()

Description copied from interface: IOperationQueue

reset the queue as if it were new, i.e. remove all operations

Specified by:

reset in interface IOperationQueue

Overrides:

reset in class BasicOperationQueue

getSize

public int getSize()

Specified by:

getSize in interface IOperationQueue

Overrides:

getSize in class BasicOperationQueue

Returns:

the number of operations currently in the queue

addConditionalOperation

public void addConditionalOperation(ConditionalOperation conditionalOperation)

onOperationFinished

public void onOperationFinished(IOperation operation)

Description copied from interface: IOperationDelegate

Notifies this listener that the watched IOperation finished.
Use the IOperation#getResultCode() to validate the success of the operation. E.g. for a remote operation:

 switch (operation.getResponse().getStatusCode()) {
 case HttpConnection.HTTP_OK:
        break;
 case HttpConnection.HTTP_FORBIDDEN:
        break;
 }
 

Specified by:

onOperationFinished in interface IOperationDelegate

Parameters:

operation - The watched IOperation.

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

Parameters:

operation - The watched IOperation.