com.saperion.operations

Interface Operation<T extends Serializable>

Type Parameters:

T - - The return type of the invocation of the command.

All Superinterfaces:

Serializable

All Known Implementing Classes:

AbstractOperation, ApplyBatch, BaseOperation, CloneDocument, CreateDocument, CreateFolder, CreateLookupEntry, DeleteAllMediaOperation, DeleteDocument, DeleteLookupEntry, DeleteNamedMediaOperation, ExecuteStoredProcedure, FireCustomEvent, GetAllBoxCounts, GetBoxCount, GetBoxCountCompleted, GetBoxCountCreated, GetBoxCountDue, GetBoxCountReminders, GetCurrentUserInfo, GetDocumentInfo, GetIxosDDCNames, GetProcessDefinitions, InTransaction, ListStorageOperation, ReadSelectableUsersForTransition, SetCurrentUserPresent, SetCurrentUserSubstituteAccess, SetDocumentRead, SetDocumentUnread, SetUserExtensionCacheEnabled, UpdateCurrentUserInformation, UpdateDocument, UpdateFolder, UpdateLookupEntry, VoidOperation

public interface Operation<T extends Serializable>
extends Serializable

Interface for operations that will be sent by RMI. Since the code has to be executed on the Server every implementation has to be serializable.

Method Summary

Methods

Modifier and Type	Method and Description
void	beforeInvoke(int token) This method will be called on the client-side to prepare an operation for invocation on the server-side.
T	getResult() This method will only yield a valid result after a call to invoke.
T	invoke() The method that will be called on the server side.
void	setResult(Object result) setResult will be called on the client side to assign the result.

Method Detail

invoke

T invoke()
                              throws Exception

The method that will be called on the server side.

Returns:

the result of the operation

Throws:

Exception - exception when invoking this operation

setResult

void setResult(Object result)

setResult will be called on the client side to assign the result.

Parameters:

result - The result of invoke obtained by the rmi-call

getResult

T getResult()

This method will only yield a valid result after a call to invoke.

Returns:

The result of the command or null if the instance was not given to an invoke-call yet.

beforeInvoke

void beforeInvoke(int token)

This method will be called on the client-side to prepare an operation for invocation on the server-side. Implementations can use this method to perform any preparation tasks that require the current session-token. A default-implementation that just stores the token is provided by BaseOperation. The token can be retrieved by BaseOperation.getClientToken().

Parameters:

token - session token