org.eclipse.stardust.engine.core.spi.extensions.runtime

Interface AsynchronousApplicationInstance

All Superinterfaces:

ApplicationInstance

public interface AsynchronousApplicationInstance
extends ApplicationInstance

Describes the contract to implement the runtime behaviour of an asynchronous application type. It contains the callbacks the CARNOT engine needs to sucessfully run an asynchronous application

Version:

$Revision$

Author:

rsauer, ubirkemeyer

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isReceiving() Indicates that the instance will implement RECEIVE behaviour.
boolean	isSending() Indicates that the instance will implement SEND behaviour.
Map	receive(Map data, Iterator outDataTypes) Callback when the corresponding activity instance is awakened from the HIBERNATED state.
void	send() Callback to make an asynchronous call.

Methods inherited from interface org.eclipse.stardust.engine.core.spi.extensions.runtime.ApplicationInstance

bootstrap, cleanup, getOutAccessPointValue, setInAccessPointValue

Method Detail

send

void send()
          throws InvocationTargetException

Callback to make an asynchronous call.

Throws:

InvocationTargetException - Any exception thrown while attempting to send has to be delivered via this exception.

receive

Map receive(Map data,
          Iterator outDataTypes)

Callback when the corresponding activity instance is awakened from the HIBERNATED state.

Parameters:

data - The data received.

outDataTypes - A set of AccessPointBean names to be expected as return values. This is filled by the CARNOT engine and is an optimization hint to prevent the application instance to evaluate all possible OUT AccessPoints.

Returns:

A map with the provided AccessPointBean names as keys and the values at this access points as values.

isSending

boolean isSending()

Indicates that the instance will implement SEND behaviour.

Returns:

true if the the application provides asynchronous send functionality, false if not.

isReceiving

boolean isReceiving()

Indicates that the instance will implement RECEIVE behaviour.

Returns:

true if the the application provides asynchronous receive functionality, false if not.