org.jboss.netty.handler.logging

Class LoggingHandler

java.lang.Object

org.jboss.netty.handler.logging.LoggingHandler

All Implemented Interfaces:

ChannelDownstreamHandler, ChannelHandler, ChannelUpstreamHandler

@ChannelHandler.Sharable
public class LoggingHandler
extends java.lang.Object
implements ChannelUpstreamHandler, ChannelDownstreamHandler

A ChannelHandler that logs all events via InternalLogger. By default, all events are logged at DEBUG level. You can extend this class and override log(ChannelEvent) to change the default behavior.

Nested Class Summary

Nested classes/interfaces inherited from interface org.jboss.netty.channel.ChannelHandler

ChannelHandler.Sharable

Field Summary

Fields

Modifier and Type	Field and Description
private static char[]	BYTE2CHAR
private static java.lang.String[]	BYTE2HEX
private static java.lang.String[]	BYTEPADDING
private static InternalLogLevel	DEFAULT_LEVEL
private boolean	hexDump
private static java.lang.String[]	HEXPADDING
private InternalLogLevel	level
private InternalLogger	logger
private static java.lang.String	NEWLINE

Constructor Summary

Constructors

Constructor and Description
LoggingHandler() Creates a new instance whose logger name is the fully qualified class name of the instance with hex dump enabled.
LoggingHandler(boolean hexDump) Creates a new instance whose logger name is the fully qualified class name of the instance.
LoggingHandler(java.lang.Class<?> clazz) Creates a new instance with the specified logger name and with hex dump enabled.
LoggingHandler(java.lang.Class<?> clazz, boolean hexDump) Creates a new instance with the specified logger name.
LoggingHandler(java.lang.Class<?> clazz, InternalLogLevel level) Creates a new instance with the specified logger name.
LoggingHandler(java.lang.Class<?> clazz, InternalLogLevel level, boolean hexDump) Creates a new instance with the specified logger name.
LoggingHandler(InternalLogLevel level) Creates a new instance whose logger name is the fully qualified class name of the instance.
LoggingHandler(InternalLogLevel level, boolean hexDump) Creates a new instance whose logger name is the fully qualified class name of the instance.
LoggingHandler(java.lang.String name) Creates a new instance with the specified logger name and with hex dump enabled.
LoggingHandler(java.lang.String name, boolean hexDump) Creates a new instance with the specified logger name.
LoggingHandler(java.lang.String name, InternalLogLevel level, boolean hexDump) Creates a new instance with the specified logger name.

Method Summary

Modifier and Type	Method and Description
private static java.lang.String	formatBuffer(ChannelBuffer buf)
InternalLogLevel	getLevel() Returns the InternalLogLevel that this handler uses to log a ChannelEvent.
InternalLogger	getLogger() Returns the InternalLogger that this handler uses to log a ChannelEvent.
void	handleDownstream(ChannelHandlerContext ctx, ChannelEvent e) Handles the specified downstream event.
void	handleUpstream(ChannelHandlerContext ctx, ChannelEvent e) Handles the specified upstream event.
void	log(ChannelEvent e) Logs the specified event to the InternalLogger returned by getLogger().

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_LEVEL

private static final InternalLogLevel DEFAULT_LEVEL

NEWLINE

private static final java.lang.String NEWLINE

BYTE2HEX

private static final java.lang.String[] BYTE2HEX

HEXPADDING

private static final java.lang.String[] HEXPADDING

BYTEPADDING

private static final java.lang.String[] BYTEPADDING

BYTE2CHAR

private static final char[] BYTE2CHAR

logger

private final InternalLogger logger

level

private final InternalLogLevel level

hexDump

private final boolean hexDump

Constructor Detail

LoggingHandler

public LoggingHandler()

Creates a new instance whose logger name is the fully qualified class name of the instance with hex dump enabled.

LoggingHandler

public LoggingHandler(InternalLogLevel level)

Creates a new instance whose logger name is the fully qualified class name of the instance.

Parameters:

level - the log level

LoggingHandler

public LoggingHandler(boolean hexDump)

Creates a new instance whose logger name is the fully qualified class name of the instance.

Parameters:

hexDump - true if and only if the hex dump of the received message is logged

LoggingHandler

public LoggingHandler(InternalLogLevel level,
                      boolean hexDump)

Creates a new instance whose logger name is the fully qualified class name of the instance.

Parameters:

level - the log level

hexDump - true if and only if the hex dump of the received message is logged

LoggingHandler

public LoggingHandler(java.lang.Class<?> clazz)

Creates a new instance with the specified logger name and with hex dump enabled.

LoggingHandler

public LoggingHandler(java.lang.Class<?> clazz,
                      boolean hexDump)

Creates a new instance with the specified logger name.

Parameters:

hexDump - true if and only if the hex dump of the received message is logged

LoggingHandler

public LoggingHandler(java.lang.Class<?> clazz,
                      InternalLogLevel level)

Creates a new instance with the specified logger name.

Parameters:

level - the log level

LoggingHandler

public LoggingHandler(java.lang.Class<?> clazz,
                      InternalLogLevel level,
                      boolean hexDump)

Creates a new instance with the specified logger name.

Parameters:

level - the log level

hexDump - true if and only if the hex dump of the received message is logged

LoggingHandler

public LoggingHandler(java.lang.String name)

Creates a new instance with the specified logger name and with hex dump enabled.

LoggingHandler

public LoggingHandler(java.lang.String name,
                      boolean hexDump)

Creates a new instance with the specified logger name.

Parameters:

hexDump - true if and only if the hex dump of the received message is logged

LoggingHandler

public LoggingHandler(java.lang.String name,
                      InternalLogLevel level,
                      boolean hexDump)

Creates a new instance with the specified logger name.

Parameters:

level - the log level

hexDump - true if and only if the hex dump of the received message is logged

Method Detail

getLogger

public InternalLogger getLogger()

Returns the InternalLogger that this handler uses to log a ChannelEvent.

getLevel

public InternalLogLevel getLevel()

Returns the InternalLogLevel that this handler uses to log a ChannelEvent.

log

public void log(ChannelEvent e)

Logs the specified event to the InternalLogger returned by getLogger(). If hex dump has been enabled for this handler, the hex dump of the ChannelBuffer in a MessageEvent will be logged together.

formatBuffer

private static java.lang.String formatBuffer(ChannelBuffer buf)

handleUpstream

public void handleUpstream(ChannelHandlerContext ctx,
                           ChannelEvent e)
                    throws java.lang.Exception

Description copied from interface: ChannelUpstreamHandler

Handles the specified upstream event.

Specified by:

handleUpstream in interface ChannelUpstreamHandler

Parameters:

ctx - the context object for this handler

e - the upstream event to process or intercept

Throws:

java.lang.Exception

handleDownstream

public void handleDownstream(ChannelHandlerContext ctx,
                             ChannelEvent e)
                      throws java.lang.Exception

Description copied from interface: ChannelDownstreamHandler

Handles the specified downstream event.

Specified by:

handleDownstream in interface ChannelDownstreamHandler

Parameters:

ctx - the context object for this handler

e - the downstream event to process or intercept

Throws:

java.lang.Exception