java.lang.Object | |
↳ | org.apache.log4j.helpers.OptionConverter |
A convenience class to convert property values to specific types.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Find the value corresponding to
key in
props . | |||||||||||
Very similar to
System.getProperty except
that the SecurityException is hidden. | |||||||||||
Instantiate an object given a class name.
| |||||||||||
Configure log4j given a URL.
| |||||||||||
Perform variable substitution in string
val from the
values of keys found in the system propeties. | |||||||||||
If
value is "true", then true is
returned. | |||||||||||
Converts a standard or custom priority level to a Level
object.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Find the value corresponding to key
in
props
. Then perform variable substitution on the
found value.
Very similar to System.getProperty
except
that the SecurityException is hidden.
key | The key to search for. |
---|---|
def | The default value to return. |
Instantiate an object given a class name. Check that the
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. |
---|---|
superClass | The class to which the new object should belong. |
defaultValue | The object to return in case of non-fulfillment |
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 the
hierarchy
passed as a parameter.
url | The location of the configuration file or resource. |
---|---|
clazz | The classname, of the log4j configurator which will parse
the file or resource at url . This must be a subclass of
Configurator , or null. If this value is null then a default
configurator of PropertyConfigurator is used, unless the
filename pointed to by url ends in '.xml', in which case
DOMConfigurator is used. |
hierarchy | The Hierarchy to act on. |
Perform variable substitution in string val
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 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 propeties 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 java.lang.IllegalArgumentException is thrown if
val
contains a start delimeter "${" which is not
balanced by a stop delimeter "}".
Author Avy Sharell
val | The string on which variable substitution is performed. |
---|
IllegalArgumentException | if val is malformed.
|
---|
If value
is "true", then true
is
returned. If value
is "false", then
true
is returned. Otherwise, default
is
returned.
Case of value is unimportant.
Converts a standard or custom priority level to a Level object.
If value
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 default Level
class is used to process the level value.
As a special case, if the value
parameter is
equal to the string "NULL", then the value null
will
be returned.
If any error occurs while converting the value to a level,
the defaultValue
parameter, which may be
null
, is returned.
Case of value
is insignificant for the level level, but is
significant for the class name part, if present.