de.aristaflow.adept2.model.runtimeenvironment

Interface RuntimeEnvironmentFactory

public interface RuntimeEnvironmentFactory

This interface describes all "factory" methods used to construct objects in the base runtimeenvironment package. Implementations of the factory can be exchanged to accommodate non-default data models.

Author:

Patrick Haas, Andreas Lanz

Method Summary

Modifier and Type	Method and Description
SerialisableDataContext	createSerialisableDataContext(boolean readOnly, java.util.Map<java.lang.String,ProcessConstants.AdeptDataType> inputTypes, java.util.Map<java.lang.String,java.io.Serializable> inputValues, java.util.Map<java.lang.String,ProcessConstants.AdeptDataType> outputTypes, java.util.Map<java.lang.String,java.io.Serializable> outputValues) Creates a new serialisable data context having the designated input and output parameters.
SerialisableDataContext	createSerialisableDataContext(SessionToken session, DataContainer container, ExecutableBusinessProcessInstance ebp) Creates a new serialisable data context having the values of the designated data container.
ProgressMonitor	createSimpleProgressMonitor() Creates a new progress monitor without checking the thread for execution in a runtime service.
SimpleSessionContext	createSimpleSessionContext(java.lang.String sessionID, EBPInstanceReference ebpIR, SerialisableDataContext dataContext, ActivityInstance activity, ProcessConstants.ExecutionMode executionMode, Enquiry currentEnquiry, Enquiry repliedEnquiry, java.util.Map<java.lang.String,java.lang.String> userAttributes) Creates a new simple session context for starting an activity in a runtime service.
SimpleSessionContext	createSimpleSessionContext(java.lang.String sessionId, java.lang.String savepoint, EBPInstanceReference ebpIr, SerialisableDataContext dataContext, ActivityInstance activity, ProcessConstants.ExecutionMode executionMode, Enquiry currentEnquiry, Enquiry repliedEnquiry, java.util.Map<java.lang.String,java.lang.String> userAttributes) Creates a new simple session context for resuming an activity in a runtime service.
DataContext	getDataContext(ClientSessionFactory sessionFactory, DataContainer dataContainer, java.lang.Thread componentThread) Returns an application related data context and initialises it's data container with the provided value
SessionContext	getInitialSessionContext(ClientSessionFactory sessionFactory, java.lang.String sessionID, EBPInstanceReference ebpInstanceReference, DataContext dataContext, ExecutionContext executionContext, GUIContext guiContext, RuntimeEnvironment runtimeEnvironment, java.lang.Thread componentThread) Returns an application related implementation of the session context and initialises the sessionID of the session context by the passed value.
SessionContext	getWrappedSessionContext(SessionContext sessionContext, DataContext dataContext, ProcessConstants.ExecutionMode executionMode, GUIContext guiContext, RuntimeEnvironment runtimeEnvironment, java.lang.Thread componentThread) Returns a session context based on the designated one.

Method Detail

getDataContext

DataContext getDataContext(ClientSessionFactory sessionFactory,
                           DataContainer dataContainer,
                           java.lang.Thread componentThread)

Returns an application related data context and initialises it's data container with the provided value

Parameters:

sessionFactory - A session factory that could be used to create session tokens.

dataContainer - The container provided by the data manager which encapsulates the values of input parameters and the storage of the output parameters.

componentThread - The thread executing the component is the only thread to access the data context.

Returns:

A data context implementation providing the designated values.

createSerialisableDataContext

SerialisableDataContext createSerialisableDataContext(SessionToken session,
                                                      DataContainer container,
                                                      ExecutableBusinessProcessInstance ebp)
                                               throws NoSuchParameterException,
                                                      InvalidDataTypeException

Creates a new serialisable data context having the values of the designated data container. The parameter names will be retrieved from the designated ExecutableBusinessProcessInstance.

Parameters:

session - The session token for accessing the designated data container.

container - The data container providing the parameter values. This must not be null.

ebp - The ExecutableBusinessProcessInstance providing the parameter names. This must not be null.

Returns:

A new data context having the values of the designated data container.

Throws:

NoSuchParameterException - If a parameter from the ExecutableBusinessProcessInstance is not in the designated data container, a NoSuchParameterException will be thrown.

InvalidDataTypeException - If the data type of a parameter from the ExecutableBusinessProcessInstance does not have the same data type in the designated data container, an InvalidDataTypeException will be thrown.

createSerialisableDataContext

SerialisableDataContext createSerialisableDataContext(boolean readOnly,
                                                      java.util.Map<java.lang.String,ProcessConstants.AdeptDataType> inputTypes,
                                                      java.util.Map<java.lang.String,java.io.Serializable> inputValues,
                                                      java.util.Map<java.lang.String,ProcessConstants.AdeptDataType> outputTypes,
                                                      java.util.Map<java.lang.String,java.io.Serializable> outputValues)

