public class EnvironmentConfiguration extends AbstractConfiguration
A Configuration implementation that reads the platform specific environment
variables. On pre java5 JRE it uses Ant Execute task to read the environment.
(in this case ant must be present in classpath). On java >= 5 JRE it uses
java.lang.System#getenv()
and ant is not required.
This configuration implementation is read-only. It allows read access to the defined OS environment variables, but their values cannot be changed.
Usage of this class is easy: After an instance has been created the get
methods provided by the Configuration
interface can be used
for querying environment variables, e.g.:
Configuration envConfig = new EnvironmentConfiguration(); System.out.println("JAVA_HOME=" + envConfig.getString("JAVA_HOME");
org.apache.tools.ant.taskdefs.Execute#getProcEnvironment()
END_TOKEN, EVENT_ADD_PROPERTY, EVENT_CLEAR, EVENT_CLEAR_PROPERTY, EVENT_READ_PROPERTY, EVENT_SET_PROPERTY, START_TOKEN
Constructor and Description |
---|
EnvironmentConfiguration()
Constructor.
|
Modifier and Type | Method and Description |
---|---|
protected void |
addPropertyDirect(String key,
Object value)
Adds a property to this configuration.
|
void |
clear()
Removes all properties from this configuration.
|
void |
clearProperty(String key)
Removes a property from this configuration.
|
boolean |
containsKey(String key)
Check if the configuration contains the specified key.
|
Iterator |
getKeys()
Get the list of the keys contained in the configuration.
|
Object |
getProperty(String key)
Gets a property from the configuration.
|
boolean |
isEmpty()
Check if the configuration is empty.
|
addErrorLogListener, addProperty, append, clearPropertyDirect, copy, createInterpolator, getBigDecimal, getBigDecimal, getBigInteger, getBigInteger, getBoolean, getBoolean, getBoolean, getByte, getByte, getByte, getDefaultListDelimiter, getDelimiter, getDouble, getDouble, getDouble, getFloat, getFloat, getFloat, getInt, getInt, getInteger, getInterpolator, getKeys, getList, getList, getListDelimiter, getLogger, getLong, getLong, getLong, getProperties, getProperties, getShort, getShort, getShort, getString, getString, getStringArray, getSubstitutor, interpolate, interpolate, interpolatedConfiguration, interpolateHelper, isDelimiterParsingDisabled, isThrowExceptionOnMissing, resolveContainerStore, setDefaultListDelimiter, setDelimiter, setDelimiterParsingDisabled, setListDelimiter, setLogger, setProperty, setThrowExceptionOnMissing, subset
addConfigurationListener, addErrorListener, clearConfigurationListeners, clearErrorListeners, clone, createErrorEvent, createEvent, fireError, fireEvent, getConfigurationListeners, getErrorListeners, isDetailEvents, removeConfigurationListener, removeErrorListener, setDetailEvents
protected void addPropertyDirect(String key, Object value)
addPropertyDirect
in class AbstractConfiguration
key
- the key of the property to be addedvalue
- the property valuepublic boolean containsKey(String key)
key
- the key whose presence in this configuration is to be testedtrue
if the configuration contains a value for this
key, false
otherwiseConfiguration.containsKey(java.lang.String)
public Iterator getKeys()
remove()
method is specific to
a concrete implementation. It may remove the corresponding
property from the configuration, but this is not guaranteed. In any case
it is no replacement for calling
Configuration.clearProperty(String)
for this property. So it is
highly recommended to avoid using the iterator's remove()
method.Configuration.getKeys()
public Object getProperty(String key)
Configuration
interface the other get methods (that
return specific data types) will internally make use of this method. On
this level variable substitution is not yet performed. The returned
object is an internal representation of the property value for the passed
in key. It is owned by the Configuration
object. So a caller
should not modify this object. It cannot be guaranteed that this object
will stay constant over time (i.e. further update operations on the
configuration may change its internal state).key
- property to retrieveConfiguration.getProperty(java.lang.String)
public boolean isEmpty()
true
if the configuration contains no property,
false
otherwise.Configuration.isEmpty()
public void clearProperty(String key)
clearProperty
in interface Configuration
clearProperty
in class AbstractConfiguration
key
- the key of the property to be removedpublic void clear()
clear
in interface Configuration
clear
in class AbstractConfiguration
Copyright © 2018 JBoss by Red Hat. All rights reserved.