com.softwareag.mobile.runtime.toolkit.operations

Class AbstractSynchronizableOperation

java.lang.Object

com.softwareag.mobile.runtime.toolkit.operations.AbstractSynchronizableOperation

All Implemented Interfaces:

IOperation

Direct Known Subclasses:

AbstractRestOperation, AbstractThreadedOperation, FileLoadOperation

public abstract class AbstractSynchronizableOperation
extends java.lang.Object
implements IOperation

The AbstractSynchronizableOperation implements all necessary members from it's super class IOperation and provides the possibility to notify all registered listeners in a thread-safe manner.

All delegates will be called from the thread, which creates this operation. So the execution itself can run asynchronously. To reach this goal, the operation holds an internally created nUIObject and fires events by using nUIController.eventListenerQueue(nUIObject, int).

Subclasses must call fireEvent(int) to synchronized notify all delegates. Possible arguments are OperationNotifier.FINISHED and OperationNotifier.FAILED correspondent to the methods described by IOperationDelegate.

Subclasses must override internalExecute().

Version:

9.10.0.0000-0158

Constructor Summary

Constructors

Constructor and Description
AbstractSynchronizableOperation()

Method Summary

Modifier and Type	Method and Description
void	addOperationDelegate(IOperationDelegate delegate) Adds the delivered IOperationDelegate.
void	execute() Executes this operation.
byte[]	getRawResult() Returns the result as an byte-array.
java.lang.String	getResult() Returns the result as a String.
java.lang.String	getResult(java.lang.String encoding) Returns the result as a String with s specific encoding.
int	getResultCode() Returns the resultCode as an int-value.
void	removeOperationDelegate(IOperationDelegate delegate) Removes the delivered IOperationDelegate.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractSynchronizableOperation

public AbstractSynchronizableOperation()

Method Detail

getResultCode

public final int getResultCode()

Description copied from interface: IOperation

Returns the resultCode as an int-value.

Specified by:

getResultCode in interface IOperation

Returns:

execute

public void execute()

Description copied from interface: IOperation

Executes this operation.

Specified by:

execute in interface IOperation

getResult

public final java.lang.String getResult()

Description copied from interface: IOperation

Returns the result as a String.
Transforms get byte-result from IOperation.getRawResult() into a String by using UTF-8 as encoding. Call IOperation.getResult(String) under the hood.

Specified by:

getResult in interface IOperation

Returns:

See Also:

IOperation.getResult(String)

getResult

public java.lang.String getResult(java.lang.String encoding)
                           throws java.io.UnsupportedEncodingException

Description copied from interface: IOperation

Returns the result as a String with s specific encoding.

Specified by:

getResult in interface IOperation

Returns:

Throws:

java.io.UnsupportedEncodingException

getRawResult

public byte[] getRawResult()

Description copied from interface: IOperation

Returns the result as an byte-array.

Specified by:

getRawResult in interface IOperation

Returns:

addOperationDelegate

public void addOperationDelegate(IOperationDelegate delegate)

Description copied from interface: IOperation

Adds the delivered IOperationDelegate.

Specified by:

addOperationDelegate in interface IOperation

removeOperationDelegate

public void removeOperationDelegate(IOperationDelegate delegate)

Description copied from interface: IOperation

Removes the delivered IOperationDelegate.

Specified by:

removeOperationDelegate in interface IOperation