com.arjuna.common.util.logging
Interface Logi18n


public interface Logi18n

Internationalised logging interface abstracting the various logging APIs supported by Arjuna CLF.

The five logging levels used by Log are (in order):

  1. debug (the least serious
  2. info
  3. warn
  4. error
  5. fatal (the most serious)
The mapping of these log levels to the concepts used by the underlying logging system is implementation dependent. The implemention should ensure, though, that this ordering behaves as expected.

Performance is often a logging concern. By examining the appropriate property, a component can avoid expensive operations (producing information to be logged).

For example,

    if (log.isDebugEnabled()) {
        ... do something expensive ...
        log.debug(theResult);
    }
 

Configuration of the underlying logging system will generally be done external to the Logging APIs, through whatever mechanism is supported by that system.

Since:
clf-2.0
Version:
$Revision: 2342 $ $Date: 2006-03-30 14:06:17 +0100 (Thu, 30 Mar 2006) $
Author:
Thomas Rischbeck

Method Summary
 void addResourceBundle(java.lang.String bundleName)
          Add the given resource bundle to this logger.
 void debug(long dl, long vl, long fl, java.lang.String key)
          Log a message with the DEBUG Level and with finer granularity.
 void debug(long dl, long vl, long fl, java.lang.String key, java.lang.Object[] params)
          Log a message with the DEBUG Level and with finer granularity and with arguments.
 void debug(long dl, long vl, long fl, java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Log a message with the DEBUG Level and with finer granularity, arguments and throwable message.
 void debug(long dl, long vl, long fl, java.lang.String key, java.lang.Throwable throwable)
          Log a message with the DEBUG Level and with finer granularity and throwable message.
 void debug(java.lang.String key)
          Log a message with DEBUG Level
 void debug(java.lang.String key, java.lang.Object[] params)
          Log a message with DEBUG Level and with arguments
 void debug(java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Log a message with DEBUG Level, with arguments and with a throwable arguments
 void debug(java.lang.String key, java.lang.Throwable throwable)
          Log a message with the DEBUG Level and with a throwable arguments
 boolean debugAllowed()
          Is it allowed to print finer debugging statements? This method returns true when the following is set: finer debug level = DebugLevel.FULL_DEBUGGING. visibility level = VisibilityLevel.VIS_ALL. facility code = FacilityCode.FAC_ALL.
 boolean debugAllowed(long dLevel)
          Is it allowed to print finer debugging statements with a given debug level? This method assumes that: visibility level = VisibilityLevel.VIS_ALL. facility code = FacilityCode.FAC_ALL.
 boolean debugAllowed(long dLevel, long vLevel)
          Is it allowed to print debugging statements? This method assumes
 boolean debugAllowed(long dLevel, long vLevel, long fLevel)
          Is it allowed to print finer debugging statements with a given debug level, visibility level and facility code level?
 void debugb(java.lang.String baseName, java.lang.String key)
          Deprecated.  
 void debugb(java.lang.String baseName, java.lang.String key, java.lang.Object[] params)
          Deprecated.  
 void debugb(java.lang.String baseName, java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Deprecated.  
 void debugb(java.lang.String baseName, java.lang.String key, java.lang.Throwable throwable)
          Deprecated.  
 void error(java.lang.String key)
          Log a message with the ERROR Level
 void error(java.lang.String key, java.lang.Object[] params)
          Log a message with the ERROR Level and with arguments
 void error(java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Log a message with the ERROR Level, with arguments and with a throwable arguments
 void error(java.lang.String key, java.lang.Throwable throwable)
          Log a message with the ERROR Level and with a throwable arguments
 void errorb(java.lang.String baseName, java.lang.String key)
          Deprecated.  
 void errorb(java.lang.String baseName, java.lang.String key, java.lang.Object[] params)
          Deprecated.  
 void errorb(java.lang.String baseName, java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Deprecated.  
 void errorb(java.lang.String baseName, java.lang.String key, java.lang.Throwable throwable)
          Deprecated.  
 void fatal(java.lang.String key)
          Log a message with the FATAL Level
 void fatal(java.lang.String key, java.lang.Object[] params)
          Log a message with the FATAL Level and with arguments
 void fatal(java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Log a message with the FATAL Level, with arguments and with a throwable arguments
 void fatal(java.lang.String key, java.lang.Throwable throwable)
          Log a message with the FATAL Level and with a throwable arguments
 void fatalb(java.lang.String baseName, java.lang.String key)
          Deprecated.  
 void fatalb(java.lang.String baseName, java.lang.String key, java.lang.Object[] params)
          Deprecated.  
 void fatalb(java.lang.String baseName, java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Deprecated.  
 void fatalb(java.lang.String baseName, java.lang.String key, java.lang.Throwable throwable)
          Deprecated.  
 long getDebugLevel()
          Return the finer debug level.
 long getFacilityCode()
          Return the facility code.
 java.lang.String getString(java.lang.String key)
          Obtain a localized message from one of the resource bundles associated with this logger.
 java.lang.String getString(java.lang.String key, java.lang.Object[] params)
          Obtain a localized and parameterized message from one of the resource bundles associated with this logger.
 java.lang.String getString(java.lang.String base, java.lang.String key)
          Obtain a localized message from one of the resource bundles associated with this logger.
 java.lang.String getString(java.lang.String base, java.lang.String key, java.lang.Object[] params)
          Obtain a localized and parameterized message from the given resource bundle.
 long getVisibilityLevel()
          Return the visibility level.
 void info(java.lang.String key)
          Log a message with INFO Level
 void info(java.lang.String key, java.lang.Object[] params)
          Log a message with the INFO Level and with arguments
 void info(java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Log a message with the INFO Level, with arguments and with a throwable arguments
 void info(java.lang.String key, java.lang.Throwable throwable)
          Log a message with the INFO Level and with a throwable arguments
 void infob(java.lang.String baseName, java.lang.String key)
          Deprecated.  
 void infob(java.lang.String baseName, java.lang.String key, java.lang.Object[] params)
          Deprecated.  
 void infob(java.lang.String baseName, java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Deprecated.  
 void infob(java.lang.String baseName, java.lang.String key, java.lang.Throwable throwable)
          Deprecated.  
 boolean isDebugEnabled()
          Determine if this logger is enabled for DEBUG messages.
 boolean isErrorEnabled()
          Determine if this logger is enabled for ERROR messages.
 boolean isFatalEnabled()
          Determine if this logger is enabled for FATAL messages.
 boolean isInfoEnabled()
          Determine if this logger is enabled for INFO messages.
 boolean isWarnEnabled()
          Determine if this logger is enabled for WARN messages.
 void mergeDebugLevel(long level)
          Merge the debug level provided with that currently used by the controller.
 void mergeFacilityCode(long level)
          Merge the debug level provided with that currently used by the Logger.
 void mergeVisibilityLevel(long level)
          Merge the visibility level provided with that currently used by the Logger.
 void setDebugLevel(long level)
          Set the debug level as available in the DebugLevel.
 void setFacilityCode(long level)
          Set the facility code.
 void setLevels(long dl, long vl, long fl)
          Set the debug level, the visibility level, and the facility code.
 void setResourceBundleName(java.lang.String BaseName)
          Set the name of the resource bundle name that the logger will use to retreive national text
 void setVisibilityLevel(long level)
          Set the visibility level.
 void warn(java.lang.String key)
          Log a message with the WARN Level
 void warn(java.lang.String key, java.lang.Object[] params)
          Log a message with the WARN Level and with arguments
 void warn(java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Log a message with the WARN Level, with arguments and with a throwable arguments
 void warn(java.lang.String key, java.lang.Throwable throwable)
          Log a message with the WARN Level and with a throwable arguments
 void warnb(java.lang.String baseName, java.lang.String key)
          Deprecated.  
 void warnb(java.lang.String baseName, java.lang.String key, java.lang.Object[] params)
          Deprecated.  
 void warnb(java.lang.String baseName, java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
          Deprecated.  
 void warnb(java.lang.String baseName, java.lang.String key, java.lang.Throwable throwable)
          Deprecated.  
 

Method Detail

addResourceBundle

void addResourceBundle(java.lang.String bundleName)
Add the given resource bundle to this logger.

Parameters:
bundleName - The name of the resource bundle.

isDebugEnabled

boolean isDebugEnabled()
Determine if this logger is enabled for DEBUG messages.

Returns:
True if the logger is enabled for DEBUG, false otherwise

isInfoEnabled

boolean isInfoEnabled()
Determine if this logger is enabled for INFO messages.

Returns:
True if the logger is enabled for INFO, false otherwise

isWarnEnabled

boolean isWarnEnabled()
Determine if this logger is enabled for WARN messages.

Returns:
True if the logger is enabled for WARN, false otherwise

isErrorEnabled

boolean isErrorEnabled()
Determine if this logger is enabled for ERROR messages.

Returns:
True if the logger is enabled for ERROR, false otherwise

isFatalEnabled

boolean isFatalEnabled()
Determine if this logger is enabled for FATAL messages.

Returns:
True if the logger is enabled for FATAL, false otherwise

debug

void debug(java.lang.String key)
Log a message with DEBUG Level

Parameters:
key - resource bundle key for the message to log

debug

void debug(java.lang.String key,
           java.lang.Throwable throwable)
Log a message with the DEBUG Level and with a throwable arguments

Parameters:
key - resource bundle key for the message to log
throwable - The Throwable to log

debug

void debug(java.lang.String key,
           java.lang.Object[] params)
Log a message with DEBUG Level and with arguments

Parameters:
key - resource bundle key for the message to log
params - parameters passed to the message

debug

void debug(java.lang.String key,
           java.lang.Object[] params,
           java.lang.Throwable throwable)
Log a message with DEBUG Level, with arguments and with a throwable arguments

Parameters:
key - resource bundle key for the message to log
params - parameters passed to the message
throwable - The Throwable to log

info

void info(java.lang.String key)
Log a message with INFO Level

Parameters:
key - resource bundle key for the message to log

info

void info(java.lang.String key,
          java.lang.Throwable throwable)
Log a message with the INFO Level and with a throwable arguments

Parameters:
key - resource bundle key for the message to log
throwable - Throwable associated to the logging message

info

void info(java.lang.String key,
          java.lang.Object[] params)
Log a message with the INFO Level and with arguments

Parameters:
key - resource bundle key for the message to log
params - parameters passed to the message

info

void info(java.lang.String key,
          java.lang.Object[] params,
          java.lang.Throwable throwable)
Log a message with the INFO Level, with arguments and with a throwable arguments

Parameters:
key - resource bundle key for the message to log
params - parameters passed to the message
throwable - Throwable associated with the logging request

warn

void warn(java.lang.String key)
Log a message with the WARN Level

Parameters:
key - resource bundle key for the message to log

warn

void warn(java.lang.String key,
          java.lang.Throwable throwable)
Log a message with the WARN Level and with a throwable arguments

Parameters:
key - resource bundle key for the message to log
throwable - Throwable associated with the logging request

warn

void warn(java.lang.String key,
          java.lang.Object[] params)
Log a message with the WARN Level and with arguments

Parameters:
key - resource bundle key for the message to log
params - parameters passed to the message

warn

void warn(java.lang.String key,
          java.lang.Object[] params,
          java.lang.Throwable throwable)
Log a message with the WARN Level, with arguments and with a throwable arguments

Parameters:
key - resource bundle key for the message to log
params - parameters passed to the message
throwable - Throwable associated with the logging request

error

void error(java.lang.String key)
Log a message with the ERROR Level

Parameters:
key - resource bundle key for the message to log

error

void error(java.lang.String key,
           java.lang.Throwable throwable)
Log a message with the ERROR Level and with a throwable arguments

Parameters:
key - resource bundle key for the message to log
throwable - Throwable associated with the logging request

error

void error(java.lang.String key,
           java.lang.Object[] params)
Log a message with the ERROR Level and with arguments

Parameters:
key - resource bundle key for the message to log
params - parameters passed to the message

error

void error(java.lang.String key,
           java.lang.Object[] params,
           java.lang.Throwable throwable)
Log a message with the ERROR Level, with arguments and with a throwable arguments

Parameters:
key - resource bundle key for the message to log
params - parameters passed to the message
throwable - Throwable associated with the logging request

fatal

void fatal(java.lang.String key)
Log a message with the FATAL Level

Parameters:
key - resource bundle key for the message to log

fatal

void fatal(java.lang.String key,
           java.lang.Throwable throwable)
Log a message with the FATAL Level and with a throwable arguments

Parameters:
key - resource bundle key for the message to log
throwable - Throwable associated with the logging request

fatal

void fatal(java.lang.String key,
           java.lang.Object[] params)
Log a message with the FATAL Level and with arguments

Parameters:
key - resource bundle key for the message to log
params - parameters passed to the message

fatal

void fatal(java.lang.String key,
           java.lang.Object[] params,
           java.lang.Throwable throwable)
Log a message with the FATAL Level, with arguments and with a throwable arguments

Parameters:
key - resource bundle key for the message to log
params - parameters passed to the message
throwable - Throwable associated with the logging request

setLevels

void setLevels(long dl,
               long vl,
               long fl)
Set the debug level, the visibility level, and the facility code.

Parameters:
dl - The finer debugging value. See DebugLevel for possible values.
vl - The visibility level value. See VisibilityLevel for possible values.
fl - The facility code level value. See FacilityCode for possible values.

getDebugLevel

long getDebugLevel()
Return the finer debug level.

Returns:
The finer debugging level value associated with the logger
See Also:
for possible return values.

setDebugLevel

void setDebugLevel(long level)
Set the debug level as available in the DebugLevel.

Parameters:
level - The finer debugging value
See Also:
for possible values of level.

mergeDebugLevel

void mergeDebugLevel(long level)
Merge the debug level provided with that currently used by the controller.

Parameters:
level - The finer debugging value
See Also:
for possible values of level.

getVisibilityLevel

long getVisibilityLevel()
Return the visibility level.

Returns:
The visibility level value associated with the Logger
See Also:
for possible return values.

setVisibilityLevel

void setVisibilityLevel(long level)
Set the visibility level.

Parameters:
level - The visibility level value
See Also:
for possible values of level.

mergeVisibilityLevel

void mergeVisibilityLevel(long level)
Merge the visibility level provided with that currently used by the Logger.

Parameters:
level - The visibility level value
See Also:
for possible values of level.

getFacilityCode

long getFacilityCode()
Return the facility code.

Returns:
The facility code value associated with the Logger.
See Also:
for possible return values.

setFacilityCode

void setFacilityCode(long level)
Set the facility code.

Parameters:
level - The facility code value
See Also:
for possible values of level.

mergeFacilityCode

void mergeFacilityCode(long level)
Merge the debug level provided with that currently used by the Logger.

Parameters:
level - The visibility level value
See Also:
for possible values of level.

debugAllowed

boolean debugAllowed()
Is it allowed to print finer debugging statements? This method returns true when the following is set:

Returns:
true if the Logger allows full logging

debugAllowed

boolean debugAllowed(long dLevel)
Is it allowed to print finer debugging statements with a given debug level? This method assumes that:

Parameters:
dLevel - The debug finer level to check for.
Returns:
true if the Logger allows logging for the finer debugging value dLevel. i.e., dLevel is either equals or greater than the finer debug level assigned to the Logger.

debugAllowed

boolean debugAllowed(long dLevel,
                     long vLevel)
Is it allowed to print debugging statements? This method assumes
 FacilityCode.FAC_ALL)

Parameters:
dLevel - The debug finer level. Used to ask if the logger object allows logging for this value. The answer is yes if dLevel is either equals or greater the debug level assigned to the logger
vLevel - The visibility level. Used to ask if the logger object allows logging for this value. The answer is yes if vLevel is either equals or greater the visibility level assigned to the logger
Returns:
true if the logger allows logging for the finer debugging values - dLevel and vLevel

debugAllowed

boolean debugAllowed(long dLevel,
                     long vLevel,
                     long fLevel)
Is it allowed to print finer debugging statements with a given debug level, visibility level and facility code level?

Parameters:
dLevel - The debug finer level to check for.
vLevel - The debug visibilty level to check for.
fLevel - The facility code level to check for.
Returns:
true if the Logger allows logging for the finer debugging value dLevel, visibility level vLevel and facility code level fLevel. i.e., dLevel is equal or greater than the finer debug level assigned to the Logger and vLevel is equal or greater than the visiblity level and fLevel is equal or greater then the facility code level.

setResourceBundleName

void setResourceBundleName(java.lang.String BaseName)
Set the name of the resource bundle name that the logger will use to retreive national text

Parameters:
BaseName - The default resource bundle name the logger uses to retreive messages

debugb

void debugb(java.lang.String baseName,
            java.lang.String key)
Deprecated. 

Log a message with the DEBUG Level

Parameters:
baseName - The name of resource bundle to localize message
key - The resource bundle key to retrieve a localised string

debugb

void debugb(java.lang.String baseName,
            java.lang.String key,
            java.lang.Throwable throwable)
Deprecated. 

Log a message with the DEBUG Level and with a throwable arguments

Parameters:
baseName - The name of resource bundle to localize message
key - The resource bundle key to retrieve a localised string
throwable - Throwable associated with the log message

debugb

void debugb(java.lang.String baseName,
            java.lang.String key,
            java.lang.Object[] params)
Deprecated. 

Log a message with the DEBUG Level and with arguments

Parameters:
baseName - The name of resource bundle to localize message
key - The resource bundle key to retrieve a localised string
params - parameters passed to the message

debugb

void debugb(java.lang.String baseName,
            java.lang.String key,
            java.lang.Object[] params,
            java.lang.Throwable throwable)
Deprecated. 

Log a message with the DEBUG Level, with arguments and with a throwable arguments

Parameters:
baseName - The name of resource bundle to localize message
key - The resource bundle key to retrieve a localised string
params - parameters passed to the message
throwable - Throwable associated with the log message

infob

void infob(java.lang.String baseName,
           java.lang.String key)
Deprecated. 

Log a message with the INFO Level

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log

infob

void infob(java.lang.String baseName,
           java.lang.String key,
           java.lang.Throwable throwable)
Deprecated. 

Log a message with the INFO Level and with a throwable arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
throwable - Throwable associated with the log message

infob

void infob(java.lang.String baseName,
           java.lang.String key,
           java.lang.Object[] params)
Deprecated. 

Log a message with the INFO Level and with arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
params - parameters passed to the message

infob

void infob(java.lang.String baseName,
           java.lang.String key,
           java.lang.Object[] params,
           java.lang.Throwable throwable)
Deprecated. 

Log a message with the INFO Level, with arguments and with a throwable arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
params - parameters passed to the message
throwable - Throwable associated with the log message

warnb

void warnb(java.lang.String baseName,
           java.lang.String key)
Deprecated. 

Log a message with the WARN Level

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log

warnb

void warnb(java.lang.String baseName,
           java.lang.String key,
           java.lang.Throwable throwable)
Deprecated. 

Log a message with the WARN Level and with a throwable arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
throwable - Throwable associated with the log message

warnb

void warnb(java.lang.String baseName,
           java.lang.String key,
           java.lang.Object[] params)
Deprecated. 

Log a message with the WARN Level and with arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
params - parameters passed to the message

warnb

void warnb(java.lang.String baseName,
           java.lang.String key,
           java.lang.Object[] params,
           java.lang.Throwable throwable)
Deprecated. 

Log a message with the WARN Level, with arguments and with a throwable arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
params - parameters passed to the message
throwable - Throwable associated with the log message

errorb

void errorb(java.lang.String baseName,
            java.lang.String key)
Deprecated. 

Log a message with the ERROR Level

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log

errorb

void errorb(java.lang.String baseName,
            java.lang.String key,
            java.lang.Throwable throwable)
Deprecated. 

Log a message with the ERROR Level and with a throwable arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
throwable - Throwable associated with the log message

errorb

void errorb(java.lang.String baseName,
            java.lang.String key,
            java.lang.Object[] params)
Deprecated. 

Log a message with the ERROR Level and with arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
params - parameters passed to the message

errorb

void errorb(java.lang.String baseName,
            java.lang.String key,
            java.lang.Object[] params,
            java.lang.Throwable throwable)
Deprecated. 

Log a message with the ERROR Level, with arguments and with a throwable arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
params - parameters passed to the message
throwable - Throwable associated with the log message

fatalb

void fatalb(java.lang.String baseName,
            java.lang.String key)
Deprecated. 

Log a message with the FATAL Level

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log

fatalb

void fatalb(java.lang.String baseName,
            java.lang.String key,
            java.lang.Throwable throwable)
Deprecated. 

Log a message with the FATAL Level and with a throwable arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
throwable - Throwable associated with the log message

fatalb

void fatalb(java.lang.String baseName,
            java.lang.String key,
            java.lang.Object[] params)
Deprecated. 

Log a message with the FATAL Level and with arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
params - parameters passed to the message

fatalb

void fatalb(java.lang.String baseName,
            java.lang.String key,
            java.lang.Object[] params,
            java.lang.Throwable throwable)
Deprecated. 

Log a message with the FATAL Level, with arguments and with a throwable arguments

Parameters:
baseName - The name of resource bundle to localize message
key - resource bundle key for the message to log
params - parameters passed to the message
throwable - Throwable associated with the log message

debug

void debug(long dl,
           long vl,
           long fl,
           java.lang.String key)
Log a message with the DEBUG Level and with finer granularity. The debug message is sent to the output only if the specified debug level, visibility level, and facility code match those allowed by the logger.

Parameters:
dl - The debug finer level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and dl is either equals or greater the debug level assigned to the logger Object
vl - The visibility level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and vl is either equals or greater the visibility level assigned to the logger Object
fl - The facility code level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and fl is either equals or greater the facility code level assigned to the logger Object
key - resource bundle key for the message to log

debug

void debug(long dl,
           long vl,
           long fl,
           java.lang.String key,
           java.lang.Throwable throwable)
Log a message with the DEBUG Level and with finer granularity and throwable message. The debug message is sent to the output only if the specified debug level, visibility level, and facility code match those allowed by the logger.

Parameters:
dl - The debug finer level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and dl is either equals or greater the debug level assigned to the logger Object
vl - The visibility level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and vl is either equals or greater the visibility level assigned to the logger Object
fl - The facility code level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and fl is either equals or greater the facility code level assigned to the logger Object
key - resource bundle key for the message to log
throwable - Throwable associated with the log message

debug

void debug(long dl,
           long vl,
           long fl,
           java.lang.String key,
           java.lang.Object[] params)
Log a message with the DEBUG Level and with finer granularity and with arguments. The debug message is sent to the output only if the specified debug level, visibility level, and facility code match those allowed by the logger.

Parameters:
dl - The debug finer level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and dl is either equals or greater the debug level assigned to the logger Object
vl - The visibility level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and vl is either equals or greater the visibility level assigned to the logger Object
fl - The facility code level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and fl is either equals or greater the facility code level assigned to the logger Object
key - resource bundle key for the message to log
params - parameters passed to the message

debug

void debug(long dl,
           long vl,
           long fl,
           java.lang.String key,
           java.lang.Object[] params,
           java.lang.Throwable throwable)
Log a message with the DEBUG Level and with finer granularity, arguments and throwable message. The debug message is sent to the output only if the specified debug level, visibility level, and facility code match those allowed by the logger.

Parameters:
dl - The debug finer level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and dl is either equals or greater the debug level assigned to the logger Object
vl - The visibility level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and vl is either equals or greater the visibility level assigned to the logger Object
fl - The facility code level associated with the log message. That is, the logger object allows to log only if the DEBUG level is allowed and fl is either equals or greater the facility code level assigned to the logger Object
key - resource bundle key for the message to log
params - parameters passed to the message
throwable - Throwable associated with the log message

getString

java.lang.String getString(java.lang.String key)
Obtain a localized message from one of the resource bundles associated with this logger. The user supplied parameter key is replaced by its localized version from the resource bundle.

Parameters:
key - unique key to identify an entry in the resource bundle.
Returns:
The localised string according to user's locale and available resource bundles. placeholder message if the resource bundle or key cannot be found. //@throws MissingResourceException if the key cannot be found in any of the associated resource bundles.
See Also:
setResourceBundleName(java.lang.String)

getString

java.lang.String getString(java.lang.String key,
                           java.lang.Object[] params)
Obtain a localized and parameterized message from one of the resource bundles associated with this logger. First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using MessageFormat.format(String,Object[]) method with the user supplied object array params.

Parameters:
key - unique key to identify an entry in the resource bundle.
params - parameters to fill placeholders (e.g., {0}, {1}) in the resource bundle string.
Returns:
The localised string according to user's locale and available resource bundles. placeholder message if the resource bundle or key cannot be found. //@throws MissingResourceException if the key cannot be found in any of the associated resource bundles.

getString

java.lang.String getString(java.lang.String base,
                           java.lang.String key)
Obtain a localized message from one of the resource bundles associated with this logger. The user supplied parameter key is replaced by its localized version from the resource bundle base.

Parameters:
base - resource bundle name
key - unique key to identify an entry in the resource bundle.
Returns:
The localised string according to user's locale and available resource bundles. placeholder message if the resource bundle or key cannot be found. //@throws MissingResourceException if the key cannot be found in any of the associated resource bundles.
See Also:
setResourceBundleName(java.lang.String)

getString

java.lang.String getString(java.lang.String base,
                           java.lang.String key,
                           java.lang.Object[] params)
Obtain a localized and parameterized message from the given resource bundle. First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using MessageFormat.format(String,Object[]) method with the user supplied object array params.

Parameters:
base - resource bundle name
key - unique key to identify an entry in the resource bundle.
params - parameters to fill placeholders (e.g., {0}, {1}) in the resource bundle string.
Returns:
The localised string according to user's locale and available resource bundles. placeholder message if the resource bundle or key cannot be found. //@throws MissingResourceException if the key cannot be found in any of the associated resource bundles.