com.partnersoft.system
Class RuntimeLib

java.lang.Object
  com.partnersoft.system.RuntimeLib

public class RuntimeLib
extends java.lang.Object

A library with handy routines for handling external execution etc.

Author:

Paul Reavis Copyright 2001 Partner Software, Inc.

Constructor Summary

RuntimeLib()

Method Summary

static void	cleanupMemory() Does it's damnedest to clear out memory, both used and available heap.
static void	execAndHalt(java.lang.String command) Executes the given OS-specific command; then halts the current Java session.
static void	execAndHalt(java.lang.String command, java.io.File currentDir) Executes the given OS-specific command; then halts the current Java session.
static void	execAndWait(java.lang.String command) Same as execAndWait(command, currentDir) but defaulted to the install dir.
static void	execAndWait(java.lang.String command, java.io.File currentDir) A wrapper for Runtime.exec() that handles the problems of grabbing the input streams and reading from them, and waits for completion.
static java.lang.Process	execNoWait(java.lang.String command) Same as execNoWait(command, currentDir) but defaulted to the install directory.
static java.lang.Process	execNoWait(java.lang.String command, java.io.File currentDir) Same as execAndWait(command, currentDir) but does not wait - the process continues in a separate thread.
static void	launchAppAndHalt(java.lang.String appName) Restart the Java session, calling the given application.
static void	launchAppAndHalt(java.lang.String appName, java.io.File currentDir) Restart the Java session, calling the given application.
static void	logMemoryUsage()
static void	logOutput(java.lang.Process proc) Logs all output from a process; waits for result.
static void	tossOutput(java.lang.Process proc) Tosses all output from a process.

Methods inherited from class java.lang.Object

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

Constructor Detail

RuntimeLib

public RuntimeLib()

Method Detail

cleanupMemory

public static void cleanupMemory()

Does it's damnedest to clear out memory, both used and available heap.

logMemoryUsage

public static void logMemoryUsage()

execAndWait

public static void execAndWait(java.lang.String command)
                        throws java.io.IOException

Same as execAndWait(command, currentDir) but defaulted to the install dir.

Throws:

java.io.IOException

execAndWait

public static void execAndWait(java.lang.String command,
                               java.io.File currentDir)
                        throws java.io.IOException

A wrapper for Runtime.exec() that handles the problems of grabbing the input streams and reading from them, and waits for completion. Note that with Windows you need to use backslashes (doubled inside strings) to separate directories; these functions do not fix the path separators like com.partnersoft.io.FileLib does. As much as possible, the command is run just as if you typed it in a command shell. Note that some commands (e.g. start in Windows) are built-in to the shell rather than being independent executable.

Throws:

java.io.IOException

execNoWait

public static java.lang.Process execNoWait(java.lang.String command)
                                    throws java.io.IOException

Same as execNoWait(command, currentDir) but defaulted to the install directory.

Throws:

java.io.IOException

execNoWait

public static java.lang.Process execNoWait(java.lang.String command,
                                           java.io.File currentDir)
                                    throws java.io.IOException

Same as execAndWait(command, currentDir) but does not wait - the process continues in a separate thread.

Throws:

java.io.IOException

execAndHalt

public static void execAndHalt(java.lang.String command)
                        throws java.io.IOException

Executes the given OS-specific command; then halts the current Java session.

Throws:

java.io.IOException

execAndHalt

public static void execAndHalt(java.lang.String command,
                               java.io.File currentDir)
                        throws java.io.IOException

Executes the given OS-specific command; then halts the current Java session.

Throws:

java.io.IOException

launchAppAndHalt

public static void launchAppAndHalt(java.lang.String appName)
                             throws java.io.IOException

Restart the Java session, calling the given application.

Throws:

java.io.IOException

launchAppAndHalt

public static void launchAppAndHalt(java.lang.String appName,
                                    java.io.File currentDir)
                             throws java.io.IOException

Restart the Java session, calling the given application.

Throws:

java.io.IOException

tossOutput

public static void tossOutput(java.lang.Process proc)

Tosses all output from a process.

logOutput

public static void logOutput(java.lang.Process proc)

Logs all output from a process; waits for result.