Nova Ordis Utilities Environment Variable Support: Difference between revisions
| (One intermediate revision by the same user not shown) | |||
| Line 6: | Line 6: | ||
=Overview= | =Overview= | ||
We install a static EnvironmentVariableProvider per class loading domain (JVM), to allow for environment-independent testing. | We install a static EnvironmentVariableProvider per class loading domain (JVM), to allow for environment-independent testing. | ||
=Usage Pattern= | The environment variable support can also be integrated with the [[Nova Ordis Generic Variable and Expression System|generic variable and expression system]] via [https://github.com/NovaOrdis/novaordis-utilities/blob/master/src/main/java/io/novaordis/utilities/expressions/env/OSProcessScope.java OSProcessScope]. | ||
=Simple Usage Pattern= | |||
<syntaxhighlight lang='java'> | <syntaxhighlight lang='java'> | ||
| Line 32: | Line 34: | ||
This will cleared the cache instance. | This will cleared the cache instance. | ||
=Variable-based Usage Pattern= | |||
<font color=red>TODO</font> | |||
Latest revision as of 19:14, 18 September 2017
Internal
Overview
We install a static EnvironmentVariableProvider per class loading domain (JVM), to allow for environment-independent testing.
The environment variable support can also be integrated with the generic variable and expression system via OSProcessScope.
Simple Usage Pattern
...
EnvironmentVariableProvider p = EnvironmentVariableProvider.getInstance();
String value = p.getenv("RUNTIME_DIR");
...
getInstance() invocation creates and caches a provider. The default implementation, in absence of any special configuration, is SystemEnvironmentVariableProvider, which delegates to:
System.getenv(name);
If "env.variable.provider.class.name" system property (the exact string is defined by EnvironmentVariableProvider.ENVIRONMENT_VARIABLE_PROVIDER_CLASS_NAME_SYSTEM_PROPERTY) is defined and contains a fully qualified valid class name that implements EnvironmentVariableProvider, it will be instantiated, cached and used. getInstance() will throw anIllegalStateException if failure to instantiate the custom class is encountered.
To reset the mechanism, use:
EnvironmentVariableProvider.reset();
This will cleared the cache instance.
Variable-based Usage Pattern
TODO