Package net.officefloor.frame.impl.execute.service

Class SafeManagedObjectService<F extends Enum<F>>

java.lang.Object

net.officefloor.frame.impl.execute.service.SafeManagedObjectService<F>

All Implemented Interfaces:

ManagedObjectServiceContext<F>

public class SafeManagedObjectService<F extends Enum<F>>
extends Object
implements ManagedObjectServiceContext<F>

Wraps the set up of the ManagedObjectService to block invocations until available.

Author:

Daniel Sagenschneider

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	SafeManagedObjectService.ProcessInvoker<F extends Enum<F>>	Invokes the ProcessState from the ManagedObjectServiceContext.
static interface	SafeManagedObjectService.SafeServicer<F extends Enum<F>,T extends Exception>	Safely invokes service on the ManagedObjectServiceContext.

Constructor Summary

Constructors

Constructor	Description
SafeManagedObjectService(ManagedObjectExecuteContext<F> executeContext)	Initiate ManagedObjectExecuteContext.
SafeManagedObjectService(ManagedObjectExecuteContext<F> executeContext, SafeManagedObjectService.SafeServicer<F,? extends Exception> startup)	Initiate ManagedObjectExecuteContext.

Method Summary

Modifier and Type	Method	Description
ProcessManager	invokeProcess(int flowIndex, Object parameter, ManagedObject managedObject, long delay, FlowCallback callback)	Instigates a ProcessState.
ProcessManager	invokeProcess(F key, Object parameter, ManagedObject managedObject, long delay, FlowCallback callback)	Instigates a ProcessState.
ProcessManager	invokeProcess(SafeManagedObjectService.ProcessInvoker<F> invoker)	Enables generic ProcessState invocation.
<T extends Exception> boolean	service(SafeManagedObjectService.SafeServicer<F,T> servicer)	Undertakes servicing.

Methods inherited from class java.lang.Object

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

Constructor Details

SafeManagedObjectService

public SafeManagedObjectService(ManagedObjectExecuteContext<F> executeContext)

Initiate ManagedObjectExecuteContext.

Parameters:

executeContext - ManagedObjectExecuteContext.

SafeManagedObjectService

public SafeManagedObjectService(ManagedObjectExecuteContext<F> executeContext,
 SafeManagedObjectService.SafeServicer<F,? extends Exception> startup)

Initiate ManagedObjectExecuteContext.

Parameters:

executeContext - ManagedObjectExecuteContext.

startup - Start up SafeManagedObjectService.SafeServicer.

Method Details

service

public <T extends Exception> boolean service(SafeManagedObjectService.SafeServicer<F,T> servicer)
                                      throws T,
InterruptedException

Undertakes servicing.

Type Parameters:

T - Possible Exception type.

Parameters:

servicer - Logic for servicing.

Returns:

true if servicing invoked. false is stopped servicing.

Throws:

T - SafeManagedObjectService.SafeServicer possible failure.

InterruptedException - If failed to waiting for servicing.

invokeProcess

public ProcessManager invokeProcess(SafeManagedObjectService.ProcessInvoker<F> invoker)

Enables generic ProcessState invocation.

Parameters:

invoker - SafeManagedObjectService.ProcessInvoker.

Returns:

ProcessManager of the invoked ProcessState.

invokeProcess

public ProcessManager invokeProcess(F key,
 Object parameter,
 ManagedObject managedObject,
 long delay,
 FlowCallback callback)
                             throws IllegalArgumentException

Description copied from interface: ManagedObjectServiceContext

Instigates a ProcessState.

Specified by:

invokeProcess in interface ManagedObjectServiceContext<F extends Enum<F>>

Parameters:

key - Key identifying the Flow to instigate.

parameter - Parameter to first ManagedFunction of the Flow.

managedObject - ManagedObject for the ProcessState of the Flow.

delay - Delay in milliseconds before the Flow is invoked. A 0 or negative value invokes the Flow immediately.

callback - FlowCallback on completion of the Flow.

Returns:

ProcessManager for the ProcessState.

Throws:

IllegalArgumentException - If

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

invokeProcess

public ProcessManager invokeProcess(int flowIndex,
 Object parameter,
 ManagedObject managedObject,
 long delay,
 FlowCallback callback)
                             throws IllegalArgumentException

Description copied from interface: ManagedObjectServiceContext

Instigates a ProcessState.

Specified by:

invokeProcess in interface ManagedObjectServiceContext<F extends Enum<F>>

Parameters:

flowIndex - Index identifying the Flow to instigate.

parameter - Parameter that to the first ManagedFunction of the Flow.

managedObject - ManagedObject for the ProcessState of the Flow.

delay - Delay in milliseconds before the Flow is invoked. A 0 or negative value invokes the Flow immediately.

callback - FlowCallback on completion of the Flow.

Returns:

ProcessManager for the ProcessState.

Throws:

IllegalArgumentException - If

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