com.gemstone.persistence.logging

Class Logger

java.lang.Object

com.gemstone.persistence.logging.Logger

public class Logger
extends Object

A logger is used to record messages and events. Each entry has a given level associated with it. There are a number of convenience methods for logging events. Events with a level above a certain are written to System.err. The default level is LEVEL.INFO

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Logger(String name) Creates a new Logger with the given name

Method Summary

Modifier and Type	Method and Description
void	addHandler(Handler handler) Adds a Handler to receive logging messages
void	config(String msg) Logs a CONFIG message
void	config(String msg, Object[] params) Log a CONFIG message, with an array of object arguments.
void	config(String sourceClass, String sourceMethod, String msg) Log a CONFIG message, specifying source class and method.
void	config(String sourceClass, String sourceMethod, String msg, Object[] params) Log a CONFIG message, specifying source class and method, with an array of object arguments.
void	entering(String sourceClass, String sourceMethod) Log a procedure entry.
void	entering(String sourceClass, String sourceMethod, Object[] params) Log a procedure entry, with parameters.
void	exiting(String sourceClass, String sourceMethod) Log a procedure return.
void	exiting(String sourceClass, String sourceMethod, Object[] params) Log a procedure return, with parameters.
void	fine(String msg) Logs a FINE message
void	fine(String msg, Object[] params) Log a FINE message, with an array of object arguments.
void	fine(String sourceClass, String sourceMethod, String msg) Log a FINE message, specifying source class and method.
void	fine(String sourceClass, String sourceMethod, String msg, Object[] params) Log a FINE message, specifying source class and method, with an array of object arguments.
void	finer(String msg) Logs a FINER message
void	finer(String msg, Object[] params) Log a FINER message, with an array of object arguments.
void	finer(String sourceClass, String sourceMethod, String msg) Log a FINER message, specifying source class and method.
void	finer(String sourceClass, String sourceMethod, String msg, Object[] params) Log a FINER message, specifying source class and method, with an array of object arguments.
void	finest(String msg) Logs a FINEST message
void	finest(String msg, Object[] params) Log a FINEST message, with an array of object arguments.
void	finest(String sourceClass, String sourceMethod, String msg) Log a FINEST message, specifying source class and method.
void	finest(String sourceClass, String sourceMethod, String msg, Object[] params) Log a FINEST message, specifying source class and method, with an array of object arguments.
static String	format(String format, Object[] objs) Formats a message.
Handler[]	getHandlers() Returns the Handlers associated with this logger
Level	getLevel() Returns the log level specifying which messages will be logged by this logger.
static Logger	getLogger(String name) Returns the logger with the given name
void	info(String msg) Logs a INFO message
void	info(String msg, Object[] params) Log a INFO message, with an array of object arguments.
void	info(String sourceClass, String sourceMethod, String msg) Log a INFO message, specifying source class and method.
void	info(String sourceClass, String sourceMethod, String msg, Object[] params) Log a INFO message, specifying source class and method, with an array of object arguments.
boolean	isLoggable(Level msgLevel) Check if a message of the given level would actually be logged by this logger.
void	log(Level msgLevel, String msg) Logs a message
void	log(Level msgLevel, String msg, Object[] params) Log a message, with an array of object arguments.
void	log(Level msgLevel, String sourceClass, String sourceMethod, String msg) Log a message, specifying source class and method.
void	log(Level msgLevel, String sourceClass, String sourceMethod, String msg, Object[] params) Log a message, specifying source class and method, with an array of object arguments.
void	log(Level msgLevel, String sourceClass, String sourceMethod, String msg, Throwable thrown) Log a message, specifying source class and method, with associated Throwable information.
void	log(Level msgLevel, String msg, Throwable thrown) Log a message, with associated Throwable information.
void	log(LogRecord record) Prints the given log record to System.err
void	removeHandler(Handler handler) Removes a Handler from this logger
void	setLevel(Level level) Sets the log level specifying which messages will be logged by this logger.
void	severe(String msg) Logs a SEVERE message
void	severe(String msg, Object[] params) Log a SEVERE message, with an array of object arguments.
void	severe(String sourceClass, String sourceMethod, String msg) Log a SEVERE message, specifying source class and method.
void	severe(String sourceClass, String sourceMethod, String msg, Object[] params) Log a SEVERE message, specifying source class and method, with an array of object arguments.
void	throwing(String sourceClass, String sourceMethod, Throwable thrown) Log throwing an exception.
void	warning(String msg) Logs a WARNING message
void	warning(String msg, Object[] params) Log a WARNING message, with an array of object arguments.
void	warning(String sourceClass, String sourceMethod, String msg) Log a WARNING message, specifying source class and method.
void	warning(String sourceClass, String sourceMethod, String msg, Object[] params) Log a WARNING message, specifying source class and method, with an array of object arguments.

Methods inherited from class java.lang.Object

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

Constructor Detail

Logger

protected Logger(String name)

Creates a new Logger with the given name

Method Detail

getLogger

public static Logger getLogger(String name)

Returns the logger with the given name

addHandler

public void addHandler(Handler handler)

Adds a Handler to receive logging messages

getHandlers

public Handler[] getHandlers()

Returns the Handlers associated with this logger

