Module org.cojen.tupl

Package org.cojen.tupl.diag

Interface EventListener

public interface EventListener

Listener which receives notifications of actions being performed by the database. Implementations must not suspend the calling thread or throw any exceptions.

See Also:

• DatabaseConfig.eventListener(org.cojen.tupl.diag.EventListener)

Method Summary

Modifier and Type	Method	Description
default EventListener	ignore(System.Logger.Level... levels)	Returns a filtered listener which never observes the given event levels.
default EventListener	ignore(EventType.Category... categories)	Returns a filtered listener which never observes the given event categories.
default boolean	isObserved(System.Logger.Level level)
default boolean	isObserved(EventType type)
default boolean	isObserved(EventType.Category category)
static EventListener	logTo(System.Logger logger)	Returns a new listener that logs messages to the given logger.
static EventListener	logTo(Logger logger)	Returns a new listener that logs messages to the given logger.
static EventListener	logTo(org.slf4j.Logger logger)	Returns a new listener that logs messages to the given logger.
void	notify(EventType type, String message, Object... args)
default EventListener	observe(System.Logger.Level... levels)	Returns a filtered listener which only observes the given event levels.
default EventListener	observe(EventType.Category... categories)	Returns a filtered listener which only observes the given event categories.
static EventListener	printTo(PrintStream out)	Returns a new listener that prints messages to the given stream.

Method Details

printTo

static EventListener printTo(PrintStream out)

Returns a new listener that prints messages to the given stream.

logTo

static EventListener logTo(Logger logger)

Returns a new listener that logs messages to the given logger.

logTo

static EventListener logTo(System.Logger logger)

Returns a new listener that logs messages to the given logger.

logTo

static EventListener logTo(org.slf4j.Logger logger)

Returns a new listener that logs messages to the given logger.

notify

void notify(EventType type,
 String message,
 Object... args)

Parameters:

message - event message format

args - arguments for message

isObserved

default boolean isObserved(EventType type)

isObserved

default boolean isObserved(EventType.Category category)

isObserved

default boolean isObserved(System.Logger.Level level)

observe

default EventListener observe(EventType.Category... categories)

Returns a filtered listener which only observes the given event categories.

observe

default EventListener observe(System.Logger.Level... levels)

Returns a filtered listener which only observes the given event levels.

ignore

default EventListener ignore(EventType.Category... categories)

Returns a filtered listener which never observes the given event categories.

ignore

default EventListener ignore(System.Logger.Level... levels)

Returns a filtered listener which never observes the given event levels.