abbot.script

Class ForkedStepRunner

java.lang.Object

abbot.script.StepRunner

abbot.script.ForkedStepRunner

public class ForkedStepRunner
extends StepRunner

A StepRunner that runs the step in a separate VM. Behavior should be indistinguishable from the base StepRunner.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) class	ForkedStepRunner.ForkedError An exception that for all purposes looks like another exception.
(package private) class	ForkedStepRunner.ForkedFailure An exception that looks almost exactly like some other exception, without actually having access to the instance of the original exception.
protected static class	ForkedStepRunner.SlaveStepRunner When actually within the separate VM, this is what gets run.

Nested classes/interfaces inherited from class abbot.script.StepRunner

StepRunner.ExitHandler

Field Summary

Fields

Modifier and Type	Field and Description
(package private) int	LAUNCH_TIMEOUT
(package private) int	TERMINATE_TIMEOUT

Fields inherited from class abbot.script.StepRunner

helper, hierarchy

Constructor Summary

Constructors

Constructor and Description
ForkedStepRunner()
ForkedStepRunner(StepRunner parent)

Method Summary

Methods

Modifier and Type	Method and Description
(package private) static Step	decodeStep(Sequence root, java.lang.String code)
(package private) static java.lang.String	encodeStep(Sequence root, Step step) Encode the given step into a set of indices.
(package private) java.lang.Process	fork(java.lang.String vmargs) Launch a new process, using this class as the main class.
(package private) java.lang.Process	fork(java.lang.String vmargs, java.lang.String[] cmdArgs)
static void	main(java.lang.String[] args) Provide means to control execution and feedback of a script in a separate process.
void	runStep(Step step) Running the step in a separate VM should be indistinguishable from running a regular script.

Methods inherited from class abbot.script.StepRunner

addStepListener, checkFile, clearErrors, createSecurityManager, fireStepEnd, fireStepError, fireStepEvent, fireStepFailure, fireStepProgress, fireStepStart, getCurrentContext, getError, getHierarchy, getStopOnError, getStopOnFailure, getTerminateOnError, installSecurityManager, launch, removeSecurityManager, removeStepListener, run, setError, setStopOnError, setStopOnFailure, setTerminateOnError, stop, stop, stopped, terminate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LAUNCH_TIMEOUT

int LAUNCH_TIMEOUT

TERMINATE_TIMEOUT

int TERMINATE_TIMEOUT

Constructor Detail

ForkedStepRunner

public ForkedStepRunner()

ForkedStepRunner

public ForkedStepRunner(StepRunner parent)

Method Detail

fork

java.lang.Process fork(java.lang.String vmargs,
                     java.lang.String[] cmdArgs)
                 throws java.io.IOException

Throws:

java.io.IOException

fork

java.lang.Process fork(java.lang.String vmargs)
                 throws java.net.UnknownHostException,
                        java.io.IOException

Launch a new process, using this class as the main class.

Throws:

java.net.UnknownHostException

java.io.IOException

runStep

public void runStep(Step step)
             throws java.lang.Throwable

Running the step in a separate VM should be indistinguishable from running a regular script. When running as master, nothing actually runs locally. We just fork a subprocess and run the script in that, reporting back its progress as if it were running locally.

Overrides:

runStep in class StepRunner

Throws:

java.lang.Throwable

decodeStep

static Step decodeStep(Sequence root,
              java.lang.String code)

encodeStep

static java.lang.String encodeStep(Sequence root,
                          Step step)

Encode the given step into a set of indices.

main

public static void main(java.lang.String[] args)

Provide means to control execution and feedback of a script in a separate process.