com.sun.mail.util

Class MailLogger

java.lang.Object

com.sun.mail.util.MailLogger

public final class MailLogger
extends java.lang.Object

A simplified logger used by JavaMail to handle logging to a PrintStream and logging through a java.util.logging.Logger. If debug is set, messages are written to the PrintStream and prefixed by the specified prefix (which is not included in Logger messages). Messages are logged by the Logger based on the configuration of the logging system.

Constructor Summary

Constructors

Constructor and Description
MailLogger(java.lang.Class clazz, java.lang.String prefix, boolean debug, java.io.PrintStream out) Construct a new MailLogger using the specified class' package name as the Logger name, debug prefix (e.g., "DEBUG"), debug flag, and PrintStream.
MailLogger(java.lang.Class clazz, java.lang.String prefix, Session session) Construct a new MailLogger using the specified class' package name as the Logger name and the specified debug prefix (e.g., "DEBUG").
MailLogger(java.lang.Class clazz, java.lang.String subname, java.lang.String prefix, boolean debug, java.io.PrintStream out) Construct a new MailLogger using the specified class' package name combined with the specified subname as the Logger name, debug prefix (e.g., "DEBUG"), debug flag, and PrintStream.
MailLogger(java.lang.String name, java.lang.String prefix, boolean debug, java.io.PrintStream out) Construct a new MailLogger using the specified Logger name, debug prefix (e.g., "DEBUG"), debug flag, and PrintStream.
MailLogger(java.lang.String name, java.lang.String prefix, Session session) Construct a new MailLogger using the specified Logger name and debug prefix (e.g., "DEBUG").

Method Summary

Modifier and Type	Method and Description
void	config(java.lang.String msg) Log a message at the CONFIG level.
void	fine(java.lang.String msg) Log a message at the FINE level.
void	finer(java.lang.String msg) Log a message at the FINER level.
void	finest(java.lang.String msg) Log a message at the FINEST level.
MailLogger	getLogger(java.lang.Class clazz, java.lang.String prefix) Create a MailLogger using the specified class' package name as the Logger name and the specified prefix.
MailLogger	getLogger(java.lang.String name, java.lang.String prefix) Create a MailLogger that uses a Logger with the specified name and prefix.
MailLogger	getSubLogger(java.lang.String subname, java.lang.String prefix) Create a MailLogger that uses a Logger whose name is composed of this MailLogger's name plus the specified sub-name, separated by a dot.
MailLogger	getSubLogger(java.lang.String subname, java.lang.String prefix, boolean debug) Create a MailLogger that uses a Logger whose name is composed of this MailLogger's name plus the specified sub-name, separated by a dot.
boolean	isLoggable(java.util.logging.Level level) If "debug" is set, or our embedded Logger is loggable at the given level, return true.
void	log(java.util.logging.Level level, java.lang.String msg) Log the message at the specified level.
void	log(java.util.logging.Level level, java.lang.String msg, java.lang.Object param1) Log the message at the specified level.
void	log(java.util.logging.Level level, java.lang.String msg, java.lang.Object[] params) Log the message at the specified level.
void	log(java.util.logging.Level level, java.lang.String msg, java.lang.Throwable thrown) Log the message at the specified level.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MailLogger

public MailLogger(java.lang.String name,
                  java.lang.String prefix,
                  boolean debug,
                  java.io.PrintStream out)

Construct a new MailLogger using the specified Logger name, debug prefix (e.g., "DEBUG"), debug flag, and PrintStream.

Parameters:

name - the Logger name

prefix - the prefix for debug output, or null for none

debug - if true, write to PrintStream

out - the PrintStream to write to

MailLogger

public MailLogger(java.lang.Class clazz,
                  java.lang.String prefix,
                  boolean debug,
                  java.io.PrintStream out)

Construct a new MailLogger using the specified class' package name as the Logger name, debug prefix (e.g., "DEBUG"), debug flag, and PrintStream.

Parameters:

clazz - the Logger name is the package name of this class

prefix - the prefix for debug output, or null for none

