mazz.i18n.commons
Class CommonsLogMsg

java.lang.Object
  mazz.i18n.commons.CommonsLogMsg

public class CommonsLogMsg
extends java.lang.Object

This class provides alot of static methods to assist in logging localized messages via a commons 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(Log, 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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.commons.logging.Log 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