ch.agent.crnickl.api

Interface MessageListener

All Superinterfaces:

EventListener

public interface MessageListener
extends EventListener

A MessageListener is used by CrNiCKL for logging messages. Applications provide the implementation.

Author:

Jean-Paul Vetterli

Method Summary

Modifier and Type	Method and Description
boolean	isListened(Level level) Return true if a message at the given level passes the filter.
void	log(Exception e) Log an exception.
void	log(Level level, ch.agent.core.KeyedMessage msg) Log a keyed message at the level specified.
void	log(Level level, String text) Log a text at the level specified.
void	setFilterLevel(Level level) Configure the message listener to filter out messages at a logging level lower than the argument.

Method Detail

setFilterLevel

void setFilterLevel(Level level)

Configure the message listener to filter out messages at a logging level lower than the argument.

Parameters:

level - minimum level required for messages to be logged

isListened

boolean isListened(Level level)

Return true if a message at the given level passes the filter.

Parameters:

level - a logging level

Returns:

true if messages at the give level will be logged

log

void log(Level level,
         ch.agent.core.KeyedMessage msg)

Log a keyed message at the level specified.

Parameters:

level - a logging level

msg - a keyed message

log

void log(Level level,
         String text)

Log a text at the level specified.

Parameters:

level - a logging level

text - a string

log

void log(Exception e)

Log an exception. Implementations typically log the exception message at the SEVERE level and possibly dump a stack trace in the log.

Parameters:

e - an exception