removeHandler

public void removeHandler(Handler handler)

Removes a Handler from this logger

getLevel

public Level getLevel()

Returns the log level specifying which messages will be logged by this logger.

setLevel

public void setLevel(Level level)

Sets the log level specifying which messages will be logged by this logger.

isLoggable

public boolean isLoggable(Level msgLevel)

Check if a message of the given level would actually be logged by this logger.

log

public void log(LogRecord record)

Prints the given log record to System.err

config

public void config(String msg)

Logs a CONFIG message

config

public void config(String msg,
                   Object[] params)

Log a CONFIG message, with an array of object arguments.

config

public void config(String sourceClass,
                   String sourceMethod,
                   String msg)

Log a CONFIG message, specifying source class and method.

config

public void config(String sourceClass,
                   String sourceMethod,
                   String msg,
                   Object[] params)

Log a CONFIG message, specifying source class and method, with an array of object arguments.

entering

public void entering(String sourceClass,
                     String sourceMethod)

Log a procedure entry.

entering

public void entering(String sourceClass,
                     String sourceMethod,
                     Object[] params)

Log a procedure entry, with parameters.

exiting

public void exiting(String sourceClass,
                    String sourceMethod)

Log a procedure return.

exiting

public void exiting(String sourceClass,
                    String sourceMethod,
                    Object[] params)

Log a procedure return, with parameters.

fine

public void fine(String msg)

Logs a FINE message

fine

public void fine(String msg,
                 Object[] params)

Log a FINE message, with an array of object arguments.

fine

public void fine(String sourceClass,
                 String sourceMethod,
                 String msg)

Log a FINE message, specifying source class and method.

fine

public void fine(String sourceClass,
                 String sourceMethod,
                 String msg,
                 Object[] params)

Log a FINE message, specifying source class and method, with an array of object arguments.

finer

public void finer(String msg)

Logs a FINER message

finer

public void finer(String msg,
                  Object[] params)

Log a FINER message, with an array of object arguments.

finer

public void finer(String sourceClass,
                  String sourceMethod,
                  String msg)

Log a FINER message, specifying source class and method.

finer

public void finer(String sourceClass,
                  String sourceMethod,
                  String msg,
                  Object[] params)

Log a FINER message, specifying source class and method, with an array of object arguments.

finest

public void finest(String msg)

Logs a FINEST message

finest

public void finest(String msg,
                   Object[] params)

Log a FINEST message, with an array of object arguments.

finest

public void finest(String sourceClass,
                   String sourceMethod,
                   String msg)

Log a FINEST message, specifying source class and method.

finest

public void finest(String sourceClass,
                   String sourceMethod,
                   String msg,
                   Object[] params)

Log a FINEST message, specifying source class and method, with an array of object arguments.

info

public void info(String msg)

Logs a INFO message

info

public void info(String msg,
                 Object[] params)

Log a INFO message, with an array of object arguments.

info

public void info(String sourceClass,
                 String sourceMethod,
                 String msg)

Log a INFO message, specifying source class and method.

info

public void info(String sourceClass,
                 String sourceMethod,
                 String msg,
                 Object[] params)

Log a INFO message, specifying source class and method, with an array of object arguments.

log

public void log(Level msgLevel,
                String msg)

Logs a message

log

public void log(Level msgLevel,
                String msg,
                Object[] params)

Log a message, with an array of object arguments.

log

public void log(Level msgLevel,
                String sourceClass,
                String sourceMethod,
                String msg)

Log a message, specifying source class and method.

log

public void log(Level msgLevel,
                String sourceClass,
                String sourceMethod,
                String msg,
                Object[] params)

Log a message, specifying source class and method, with an array of object arguments.

log

public void log(Level msgLevel,
                String sourceClass,
                String sourceMethod,
                String msg,
                Throwable thrown)

Log a message, specifying source class and method, with associated Throwable information.

log

public void log(Level msgLevel,
                String msg,
                Throwable thrown)

Log a message, with associated Throwable information.

severe

public void severe(String msg)

Logs a SEVERE message

severe

public void severe(String msg,
                   Object[] params)

Log a SEVERE message, with an array of object arguments.

severe

public void severe(String sourceClass,
                   String sourceMethod,
                   String msg)

Log a SEVERE message, specifying source class and method.

severe

public void severe(String sourceClass,
                   String sourceMethod,
                   String msg,
                   Object[] params)

Log a SEVERE message, specifying source class and method, with an array of object arguments.

throwing

public void throwing(String sourceClass,
                     String sourceMethod,
                     Throwable thrown)

Log throwing an exception. The logging is done using the FINER level.

warning

public void warning(String msg)

Logs a WARNING message

warning

public void warning(String msg,
                    Object[] params)

Log a WARNING message, with an array of object arguments.

warning

public void warning(String sourceClass,
                    String sourceMethod,
                    String msg)

Log a WARNING message, specifying source class and method.

warning

public void warning(String sourceClass,
                    String sourceMethod,
                    String msg,
                    Object[] params)

Log a WARNING message, specifying source class and method, with an array of object arguments.

format

public static String format(String format,
                            Object[] objs)

Formats a message. Takes special care when invoking the toString() method of objects that might cause NPEs.