seda.sandStorm.api
Interface ManagerIF

All Known Implementing Classes:

sandStormMgr

public interface ManagerIF

ManagerIF represents the system manger, which provides various runtime services to applications, such as access to other stages.

Field Summary

static java.lang.String

MAINSINK Each stage may have multiple event queues associated with it.

Method Summary

StageIF	createStage(java.lang.String stagename, EventHandlerIF eventHandler, java.lang.String[] initargs) Create a stage with the given name, event handler, and initial arguments.
SandstormConfig	getConfig() Returns a copy of the SandstormConfig for this Manager.
ProfilerIF	getProfiler() Returns a handle to the system profiler.
SignalMgrIF	getSignalMgr() Returns a handle to the system signal interface.
StageIF	getStage(java.lang.String stagename) Return a handle to the stage with the given name.

Field Detail

MAINSINK

static final java.lang.String MAINSINK

Each stage may have multiple event queues associated with it. This is the name of the 'main' event queue for a given stage, and is the default sink returned by a call to StageIF.getSink().

See Also:

StageIF, Constant Field Values

Method Detail

getStage

StageIF getStage(java.lang.String stagename)
                 throws NoSuchStageException

Return a handle to the stage with the given name.

Throws:

NoSuchStageException - Thrown if the stage does not exist.

createStage

StageIF createStage(java.lang.String stagename,
                    EventHandlerIF eventHandler,
                    java.lang.String[] initargs)
                    throws java.lang.Exception

Create a stage with the given name, event handler, and initial arguments. This method can be used by applications to create new stages at runtime.

The default stage wrapper and thread manager are used; the sandStorm.api.SystemManagerIF interface provides a lower-level mechanism in case the application has a need to specify these explicitly.

Parameters:

stagename - The name under which the new stage should be registered.

eventHandler - The event handler object which should be associated with the new stage.

initargs - The initial arguments to the stage, to be passed to the new stage through a ConfigDataIF.

Returns:

A handle to the newly-created stage.

Throws:

java.lang.Exception - If an exception occurred during stage creation or initialization.

See Also:

SystemManagerIF, ConfigDataIF

getSignalMgr

SignalMgrIF getSignalMgr()

Returns a handle to the system signal interface.

getProfiler

ProfilerIF getProfiler()

Returns a handle to the system profiler.

getConfig

SandstormConfig getConfig()

Returns a copy of the SandstormConfig for this Manager. This contains all of the global options used by the runtime system. Note that modifying any options of this copy does not in fact change the runtime parameters of the system; this is used for informational purposes only.