Package de.aristaflow.adept2.core.runtimemanager

Interface ActivityStateNotification

All Known Subinterfaces:

RemoteGUIManager

All Known Implementing Classes:

AbstractGUIManager, ActivityStateNotificationWrapper, NullGUIManager, RemoteHTMLGUIManager

public interface ActivityStateNotification

This interface is used as a callback for the events when an executed activity terminates, that is has been closed, suspended, reset, failed or signalled. The runtime manager informs the implementing class about the corresponding events. The implementation has to register when the corresponding activity is started (SynchronousActivityStarting.startActivitySynchronously(de.aristaflow.adept2.base.sessionmanagement.SessionToken, EBPInstanceReference, de.aristaflow.adept2.model.globals.ProcessConstants.ExecutionMode, URI[]) or resumed SynchronousActivityStarting.resumeActivitySynchronously(de.aristaflow.adept2.base.sessionmanagement.SessionToken, EBPInstanceReference, URI[])).
Since this interface is a callback-interface, no session tokens are used.
Note that all notifications will be only sent once per activity, that is after the notification, the listener will be deregistered. The only exception are suspended activities that are resumed. There will be a resume notification if the activity is resumed on the very same RuntimeManager. If the activity has been resumed without registering a new listener by using SynchronousActivityStarting.resumeActivitySynchronously(de.aristaflow.adept2.base.sessionmanagement.SessionToken, EBPInstanceReference), the registered listener will retrieve further notifications.

Author:

Ulrich Kreher

See Also:

InstanceControl

Method Summary

Modifier and Type	Method	Description
void	activityClosed(EBPInstanceReference activity, String sessionID)	Notifies that the designated activity in the designated execution session has been closed.
void	activityFailed(EBPInstanceReference activity, String sessionID, String errorMessage, String state, long errorCode)	Notifies that the designated activity in the designated execution session has failed with the designated additional failure information.
void	activityReset(EBPInstanceReference activity, String sessionID)	Notifies that the designated activity in the designated execution session has been reset.
void	activityResumed(EBPInstanceReference activity, String sessionID, URI[] newListener)	Notifies that the designated activity has been resumed.
void	activitySignalled(EBPInstanceReference activity, String sessionID, int signal)	Notifies that the designated activity in the designated execution session has terminated with the designated signal.
void	activitySuspended(EBPInstanceReference activity, String sessionID)	Notifies that the designated activity in the designated execution session has been suspended normally.
void	activitySuspended(EBPInstanceReference activity, String sessionID, long timeout)	Notifies that the designated activity in the designated execution session has been suspended and needs to be resumed after the designated timeout.

Method Detail

activityClosed

void activityClosed(EBPInstanceReference activity,
                    String sessionID)

Notifies that the designated activity in the designated execution session has been closed.

Parameters:

activity - The activity that has been closed.

sessionID - The ID of the execution session of the closed activity.

activitySuspended

void activitySuspended(EBPInstanceReference activity,
                       String sessionID)

Notifies that the designated activity in the designated execution session has been suspended normally. There may be an resume and further notifications afterwards.

Parameters:

activity - The activity that has been suspended normally.

sessionID - The ID of the execution session of the suspended activity.

activitySuspended

void activitySuspended(EBPInstanceReference activity,
                       String sessionID,
                       long timeout)

Notifies that the designated activity in the designated execution session has been suspended and needs to be resumed after the designated timeout. Usually this will be started by a ResumingRuntimeManager and thus there will be a resume and further notifications afterwards.

Parameters:

activity - The activity that has been suspended normally.

sessionID - The ID of the execution session of the suspended activity.

timeout - The time period (in milliseconds) when the suspended application wants to be resumed automatically.

activityResumed

void activityResumed(EBPInstanceReference activity,
                     String sessionID,
                     URI[] newListener)

Notifies that the designated activity has been resumed. This will only be sent if the activity is resumed on the very same runtime manager.

Parameters:

activity - The activity that has been suspended normally.

sessionID - The ID of the new execution session of the resumed activity.

newListener - The URIs of the listener that has been registered when resuming or null in case no listener has been registered when resuming. If a new listener has been registered, this listener will not be notified any more.

See Also:

SynchronousActivityStarting.resumeActivitySynchronously(de.aristaflow.adept2.base.sessionmanagement.SessionToken, EBPInstanceReference)

activityReset

void activityReset(EBPInstanceReference activity,
                   String sessionID)

Notifies that the designated activity in the designated execution session has been reset.

Parameters:

activity - The activity that has been reset.

sessionID - The ID of the execution session of the reset activity.

activitySignalled

void activitySignalled(EBPInstanceReference activity,
                       String sessionID,
                       int signal)

Notifies that the designated activity in the designated execution session has terminated with the designated signal.

Parameters:

activity - The activity that has been terminated.

sessionID - The ID of the execution session of the signalled activity.

signal - The signal that led to the termination of the activity.

activityFailed

void activityFailed(EBPInstanceReference activity,
                    String sessionID,
                    String errorMessage,
                    String state,
                    long errorCode)

Notifies that the designated activity in the designated execution session has failed with the designated additional failure information.

Parameters:

activity - The activity that has failed.

sessionID - The ID of the execution session of the failed activity.

errorMessage - The error message to be interpreted by a user or by a failure handling routine.

state - Arbitrary state information specific to the instance, comparable to the vendor code in SQLException.

errorCode - The error code specifying the type of error.