com.goldencode.p2j.ui.client.chui.driver

Class VT100EmulatorChildProcess

java.lang.Object

com.goldencode.p2j.ui.client.chui.driver.AbstractChildProcess

com.goldencode.p2j.ui.client.chui.driver.VT100EmulatorChildProcess

All Implemented Interfaces:

InteractiveChildProcess

Direct Known Subclasses:

ChuiWebDriver.VT100WebEmulator, SwingChuiDriver.VT100SwingEmulator

public abstract class VT100EmulatorChildProcess
extends AbstractChildProcess

Provides an implementation for an interactive child process for clients that do NOT have a native terminal built-in to the JVM process.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	VT100EmulatorChildProcess.Cleaner Provides a simple mechanism to wait for the exit of a process on an asynchronous basis (on a new thread dedicated to this wait).

Field Summary

Fields

Modifier and Type	Field and Description
protected VT100Emulator	emulator Child process wrapped by a VT100 terminal emulator.
protected java.lang.Thread	worker Emulator worker thread.

Fields inherited from class com.goldencode.p2j.ui.client.chui.driver.AbstractChildProcess

artificial, batch, terminal

Constructor Summary

Constructors

Constructor and Description
VT100EmulatorChildProcess() Construct an instance.

Method Summary

Modifier and Type	Method and Description
void	asynchCleanup(int pid) Asynchronously cleanup any operating system resources when the interactive child process has exited.
abstract VT100Emulator	createShellEmulator(java.lang.String[] cmdline) Create a shell emulator and execute the given command.
int	launch(java.lang.String[] cmdline, boolean silent) Launch the specified command line as an interactive child process.
int	pauseForUser() Wait for the user to press a key.
void	waitForExit(int pid, boolean silent) Block execution until the interactive child process has exited.

Methods inherited from class com.goldencode.p2j.ui.client.chui.driver.AbstractChildProcess

inBatchMode, isArtificialTerm, resume, suspend

Methods inherited from class java.lang.Object

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

Field Detail

emulator

protected VT100Emulator emulator

Child process wrapped by a VT100 terminal emulator.

worker

protected java.lang.Thread worker

Emulator worker thread.

Constructor Detail

VT100EmulatorChildProcess

public VT100EmulatorChildProcess()

Construct an instance.

Method Detail

createShellEmulator

public abstract VT100Emulator createShellEmulator(java.lang.String[] cmdline)

Create a shell emulator and execute the given command.

Parameters:

cmdline - The command.

Returns:

A VT100 emulator executing the given command.

launch

public int launch(java.lang.String[] cmdline,
                  boolean silent)

Launch the specified command line as an interactive child process.

Parameters:

cmdline - The command line to execute. The first element must be the program name.

silent - false for interactive mode (there the terminal is expected to be shared by the child process and the user is allowed to directly interact with the child process.

Returns:

The operating system process ID (pid) of the child process.

waitForExit

public void waitForExit(int pid,
                        boolean silent)
                 throws java.lang.InterruptedException

Block execution until the interactive child process has exited. This will ensure that any operating system resources are released before returning.

Parameters:

pid - The operating system process ID of the child process on which to wait.

silent - false for interactive mode (there the terminal is expected to be shared by the child process and the user is allowed to directly interact with the child process.

Throws:

java.lang.InterruptedException

asynchCleanup

public void asynchCleanup(int pid)

Asynchronously cleanup any operating system resources when the interactive child process has exited. This processing should be done an a secondary thread and this method will return immediately after starting that thread.

Parameters:

pid - The operating system process ID of the child process on which to wait.

pauseForUser

public int pauseForUser()

Wait for the user to press a key.

Specified by:

pauseForUser in interface InteractiveChildProcess

Overrides:

pauseForUser in class AbstractChildProcess

Returns:

The key code of the key pressed to clear the pause or -1 on any failure.