Package net.officefloor.frame.api.managedobject.source

Interface ManagedObjectExecuteContext<F extends java.lang.Enum<F>>

public interface ManagedObjectExecuteContext<F extends java.lang.Enum<F>>

Context that the ManagedObject is to execute within.

In invoking processes the following should be taken into account:

1. The Flow (process) will be instigated in a new ProcessState which for example will cause new ManagedObject dependencies to be instantiated.
2. The ManagedObject passed to the invocation will go through a full life-cycle so be careful passing in an existing initialised ManagedObject. For example the AsynchronousContext instance will be overwritten which will likely cause live-lock as the AsynchronousContext.complete(net.officefloor.frame.api.managedobject.AsynchronousOperation) will notify on the wrong ManagedObjectContainer.

Author:

Daniel Sagenschneider

Method Summary

Modifier and Type	Method	Description
void	addService(ManagedObjectService<F> service)	Adds a ManagedObjectService.
java.util.concurrent.ThreadFactory[]	getExecutionStrategy(int executionStrategyIndex)	Obtains an ExecutionStrategy.
java.util.logging.Logger	getLogger()	Obtains the Logger.
ManagedObjectStartupProcess	invokeStartupProcess(int flowIndex, java.lang.Object parameter, ManagedObject managedObject, FlowCallback callback)	Invokes a start up Flow.
ManagedObjectStartupProcess	invokeStartupProcess(F key, java.lang.Object parameter, ManagedObject managedObject, FlowCallback callback)	Invokes a start up Flow.

Method Detail

getLogger

java.util.logging.Logger getLogger()

Obtains the Logger.

Returns:

Logger.

getExecutionStrategy

java.util.concurrent.ThreadFactory[] getExecutionStrategy(int executionStrategyIndex)

Obtains an ExecutionStrategy.

Parameters:

executionStrategyIndex - Index of the ExecutionStrategy.

Returns:

ThreadFactory instances for the ExecutionStrategy.

invokeStartupProcess

ManagedObjectStartupProcess invokeStartupProcess(F key,
                                                 java.lang.Object parameter,
                                                 ManagedObject managedObject,
                                                 FlowCallback callback)
                                          throws java.lang.IllegalArgumentException

Invokes a start up Flow.

Parameters:

key - Key identifying the Flow to instigate.

parameter - Parameter to first ManagedFunction of the Flow.

managedObject - ManagedObject for the ProcessState of the Flow.

callback - FlowCallback on completion of the Flow.

Returns:

ManagedObjectStartupProcess.

Throws:

java.lang.IllegalArgumentException - If

• unknown Flow key
• parameter is incorrect type
• no ManagedObject is supplied

invokeStartupProcess

ManagedObjectStartupProcess invokeStartupProcess(int flowIndex,
                                                 java.lang.Object parameter,
                                                 ManagedObject managedObject,
                                                 FlowCallback callback)
                                          throws java.lang.IllegalArgumentException

Invokes a start up Flow.

Parameters:

flowIndex - Index identifying the Flow to instigate.

parameter - Parameter to first ManagedFunction of the Flow.

managedObject - ManagedObject for the ProcessState of the Flow.

callback - FlowCallback on completion of the Flow.

Returns:

ManagedObjectStartupProcess.

Throws:

java.lang.IllegalArgumentException - If

• unknown Flow key
• parameter is incorrect type
• no ManagedObject is supplied

addService

void addService(ManagedObjectService<F> service)

Adds a ManagedObjectService.

Parameters:

service - ManagedObjectService.