org.openquark.cal.machine
Interface CALExecutor

public interface CALExecutor

The interface supported by all CAL Executors, regardless of operating machine. Creation date: (3/27/01 8:30:03 AM)

Author:

Luke Evans

Method Summary

void	addStatsGenerator(StatsGenerator gen) Register a stats generator.
Object	exec(EntryPoint entryPoint, Object[] arguments) Execute the program from the specified entry point.
ExecutionContext	getContext()
void	removeStatsGenerator(StatsGenerator gen) Remove a stats generator.
void	requestQuit() Ask the runtime to quit.
void	requestSuspend() Ask the runtime to suspend.
void	setTraceFilters(List<Pattern> patterns) Set the regular expressions that the tracing code uses to filter the traces.

Method Detail

exec

Object exec(EntryPoint entryPoint,
            Object[] arguments)
            throws CALExecutorException

Execute the program from the specified entry point.

Parameters:

entryPoint -

arguments - (null is accepted and used as the 0-length Object array).

Returns:

the value resulting from the execution

Throws:

CALExecutorException

addStatsGenerator

void addStatsGenerator(StatsGenerator gen)

Register a stats generator.

Parameters:

gen -

removeStatsGenerator

void removeStatsGenerator(StatsGenerator gen)

Remove a stats generator.

Parameters:

gen -

requestQuit

void requestQuit()

Ask the runtime to quit. Note that you can only ask the runtime to quit; you can't un-quit - we may want to have something like this later if we want to implement "restart." Creation date: (3/21/02 1:39:40 PM)

requestSuspend

void requestSuspend()

Ask the runtime to suspend. If the running build is not debug capable this will have no effect. Debug capability is enabled via the system property: org.openquark.cal.runtime.debug_capable

getContext

ExecutionContext getContext()

Returns:

the context of execution being used by this CALExecutor.

setTraceFilters

void setTraceFilters(List<Pattern> patterns)

Set the regular expressions that the tracing code uses to filter the traces.

Parameters:

patterns - The list of regular expressions to use when filtering traces.