com.softwareag.mobile.runtime.toolkit.operations.cache

Interface IOperationCacheHandler

All Superinterfaces:

IOperationDelegate

All Known Implementing Classes:

AbstractCacheHandler, AbstractOfflineAwareCacheHandler, AbstractRestCacheHandler, CacheFirstCacheHandler, CacheOnlyCacheHandler, NoCacheHandler, ServerFirstCacheHandler, ServerOnlyCacheHandler

public interface IOperationCacheHandler
extends IOperationDelegate

This is a common interface that defines some hook points to influence the execution of an AbstractSynchronizableOperation. Furthermore it is an IOperationDelegate and its IOperationDelegate.onOperationFailed(IOperation) and IOperationDelegate.onOperationFinished(IOperation) methods are called as the first delegates in AbstractSynchronizableOperation.notifyOperationFailed() and AbstractSynchronizableOperation.notifyOperationFinished().

There are several way to set it:

• OperationHandler.getCacheHandler(IOperation)
• AbstractSynchronizableOperation.setCacheHandler(IOperationCacheHandler)

A typical use case is the caching of the operations results (for performance issues or offline functionality).

Version:

10.3.0.0002-0443

Method Summary

Modifier and Type	Method and Description
void	afterOperationExecution(IOperation operation) Is invoked after the operation itself is started with IOperation#internalExecute().
void	beforeOperationExecution(IOperation operation) Is invoked before the operation itself is started with IOperation#internalExecute().
void	setCacheManager(ICacheManager cacheManager) Set the ICacheManager that should be used for the IOperation.
boolean	skipOperationExecution(IOperation operation)

Methods inherited from interface com.softwareag.mobile.runtime.toolkit.delegates.IOperationDelegate

onOperationFailed, onOperationFinished

Method Detail

beforeOperationExecution

void beforeOperationExecution(IOperation operation)

Is invoked before the operation itself is started with IOperation#internalExecute(). Can be used to read some data from the cache and set it into the operation.

afterOperationExecution

void afterOperationExecution(IOperation operation)

Is invoked after the operation itself is started with IOperation#internalExecute(). Can be used to read data from the operation and write it into the cache.

skipOperationExecution

boolean skipOperationExecution(IOperation operation)

Returns:

true if the execution of the IOperation should be skipped, e.g. if the result is offline and the operation will fail anyway (with a costly timeout).

setCacheManager

void setCacheManager(ICacheManager cacheManager)

Set the ICacheManager that should be used for the IOperation.