mazz.i18n.log4j
Class Log4jLogMsg

java.lang.Object
  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