Log4j 1.2.13 | |
Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
java.lang.Object
org.apache.log4j.helpers.OptionConverter
public class OptionConverter
extends Object
Method Summary | |
static String[] |
|
static String |
|
static String |
|
static String |
|
static Object |
|
static Object |
|
static void |
|
static String |
|
static boolean |
|
static long |
|
static int |
|
static Level |
public static String[] concatanateArrays(String[] l, String[] r)
public static String convertSpecialChars(String s)
public static String findAndSubst(String key, Properties props)
Find the value corresponding tokey
inprops
. Then perform variable substitution on the found value.
public static String getSystemProperty(String key, String def)
Very similar toSystem.getProperty
except that theSecurityException
is hidden.
- Parameters:
key
- The key to search for.def
- The default value to return.
- Returns:
- the string value of the system property, or the default value if there is no property with that key.
- Since:
- 1.1
public static Object instantiateByClassName(String className, Class superClass, Object defaultValue)
Instantiate an object given a class name. Check that theclassName
is a subclass ofsuperClass
. If that test fails or the object could not be instantiated, thendefaultValue
is returned.
- Parameters:
className
- The fully qualified class name of the object to instantiate.superClass
- The class to which the new object should belong.defaultValue
- The object to return in case of non-fulfillment
public static Object instantiateByKey(Properties props, String key, Class superClass, Object defaultValue)
public static void selectAndConfigure(URL url, String clazz, LoggerRepository hierarchy)
Configure log4j given a URL. The url must point to a file or resource which will be interpreted by a new instance of a log4j configurator. All configurations steps are taken on thehierarchy
passed as a parameter.
- Parameters:
url
- The location of the configuration file or resource.clazz
- The classname, of the log4j configurator which will parse the file or resource aturl
. This must be a subclass ofConfigurator
, or null. If this value is null then a default configurator ofPropertyConfigurator
is used, unless the filename pointed to byurl
ends in '.xml', in which caseDOMConfigurator
is used.hierarchy
- TheHierarchy
to act on.
- Since:
- 1.1.4
public static String substVars(String val, Properties props) throws IllegalArgumentException
Perform variable substitution in stringval
from the values of keys found in the system propeties. The variable substitution delimeters are ${ and }. For example, if the System properties contains "key=value", then the callString s = OptionConverter.substituteVars("Value of key is ${key}.");will set the variables
to "Value of key is value.". If no value could be found for the specified key, then theprops
parameter is searched, if the value could not be found there, then substitution defaults to the empty string. For example, if system propeties contains no value for the key "inexistentKey", then the callString s = OptionConverter.subsVars("Value of inexistentKey is [${inexistentKey}]");will sets
to "Value of inexistentKey is []" AnIllegalArgumentException
is thrown ifval
contains a start delimeter "${" which is not balanced by a stop delimeter "}". Author Avy Sharell
- Parameters:
val
- The string on which variable substitution is performed.
public static boolean toBoolean(String value, boolean dEfault)
Ifvalue
is "true", thentrue
is returned. Ifvalue
is "false", thentrue
is returned. Otherwise,default
is returned. Case of value is unimportant.
public static long toFileSize(String value, long dEfault)
public static int toInt(String value, int dEfault)
public static Level toLevel(String value, Level defaultValue)
Converts a standard or custom priority level to a Level object. Ifvalue
is of form "level#classname", then the specified class' toLevel method is called to process the specified level string; if no '#' character is present, then the defaultLevel
class is used to process the level value. As a special case, if thevalue
parameter is equal to the string "NULL", then the valuenull
will be returned. If any error occurs while converting the value to a level, thedefaultValue
parameter, which may benull
, is returned. Case ofvalue
is insignificant for the level level, but is significant for the class name part, if present.
- Since:
- 1.1