de.aristaflow.adept2.util.logging

Class WrappingLogger

java.lang.Object

java.util.logging.Logger

de.aristaflow.adept2.util.logging.WrappingLogger

Direct Known Subclasses:

DebugLogger, NameWrappingLogger

public class WrappingLogger
extends java.util.logging.Logger

This logger wraps a normal logger and handles setting the log level appropriately. This allows for easy wrapping and extending a logger.
This logger may have a different name than the wrapped logger.

Logging is only forwarded to the wrapped logger in case this logs for the level of the current record. Otherwise logging is done by this logger.

Author:

Ulrich Kreher

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.logging.Logger	innerLogger The wrapped logger.

Fields inherited from class java.util.logging.Logger

global, GLOBAL_LOGGER_NAME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	WrappingLogger(java.util.logging.Logger innerLogger) Creates a new logger wrapping the designated one.
protected	WrappingLogger(java.lang.String name, java.util.logging.Logger innerLogger) Creates a new logger wrapping the designated one and having the designated name.

Method Summary

Modifier and Type	Method and Description
void	addHandler(java.util.logging.Handler handler)
boolean	equals(java.lang.Object obj) Calls equals(Object) of the inner logger.
java.util.logging.Filter	getFilter()
java.util.logging.Handler[]	getHandlers()
java.util.logging.Level	getLevel()
java.lang.String	getName()
java.util.logging.Logger	getParent()
java.util.ResourceBundle	getResourceBundle()
java.lang.String	getResourceBundleName()
boolean	getUseParentHandlers()
int	hashCode()
boolean	isLoggable(java.util.logging.Level level) Since this method delegates to the inner logger, it usually has to be overridden in case (a subclass of) this logger sets the level without propagating it to the wrapped logger.
void	log(java.util.logging.LogRecord record) Logs the designated record by the wrapped logger in case the wrapped logger logs the corresponding level.
void	removeHandler(java.util.logging.Handler handler)
void	setFilter(java.util.logging.Filter newFilter)
void	setLevel(java.util.logging.Level newLevel)
protected void	setLevel(java.util.logging.Level newLevel, boolean propagate) Sets the level of this logger to the designated one.
void	setParent(java.util.logging.Logger parent)
void	setUseParentHandlers(boolean useParentHandlers)

Methods inherited from class java.util.logging.Logger

config, config, entering, entering, entering, exiting, exiting, fine, fine, finer, finer, finest, finest, getAnonymousLogger, getAnonymousLogger, getGlobal, getLogger, getLogger, info, info, log, log, log, log, log, log, logp, logp, logp, logp, logp, logp, logrb, logrb, logrb, logrb, logrb, logrb, setResourceBundle, severe, severe, throwing, warning, warning

Methods inherited from class java.lang.Object

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

Field Detail

innerLogger

protected final java.util.logging.Logger innerLogger

The wrapped logger.

Constructor Detail

WrappingLogger

protected WrappingLogger(java.util.logging.Logger innerLogger)

Creates a new logger wrapping the designated one. The created logger will have the same name as the wrapped logger.

Parameters:

innerLogger - The logger to which all requests will be forwarded.

WrappingLogger

protected WrappingLogger(java.lang.String name,
                         java.util.logging.Logger innerLogger)

Creates a new logger wrapping the designated one and having the designated name.

Parameters:

innerLogger - The logger to which all requests will be forwarded.

name - The name of the logger (this). This name is used in log records.

Method Detail

getResourceBundle

public java.util.ResourceBundle getResourceBundle()

Overrides:

getResourceBundle in class java.util.logging.Logger

getResourceBundleName

public java.lang.String getResourceBundleName()

Overrides:

getResourceBundleName in class java.util.logging.Logger

setFilter

public void setFilter(java.util.logging.Filter newFilter)
               throws java.lang.SecurityException

Overrides:

setFilter in class java.util.logging.Logger

Throws:

java.lang.SecurityException

getFilter

public java.util.logging.Filter getFilter()

Overrides:

getFilter in class java.util.logging.Logger

setLevel

public void setLevel(java.util.logging.Level newLevel)
              throws java.lang.SecurityException

Overrides:

setLevel in class java.util.logging.Logger

Throws:

java.lang.SecurityException

setLevel

protected void setLevel(java.util.logging.Level newLevel,
                        boolean propagate)

Sets the level of this logger to the designated one. The designated level may be propagated to the wrapped logger. This propagation may change the effective level (due to the level of parent loggers). In this case the level of this logger will be set appropriately to the effective level.

Parameters:

newLevel - The level to set in this logger.

propagate - Whether the designated level should be propagated to the wrapped logger.

getLevel

public java.util.logging.Level getLevel()

Overrides:

getLevel in class java.util.logging.Logger

isLoggable

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

Since this method delegates to the inner logger, it usually has to be overridden in case (a subclass of) this logger sets the level without propagating it to the wrapped logger.

Overrides:

isLoggable in class java.util.logging.Logger

getName

public java.lang.String getName()

Overrides:

getName in class java.util.logging.Logger

addHandler

public void addHandler(java.util.logging.Handler handler)
                throws java.lang.SecurityException

Overrides:

addHandler in class java.util.logging.Logger

Throws:

java.lang.SecurityException

removeHandler

public void removeHandler(java.util.logging.Handler handler)
                   throws java.lang.SecurityException

Overrides:

removeHandler in class java.util.logging.Logger

Throws:

java.lang.SecurityException

getHandlers

public java.util.logging.Handler[] getHandlers()

Overrides:

getHandlers in class java.util.logging.Logger

setUseParentHandlers

public void setUseParentHandlers(boolean useParentHandlers)

Overrides:

setUseParentHandlers in class java.util.logging.Logger

getUseParentHandlers

public boolean getUseParentHandlers()

Overrides:

getUseParentHandlers in class java.util.logging.Logger

getParent

public java.util.logging.Logger getParent()

Overrides:

getParent in class java.util.logging.Logger

setParent

public void setParent(java.util.logging.Logger parent)

Overrides:

setParent in class java.util.logging.Logger

log

public void log(java.util.logging.LogRecord record)

Logs the designated record by the wrapped logger in case the wrapped logger logs the corresponding level. Otherwise the record is logged by the wrapping logger.

Overrides:

log in class java.util.logging.Logger

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Calls equals(Object) of the inner logger. However, the designated object will be unwrapped if it is also a WrappingLogger.

Overrides:

equals in class java.lang.Object