com.install4j.api.windows
Class WinEnvVars

java.lang.Object
  com.install4j.api.windows.WinEnvVars

public class WinEnvVars
extends java.lang.Object

Collection of static methods to get and modify environment variables on Windows.

Author:

ej-technologies GmbH

Constructor Summary

WinEnvVars()

Method Summary

static void	appendToPath(java.lang.String value) Appends one or more directories to the PATH environment variable.
static void	appendToUserPath(java.lang.String value) Appends one or more directories to the user-specific PATH environment variable on Windows NT/2000/XP/Vista.
static java.util.Properties	getenv() Returns all environment variables.
static java.lang.String	getenv(java.lang.String key) Returns a single environment variable.
static void	prependToPath(java.lang.String value) Prepends one or more directories to the PATH environment variable.
static void	prependToUserPath(java.lang.String value) Prepends one or more directories to the user-specific PATH environment variable on Windows NT/2000/XP/Vista.
static void	set(java.lang.String key, java.lang.String value) Sets a global environment variable.
static void	setUserSpecific(java.lang.String key, java.lang.String value) Sets a user-specific environment variable on NT/2000/XP/Vista.

Methods inherited from class java.lang.Object

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

Constructor Detail

WinEnvVars

public WinEnvVars()

Method Detail

set

public static void set(java.lang.String key,
                       java.lang.String value)
                throws java.io.IOException

Sets a global environment variable. Needs Administrator rights on Windows NT/2000/XP/Vista. On Windows 9X you have to restart the system afterwards, on NT/2000/XP/Vista you have to log off and on again.

Parameters:

key - the name of the environment variable

value - the value of the environment variable

Throws:

java.io.IOException - if the environment variable could not be set

setUserSpecific

public static void setUserSpecific(java.lang.String key,
                                   java.lang.String value)
                            throws java.io.IOException

Sets a user-specific environment variable on NT/2000/XP/Vista. On Windows 9x this sets a global environment variable. On Windows 9X you have to restart the system afterwards, on NT/2000/XP/Vista you have to log off and on again.

Parameters:

key - the name of the environment variable

value - the value of the environment variable

Throws:

java.io.IOException - if the environment variable could not be set

getenv

public static java.lang.String getenv(java.lang.String key)

Returns a single environment variable.

Parameters:

key - the name of the environment variable. Case does not matter.

Returns:

the value of the environment variable or null if not defined

getenv

public static java.util.Properties getenv()

Returns all environment variables.

Returns:

a property map with all environment variables and its values

appendToPath

public static void appendToPath(java.lang.String value)
                         throws java.io.IOException

Appends one or more directories to the PATH environment variable. Needs Administrator rights on Windows NT/2000/XP/Vista. On Windows 9X you have to restart the system afterwards, on NT/2000/XP/Vista you have to log off and on again.

Parameters:

value - the value to be appended to the path

Throws:

java.io.IOException - if the environment variable could not be set

prependToPath

public static void prependToPath(java.lang.String value)
                          throws java.io.IOException

Prepends one or more directories to the PATH environment variable. Needs Administrator rights on Windows NT/2000/XP/Vista. On Windows 9X you have to restart the system afterwards, on NT/2000/XP/Vista you have to log off and on again.

Parameters:

value - the value to be appended to the path

Throws:

java.io.IOException - if the environment variable could not be set

appendToUserPath

public static void appendToUserPath(java.lang.String value)
                             throws java.io.IOException

Appends one or more directories to the user-specific PATH environment variable on Windows NT/2000/XP/Vista. Calls appendToPath for Windows 9X On Windows 9X you have to restart the system afterwards, on NT/2000/XP/Vista you have to log off and on again.

Parameters:

value - the value to be appended to the path

Throws:

java.io.IOException - if the environment variable could not be set

See Also:

appendToPath(String)

prependToUserPath

public static void prependToUserPath(java.lang.String value)
                              throws java.io.IOException

Prepends one or more directories to the user-specific PATH environment variable on Windows NT/2000/XP/Vista. Calls prependToPath for Windows 9X On Windows 9X you have to restart the system afterwards, on NT/2000/XP/Vista you have to log off and on again.

Parameters:

value - the value to be appended to the path

Throws:

java.io.IOException - if the environment variable could not be set

See Also:

prependToPath(String)