Creates a new serialisable data context having the designated input and output parameters.

Parameters:

readOnly - Whether the created data container is read-only and therefore does not allow to store parameter values.

inputTypes - The parameter names and types names for input parameters.

inputValues - The parameter names and values for input parameters. To represent null values either the corresponding name is not in this map or it is mapped to null.

outputTypes - The parameter names and types names for output parameters.

outputValues - The parameter names and values for output parameters. To represent null values either the corresponding name is not in this map or it is mapped to null.

Returns:

A new data context having the designated parameter values.

getInitialSessionContext

SessionContext getInitialSessionContext(ClientSessionFactory sessionFactory,
                                        java.lang.String sessionID,
                                        EBPInstanceReference ebpInstanceReference,
                                        DataContext dataContext,
                                        ExecutionContext executionContext,
                                        GUIContext guiContext,
                                        RuntimeEnvironment runtimeEnvironment,
                                        java.lang.Thread componentThread)

Returns an application related implementation of the session context and initialises the sessionID of the session context by the passed value. The factory can load the relevant implementation for the activity. The caller must ensure that the passed sessionID is not in use, yet, unless recommended.

Parameters:

sessionFactory - A session factory that could be used to create session tokens.

sessionID - The ID that identifies the session.

ebpInstanceReference - The reference to the corresponding process step.

dataContext - The context containing the parameter values for the application.

executionContext - The execution context for the component.

guiContext - The graphical context for the application.

runtimeEnvironment - The environment to which the application sends its signals.

componentThread - The thread which executes the application. It is needed to allow for valid executor thread checking which in turn allows to avoid the need for synchronisation.

Returns:

The session context implementation providing the designated values.

getWrappedSessionContext

SessionContext getWrappedSessionContext(SessionContext sessionContext,
                                        DataContext dataContext,
                                        ProcessConstants.ExecutionMode executionMode,
                                        GUIContext guiContext,
                                        RuntimeEnvironment runtimeEnvironment,
                                        java.lang.Thread componentThread)

Returns a session context based on the designated one. This allows for wrapping the designated parameters and is used for a wrapping environment like the test environment.

Parameters:

sessionContext - The session information for the requested session context.

dataContext - The context containing the parameter values for the wrapped component.

executionMode - The execution mode for the wrapped component.

guiContext - The graphical context for the wrapped component.

runtimeEnvironment - The environment to which the wrapped component sends its signals to.

componentThread - The thread which executes the wrapped component. It is needed to allow for valid executor thread checking which in turn allows to avoid the need for synchronisation.

Returns:

The session context implementation providing the designated values for the wrapped component.

createSimpleSessionContext

SimpleSessionContext createSimpleSessionContext(java.lang.String sessionID,
                                                EBPInstanceReference ebpIR,
                                                SerialisableDataContext dataContext,
                                                ActivityInstance activity,
                                                ProcessConstants.ExecutionMode executionMode,
                                                Enquiry currentEnquiry,
                                                Enquiry repliedEnquiry,
                                                java.util.Map<java.lang.String,java.lang.String> userAttributes)

Creates a new simple session context for starting an activity in a runtime service.

Parameters:

sessionID - The execution session ID of the created session context.

ebpIR - The reference to the corresponding process step.

dataContext - The context for retrieval and storing of data.

activity - The activity instance providing the process context for the execution.

executionMode - The execution mode for the execution (substituted, test, production).

currentEnquiry - The current enquiry

repliedEnquiry - The replied enquiry

userAttributes - The user attributes.

Returns:

A new simple session context for a resumed activity in a runtime service.

createSimpleSessionContext

SimpleSessionContext createSimpleSessionContext(java.lang.String sessionId,
                                                java.lang.String savepoint,
                                                EBPInstanceReference ebpIr,
                                                SerialisableDataContext dataContext,
                                                ActivityInstance activity,
                                                ProcessConstants.ExecutionMode executionMode,
                                                Enquiry currentEnquiry,
                                                Enquiry repliedEnquiry,
                                                java.util.Map<java.lang.String,java.lang.String> userAttributes)

Creates a new simple session context for resuming an activity in a runtime service.

Parameters:

sessionId - The execution session ID of the created session context.

savepoint - The identifier of the savepoint at which the execution is to be resumed. This must not be null, but it may be the empty string.

ebpIr - The reference to the corresponding process step.

dataContext - The context for retrieval and storing of data.

activity - The activity instance providing the process context for the execution.

executionMode - The execution mode for the execution (substituted, test, production).

currentEnquiry - The current enquiry

repliedEnquiry - The replied enquiry

userAttributes - The user attributes.

Returns:

A new simple session context for resuming an activity in a runtime service.

createSimpleProgressMonitor

ProgressMonitor createSimpleProgressMonitor()

Creates a new progress monitor without checking the thread for execution in a runtime service.

Returns:

A new progress monitor without checking the thread for execution in a runtime service.