com.sun.enterprise.admin.cli
Class Environment

java.lang.Object
  com.sun.enterprise.admin.cli.Environment

public final class Environment
extends Object

The environment variables for CLI commands. An instance of this class is passed to each command to give it access to environment variables. Command implementations should access environment information from this class rather than using System.getenv. In multimode, the export command may change environment variables in the instance of this class that is shared by all commands.

Author:

Bill Shannon

Field Summary

static String	AS_ADMIN_ENV_PREFIX
private Map<String,String>	env

Constructor Summary

Environment()
Initialize the enviroment with all relevant system environment entries.

Environment(boolean ignoreEnvironment)
Constructor that ignores the system environment, mostly used to enable repeatable tests.

Method Summary

Set<Map.Entry<String,String>>	entrySet() Return a set of all the entries, just like a Map does.
String	get(String name) Get the named environment entry.
boolean	getBooleanOption(String name) Return the value of the environment entry corresponding to the named option.
String	getStringOption(String name) Return the value of the environment entry corresponding to the named option.
boolean	hasOption(String name) Is there an environment entry corresponding to the named option?
private String	optionToEnv(String name) Convert an option name (e.g., "host") to an environment variable name (e.g., AS_ADMIN_HOST).
String	put(String name, String value) Set the named environment entry to the specified value.
String	putOption(String name, String value) Set the environment entry corresponding to the named option to the specified value.
void	remove(String name) Remove the name environment entry.

Methods inherited from class java.lang.Object

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

Field Detail

AS_ADMIN_ENV_PREFIX

public static final String AS_ADMIN_ENV_PREFIX

See Also:

Constant Field Values

env

private Map<String,String> env

Constructor Detail

Environment

public Environment()

Initialize the enviroment with all relevant system environment entries.

Environment

public Environment(boolean ignoreEnvironment)

Constructor that ignores the system environment, mostly used to enable repeatable tests.

Method Detail

getBooleanOption

public boolean getBooleanOption(String name)

Return the value of the environment entry corresponding to the named option.

Parameters:

name - the option name

Returns:

the value of the corresponding environment entry

getStringOption

public String getStringOption(String name)

Return the value of the environment entry corresponding to the named option.

Parameters:

name - the option name

Returns:

the value of the corresponding environment entry

hasOption

public boolean hasOption(String name)

Is there an environment entry corresponding to the named option?

Parameters:

name - the option name

Returns:

true if there's a corresponding environment entry

get

public String get(String name)

Get the named environment entry.

Parameters:

name - the name of the environment entry

Returns:

the value of the entry, or null if no such entry

put

public String put(String name,
                  String value)

Set the named environment entry to the specified value.

Parameters:

name - the environment entry name

value - the value

Returns:

the previous value of the entry

remove

public void remove(String name)

Remove the name environment entry.

Parameters:

name - the environment entry name

putOption

public String putOption(String name,
                        String value)

Set the environment entry corresponding to the named option to the specified value.

Parameters:

name - the option name

value - the value

Returns:

the previous value of the entry

entrySet

public Set<Map.Entry<String,String>> entrySet()

Return a set of all the entries, just like a Map does.

optionToEnv

private String optionToEnv(String name)

Convert an option name (e.g., "host") to an environment variable name (e.g., AS_ADMIN_HOST).

Parameters:

name - the option name

Returns:

the environment variable name