debug - if true, write to PrintStream

out - the PrintStream to write to

MailLogger

public MailLogger(java.lang.Class clazz,
                  java.lang.String subname,
                  java.lang.String prefix,
                  boolean debug,
                  java.io.PrintStream out)

Construct a new MailLogger using the specified class' package name combined with the specified subname as the Logger name, debug prefix (e.g., "DEBUG"), debug flag, and PrintStream.

Parameters:

clazz - the Logger name is the package name of this class

subname - the Logger name relative to this Logger name

prefix - the prefix for debug output, or null for none

debug - if true, write to PrintStream

out - the PrintStream to write to

MailLogger

public MailLogger(java.lang.String name,
                  java.lang.String prefix,
                  Session session)

Construct a new MailLogger using the specified Logger name and debug prefix (e.g., "DEBUG"). Get the debug flag and PrintStream from the Session.

Parameters:

name - the Logger name

prefix - the prefix for debug output, or null for none

session - where to get the debug flag and PrintStream

MailLogger

public MailLogger(java.lang.Class clazz,
                  java.lang.String prefix,
                  Session session)

Construct a new MailLogger using the specified class' package name as the Logger name and the specified debug prefix (e.g., "DEBUG"). Get the debug flag and PrintStream from the Session.

Parameters:

clazz - the Logger name is the package name of this class

prefix - the prefix for debug output, or null for none

session - where to get the debug flag and PrintStream

Method Detail

getLogger

public MailLogger getLogger(java.lang.String name,
                            java.lang.String prefix)

Create a MailLogger that uses a Logger with the specified name and prefix. The new MailLogger uses the same debug flag and PrintStream as this MailLogger.

Parameters:

name - the Logger name

prefix - the prefix for debug output, or null for none

getLogger

public MailLogger getLogger(java.lang.Class clazz,
                            java.lang.String prefix)

Create a MailLogger using the specified class' package name as the Logger name and the specified prefix. The new MailLogger uses the same debug flag and PrintStream as this MailLogger.

Parameters:

clazz - the Logger name is the package name of this class

prefix - the prefix for debug output, or null for none

getSubLogger

public MailLogger getSubLogger(java.lang.String subname,
                               java.lang.String prefix)

Create a MailLogger that uses a Logger whose name is composed of this MailLogger's name plus the specified sub-name, separated by a dot. The new MailLogger uses the new prefix for debug output. This is used primarily by the protocol trace code that wants a different prefix (none).

Parameters:

subname - the Logger name relative to this Logger name

prefix - the prefix for debug output, or null for none

getSubLogger

public MailLogger getSubLogger(java.lang.String subname,
                               java.lang.String prefix,
                               boolean debug)

Create a MailLogger that uses a Logger whose name is composed of this MailLogger's name plus the specified sub-name, separated by a dot. The new MailLogger uses the new prefix for debug output. This is used primarily by the protocol trace code that wants a different prefix (none).

Parameters:

subname - the Logger name relative to this Logger name

prefix - the prefix for debug output, or null for none

debug - the debug flag for the sub-logger

log

public void log(java.util.logging.Level level,
                java.lang.String msg)

Log the message at the specified level.

log

public void log(java.util.logging.Level level,
                java.lang.String msg,
                java.lang.Object param1)

Log the message at the specified level.

log

public void log(java.util.logging.Level level,
                java.lang.String msg,
                java.lang.Object[] params)

Log the message at the specified level.

log

public void log(java.util.logging.Level level,
                java.lang.String msg,
                java.lang.Throwable thrown)

Log the message at the specified level.

config

public void config(java.lang.String msg)

Log a message at the CONFIG level.

fine

public void fine(java.lang.String msg)

Log a message at the FINE level.

finer

public void finer(java.lang.String msg)

Log a message at the FINER level.

finest

public void finest(java.lang.String msg)

Log a message at the FINEST level.

isLoggable

public boolean isLoggable(java.util.logging.Level level)

If "debug" is set, or our embedded Logger is loggable at the given level, return true.