com.goldencode.p2j.util

Class ProcessOps

java.lang.Object

com.goldencode.p2j.util.ProcessOps

public class ProcessOps
extends java.lang.Object

Provides static utility methods for Progress 4GL compatible process launching and control. At this time, the following Progress 4GL language statements are handled:

 Progress Language Statement    Java Equivalent
 ---------------------------    ---------------------------
 BTOS                           launch(String[], boolean, boolean, boolean)
 DOS                            launch(String[], boolean, boolean, boolean)
 OS-COMMAND                     launch(String[], boolean, boolean, boolean)
 OS2                            launch(String[], boolean, boolean, boolean)
 UNIX                           launch(String[], boolean, boolean, boolean)
 INPUT THROUGH                  launch(String[], RemoteStream, RemoteStream)
 OUTPUT THROUGH                 launch(String[], RemoteStream, RemoteStream)
 INPUT-OUTPUT THROUGH           launch(String[], RemoteStream, RemoteStream)
 

Author:

GES

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ProcessOps.CommandLineParser Gets a supported helper application parameter from the given command arguments list.
private static class	ProcessOps.ContextContainer Simple container that stores and returns a context-local instance of the global work area.
private static class	ProcessOps.WorkArea Stores global data relating to the state of the current context.

Field Summary

Fields

Modifier and Type	Field and Description
private static ProcessOps.ContextContainer	work Stores context-local state variables.

Constructor Summary

Constructors

Constructor and Description
ProcessOps()

Method Summary

Modifier and Type	Method and Description
static void	launch() Launches the default shell for this system synchronous operation and displaying a prompt after the child process terminates.
static void	launch(boolean silent, boolean wait) Launches the default shell for this system taking into account the flags which specify synchronous or asynchronous operation and whether a prompt is provided after the child process terminates.
static void	launch(java.lang.String[] cmdlist, boolean silent, boolean wait) Launches the external executible specified by the cmdlist taking into account the flags which specify synchronous or asynchronous operation and whether a prompt is provided after the child process terminates.
static void	launch(java.lang.String[] cmdlist, boolean silent, boolean wait, boolean console) Launches the external executible specified by the cmdlist taking into account the flags which specify synchronous or asynchronous operation and whether a prompt is provided after the child process terminates.
static void	launch(java.lang.String[] cmdlist, RemoteStream sout, RemoteStream sin) Launches the external executible specified by the cmdlist on an asynchronous basis.
static void	launch(java.lang.String[] cmdlist, StreamWrapper sout, StreamWrapper sin) Launches the external executible specified by the cmdlist on an asynchronous basis.

Methods inherited from class java.lang.Object

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

Field Detail

work

private static ProcessOps.ContextContainer work

Stores context-local state variables.

Constructor Detail

ProcessOps

public ProcessOps()

Method Detail

launch

public static void launch()

Launches the default shell for this system synchronous operation and displaying a prompt after the child process terminates. The command is always executed as a child process of the current JVM process.

STDIN, STDOUT and STDERR are all linked from the child process to the current JVM process using a StreamConnector for each pipe.

launch

public static void launch(boolean silent,
                          boolean wait)

Launches the default shell for this system taking into account the flags which specify synchronous or asynchronous operation and whether a prompt is provided after the child process terminates. The command is always executed as a child process of the current JVM process.

STDIN, STDOUT and STDERR are all linked from the child process to the current JVM process using a StreamConnector for each pipe.

Parameters:

silent - If true the default prompt is suppressed. Otherwise, ThinClient.pause is called when the child process exits.

wait - If true, synchronous operation is requested which waits for the termination of the child process on the current thread. If false, a thread will be started to wait for the child process termination and to subsequently handle cleanup (asynchronous mode).

launch

public static void launch(java.lang.String[] cmdlist,
                          boolean silent,
                          boolean wait)

Launches the external executible specified by the cmdlist taking into account the flags which specify synchronous or asynchronous operation and whether a prompt is provided after the child process terminates. The command is always executed as a child process of the shell which is a child process of the current JVM process.

STDIN, STDOUT and STDERR are all linked from the child process to the current JVM process using a StreamConnector for each pipe.

Parameters:

cmdlist - The command line to be executed, with the first element used as the program to run and all other array elements as the arguments.

silent - If true the default prompt is suppressed. Otherwise, ThinClient.pause is called when the child process exits.

wait - If true, synchronous operation is requested which waits for the termination of the child process on the current thread. If false, a thread will be started to wait for the child process termination and to subsequently handle cleanup (asynchronous mode).

launch

public static void launch(java.lang.String[] cmdlist,
                          boolean silent,
                          boolean wait,
                          boolean console)

Launches the external executible specified by the cmdlist taking into account the flags which specify synchronous or asynchronous operation and whether a prompt is provided after the child process terminates. The command is always executed as a child process of the shell which is a child process of the current JVM process.

STDIN, STDOUT and STDERR are all linked from the child process to the current JVM process using a StreamConnector for each pipe.

Parameters:

cmdlist - The command line to be executed, with the first element used as the program to run and all other array elements as the arguments.

silent - If true the default prompt is suppressed. Otherwise, ThinClient.pause is called when the child process exits.

wait - If true, synchronous operation is requested which waits for the termination of the child process on the current thread. If false, a thread will be started to wait for the child process termination and to subsequently handle cleanup (asynchronous mode).

console - If true, the process is starting in a separate new console, false means using 4GL no-console option.

launch

public static void launch(java.lang.String[] cmdlist,
                          StreamWrapper sout,
                          StreamWrapper sin)

Launches the external executible specified by the cmdlist on an asynchronous basis. The command is always executed as a child process of the shell which is a child process of the current JVM process.

STDIN, STDOUT and STDERR are all linked from the child process to the passed parameters if those parameters are not null. Any null pipes are closed immediately and those pipes connected with the passed parameters must be closed by the caller. Please see the ProcessStream for more details.

Parameters:

cmdlist - The command line to be executed, with the first element used as the program to run and all other array elements as the arguments.

sout - A StreamWrapper instance which contains the ProcessStream to be connected to the child process' STDOUT and STDERR or null for no connection. Used for reading.

sin - A StreamWrapper instance which contains the ProcessStream to be connected to the child process' STDIN or null for no connection. Used for writing.

launch

public static void launch(java.lang.String[] cmdlist,
                          RemoteStream sout,
                          RemoteStream sin)

Launches the external executible specified by the cmdlist on an asynchronous basis. The command is always executed as a child process of the shell which is a child process of the current JVM process.

STDIN, STDOUT and STDERR are all linked from the child process to the passed parameters if those parameters are not null. Any null pipes are closed immediately and those pipes connected with the passed parameters must be closed by the caller. Please see the ProcessStream for more details.

Parameters:

cmdlist - The command line to be executed, with the first element used as the program to run and all other array elements as the arguments.

sout - The RemoteStream to be connected to the child process' STDOUT and STDERR or null for no connection. Used for reading.

sin - The RemoteStream to be connected to the child process' STDIN or null for no connection. Used for writing.