Class IOUtil

java.lang.Object

org.fife.rsta.ac.IOUtil

public final class IOUtil
extends Object

I/O related utility methods. We should think of a better location for these methods.

Version:

1.0

Field Summary

Fields

Modifier and Type	Field	Description
private static Map<String,String>	defaultEnv

Constructor Summary

Constructors

Modifier	Constructor	Description
private	IOUtil()	Private constructor to prevent instantiation.

Method Summary

Modifier and Type	Method	Description
private static Map<String,String>	getDefaultEnvMap()	Gets the environment of the current process.
static String[]	getEnvironmentSafely(String[] toAdd)	Returns the environment of the current process, with some variables possibly added/overwritten.
static String	getEnvSafely(String var)	Returns the value of an environment variable.
static void	main(String[] args)	Utility testing method.
static int	waitForProcess(Process p, StringBuilder stdout, StringBuilder stderr)	Runs a process, possibly capturing its stdout and/or stderr.

Methods inherited from class Object

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

Field Details

defaultEnv

private static Map<String,String> defaultEnv

Constructor Details

IOUtil

private IOUtil()

Private constructor to prevent instantiation.

Method Details

getDefaultEnvMap

private static Map<String,String> getDefaultEnvMap()

Gets the environment of the current process.

Returns:

A mapping of environment variable names to values.

getEnvSafely

public static String getEnvSafely(String var)

Returns the value of an environment variable. This method is here so we don't get an exception when calling System.getenv() in Java 1.4 (which we support).

Parameters:

var - The environment variable.

Returns:

The value of the variable, or null if it is not defined.

getEnvironmentSafely

public static String[] getEnvironmentSafely(String[] toAdd)

Returns the environment of the current process, with some variables possibly added/overwritten. This method works even with Java 1.4.

Parameters:

toAdd - The environment variables to add/overwrite in the returned array. This array should have an even length, with even indices containing variable names and odd indices containing the variable values.

Returns:

The environment variables. This array's entries will be of the form "name=value", so it can be passed directly into Runtime.exec().

waitForProcess

public static int waitForProcess(Process p,
 StringBuilder stdout,
 StringBuilder stderr)
                          throws IOException

Runs a process, possibly capturing its stdout and/or stderr.

Parameters:

p - The process.

stdout - A buffer in which to put stdout, or null if you don't want to keep it.

stderr - A buffer in which to keep stderr, or null if you don't want to keep it.

Returns:

The return code of the process.

Throws:

IOException - If an IO error occurs.

main

public static void main(String[] args)

Utility testing method.

Parameters:

args - Command line arguments.