public class OptionConverter extends Object
Modifier and Type | Method and Description |
---|---|
static String[] |
concatanateArrays(String[] l,
String[] r)
Combines two arrays.
|
static String |
convertSpecialChars(String s)
Escapes special characters.
|
static String |
findAndSubst(String key,
Properties props)
Find the value corresponding to
key in props . |
static String |
getSystemProperty(String key,
String def)
Very similar to
System.getProperty except that the SecurityException is
hidden. |
static <T> T |
instantiateByClassName(String className,
T defaultValue)
Instantiate an object given a class name.
|
static <T> T |
instantiateByKey(Properties props,
String key,
T defaultValue)
Creates an object for the className value of the key.
|
static String |
substVars(String val,
Properties props)
Perform variable substitution in string
val from the values of keys found in the
system properties. |
static boolean |
toBoolean(String value,
boolean defaultValue)
If
value is "true", then true is returned. |
static long |
toFileSize(String value,
long defaultValue) |
static int |
toInt(String value,
int defaultValue)
Converts to int.
|
public static String[] concatanateArrays(String[] l, String[] r)
l
- r
- public static String convertSpecialChars(String s)
s
- public static String getSystemProperty(String key, String def)
System.getProperty
except that the SecurityException
is
hidden.key
- The key to search for.def
- The default value to return.public static <T> T instantiateByKey(Properties props, String key, T defaultValue)
props
- key
- defaultValue
- public static boolean toBoolean(String value, boolean defaultValue)
value
is "true", then true
is returned. If value
is
"false", then true
is returned. Otherwise, default
is returned.
Case of value is unimportant.value
- defaultValue
- public static int toInt(String value, int defaultValue)
value
- defaultValue
- public static long toFileSize(String value, long defaultValue)
value
- defaultValue
- public static String findAndSubst(String key, Properties props)
key
in props
. Then perform variable
substitution on the found value.key
- props
- public static <T> T instantiateByClassName(String className, T defaultValue)
className
is a subclass
of superClass
. If that test fails or the object could not be instantiated, then
defaultValue
is returned.className
- The fully qualified class name of the object to instantiate.defaultValue
- The object to return in case of non-fulfillmentpublic static String substVars(String val, Properties props) throws IllegalArgumentException
val
from the values of keys found in the
system properties.
The variable substitution delimiters are ${ and } .
For example, if the System properties contains "key=value", then the call
String s = OptionConverter.substituteVars( "Value of key is ${key}." );will set the variable
s
to "Value of key is value.".
If no value could be found for the specified key, then the props
parameter is
searched, if the value could not be found there, then substitution defaults to the empty
string.
For example, if system properties contains no value for the key "inexistentKey", then the call
String s = OptionConverter.subsVars( "Value of inexistentKey is [${inexistentKey}]" );will set
s
to "Value of inexistentKey is []"
An IllegalArgumentException
is thrown if val
contains a start
delimiter "${" which is not balanced by a stop delimiter "}".
Author Avy Sharell
val
- The string on which variable substitution is performed.props
- IllegalArgumentException
- if val
is malformed.Copyright © 2002–2018 The Apache Software Foundation. All rights reserved.