mazz.i18n.log4j
Class Log4jLogMsg

java.lang.Object
  extended by mazz.i18n.log4j.Log4jLogMsg

public class Log4jLogMsg
extends java.lang.Object

This class provides alot of static methods to assist in logging localized messages via a Log4J logging log object.

There is a method to the madness in the parameter ordering. Anytime you want to specify a localized message, you always specify the base bundle name first, followed by the locale, the bundle key and the variable list of arguments that go with the keyed message (all in that order). Bundle name and locale are both optional. This is consistent with the way localized messages are specified in constructors for LocalizedException and LocalizedRuntimeException. When you need to specify a Throwable with your localized message, it is specified before those parameters. Again, this is consistent both in this class and the localized exception classes (see fatal(org.apache.log4j.Logger, Throwable, Msg.BundleBaseName, Locale, String, Object[]) and LocalizedException.LocalizedException(Throwable, Msg.BundleBaseName, Locale, String, Object[]) as examples).

These static utility methods respect the settings defined by Logger.setDumpStackTraces(boolean) and Logger.setDumpLogKeys(boolean).

Version:
$Revision: 1.1 $
Author:
John Mazzitelli
See Also:
Msg, LocalizedException, LocalizedRuntimeException

Method Summary
static Msg debug(org.apache.log4j.Logger log, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the debug level.
static Msg debug(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the debug level.
static Msg debug(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the debug level.
static Msg debug(org.apache.log4j.Logger log, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the debug level.
static Msg debug(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the debug level.
static Msg debug(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the debug level.
static Msg debug(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the debug level.
static Msg debug(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the debug level.
static Msg error(org.apache.log4j.Logger log, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the error level.
static Msg error(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the error level.
static Msg error(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the error level.
static Msg error(org.apache.log4j.Logger log, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the error level.
static Msg error(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the error level.
static Msg error(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the error level.
static Msg error(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the error level.
static Msg error(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the error level.
static Msg fatal(org.apache.log4j.Logger log, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the fatal level.
static Msg fatal(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the fatal level.
static Msg fatal(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the fatal level.
static Msg fatal(org.apache.log4j.Logger log, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the fatal level.
static Msg fatal(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the fatal level.
static Msg fatal(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the fatal level.
static Msg fatal(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the fatal level.
static Msg fatal(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the fatal level.
static Msg info(org.apache.log4j.Logger log, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the info level.
static Msg info(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the info level.
static Msg info(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the info level.
static Msg info(org.apache.log4j.Logger log, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the info level.
static Msg info(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the info level.
static Msg info(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the info level.
static Msg info(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the info level.
static Msg info(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the info level.
static Msg trace(org.apache.log4j.Logger log, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the trace level.
static Msg trace(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the trace level.
static Msg trace(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the trace level.
static Msg trace(org.apache.log4j.Logger log, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the trace level.
static Msg trace(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the trace level.
static Msg trace(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the trace level.
static Msg trace(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the trace level.
static Msg trace(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the trace level.
static Msg warn(org.apache.log4j.Logger log, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the warn level.
static Msg warn(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the warn level.
static Msg warn(org.apache.log4j.Logger log, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the warn level.
static Msg warn(org.apache.log4j.Logger log, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the warn level.
static Msg warn(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the warn level.
static Msg warn(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.util.Locale locale, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the warn level.
static Msg warn(org.apache.log4j.Logger log, java.lang.Throwable throwable, Msg.BundleBaseName basename, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the warn level.
static Msg warn(org.apache.log4j.Logger log, java.lang.Throwable throwable, java.lang.String key, java.lang.Object... varargs)
          Logs the given message to the log at the warn level.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

fatal

public static Msg fatal(org.apache.log4j.Logger log,
                        Msg.BundleBaseName basename,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the fatal level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned
See Also:
Msg.createMsg(mazz.i18n.Msg.BundleBaseName, Locale, String, Object[])

fatal

public static Msg fatal(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        Msg.BundleBaseName basename,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the fatal level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned
See Also:
Msg.createMsg(mazz.i18n.Msg.BundleBaseName, Locale, String, Object[])

fatal

public static Msg fatal(org.apache.log4j.Logger log,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the fatal level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

fatal

public static Msg fatal(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the fatal level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

fatal

public static Msg fatal(org.apache.log4j.Logger log,
                        Msg.BundleBaseName basename,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the fatal level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

fatal

public static Msg fatal(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        Msg.BundleBaseName basename,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the fatal level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

fatal

public static Msg fatal(org.apache.log4j.Logger log,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the fatal level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

fatal

public static Msg fatal(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the fatal level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

error

public static Msg error(org.apache.log4j.Logger log,
                        Msg.BundleBaseName basename,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the error level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

error

public static Msg error(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        Msg.BundleBaseName basename,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the error level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

error

public static Msg error(org.apache.log4j.Logger log,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the error level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

error

public static Msg error(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the error level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

error

public static Msg error(org.apache.log4j.Logger log,
                        Msg.BundleBaseName basename,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the error level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

error

public static Msg error(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        Msg.BundleBaseName basename,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the error level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

error

public static Msg error(org.apache.log4j.Logger log,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the error level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

error

public static Msg error(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the error level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

warn

public static Msg warn(org.apache.log4j.Logger log,
                       Msg.BundleBaseName basename,
                       java.util.Locale locale,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the warn level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

warn

public static Msg warn(org.apache.log4j.Logger log,
                       java.lang.Throwable throwable,
                       Msg.BundleBaseName basename,
                       java.util.Locale locale,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the warn level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

warn

public static Msg warn(org.apache.log4j.Logger log,
                       java.util.Locale locale,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the warn level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

warn

public static Msg warn(org.apache.log4j.Logger log,
                       java.lang.Throwable throwable,
                       java.util.Locale locale,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the warn level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

warn

public static Msg warn(org.apache.log4j.Logger log,
                       Msg.BundleBaseName basename,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the warn level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

warn

public static Msg warn(org.apache.log4j.Logger log,
                       java.lang.Throwable throwable,
                       Msg.BundleBaseName basename,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the warn level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

warn

public static Msg warn(org.apache.log4j.Logger log,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the warn level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

warn

public static Msg warn(org.apache.log4j.Logger log,
                       java.lang.Throwable throwable,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the warn level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

info

public static Msg info(org.apache.log4j.Logger log,
                       Msg.BundleBaseName basename,
                       java.util.Locale locale,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the info level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

info

public static Msg info(org.apache.log4j.Logger log,
                       java.lang.Throwable throwable,
                       Msg.BundleBaseName basename,
                       java.util.Locale locale,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the info level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

info

public static Msg info(org.apache.log4j.Logger log,
                       java.util.Locale locale,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the info level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

info

public static Msg info(org.apache.log4j.Logger log,
                       java.lang.Throwable throwable,
                       java.util.Locale locale,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the info level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

info

public static Msg info(org.apache.log4j.Logger log,
                       Msg.BundleBaseName basename,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the info level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

info

public static Msg info(org.apache.log4j.Logger log,
                       java.lang.Throwable throwable,
                       Msg.BundleBaseName basename,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the info level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

info

public static Msg info(org.apache.log4j.Logger log,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the info level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

info

public static Msg info(org.apache.log4j.Logger log,
                       java.lang.Throwable throwable,
                       java.lang.String key,
                       java.lang.Object... varargs)
Logs the given message to the log at the info level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

debug

public static Msg debug(org.apache.log4j.Logger log,
                        Msg.BundleBaseName basename,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the debug level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

debug

public static Msg debug(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        Msg.BundleBaseName basename,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the debug level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

debug

public static Msg debug(org.apache.log4j.Logger log,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the debug level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

debug

public static Msg debug(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the debug level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

debug

public static Msg debug(org.apache.log4j.Logger log,
                        Msg.BundleBaseName basename,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the debug level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

debug

public static Msg debug(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        Msg.BundleBaseName basename,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the debug level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

debug

public static Msg debug(org.apache.log4j.Logger log,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the debug level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

debug

public static Msg debug(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the debug level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

trace

public static Msg trace(org.apache.log4j.Logger log,
                        Msg.BundleBaseName basename,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the trace level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

trace

public static Msg trace(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        Msg.BundleBaseName basename,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the trace level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

trace

public static Msg trace(org.apache.log4j.Logger log,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the trace level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

trace

public static Msg trace(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        java.util.Locale locale,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the trace level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
locale - the locale to determine what bundle to use
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

trace

public static Msg trace(org.apache.log4j.Logger log,
                        Msg.BundleBaseName basename,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the trace level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

trace

public static Msg trace(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        Msg.BundleBaseName basename,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the trace level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
basename - the base name of the resource bundle
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

trace

public static Msg trace(org.apache.log4j.Logger log,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the trace level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

Parameters:
log - the log where the messages will go
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned

trace

public static Msg trace(org.apache.log4j.Logger log,
                        java.lang.Throwable throwable,
                        java.lang.String key,
                        java.lang.Object... varargs)
Logs the given message to the log at the trace level. If the log level is not enabled, this method does nothing and returns null. If a message was logged, its Msg will be returned.

The given Throwable will be passed to the logger so its stack can be dumped when appropriate.

Parameters:
log - the log where the messages will go
throwable - the throwable associated with the log message
key - the resource bundle key name
varargs - arguments to help fill in the resource bundle message
Returns:
if the message was logged, a non-null Msg object is returned


Copyright © 2006 John J. Mazzitelli All Rights Reserved. Licensed under LGPL