Dynamic Appenders

Each logger object has several methods that you can use in order to interact with the logger's appenders. You can add, remove, clear or list the appenders on a specific logger instance. Below are the methods you can use in the logger class to interact with appenders:

Method

Return Type

Description

hasAppenders()

Boolean

Checks if the logger has any appenders attached to it

getAppenders()

Struct

Returns the map of registered appenders

getAppender(name)

Appender

Return a named appender if it is registered in the logger

appenderExists(name)

Boolean

Checks if a named appender exists in the logger

addAppender(Appender)

void

Register an appender with the logger at runtime

removeAppender(name)

Boolean

Will un-register an appender from this logger

removeAllAppenders()

void

Will try to un-register all appenders from this logger

So you can easily add/remove/check the appenders on any logger at any time.

//Add your own appender at runtime
jms = createObject( "component", "com.appender.JMSAppender" ).init( "JMSAppender", properties );
logger.addAppender( jms );

//log a message to all appenders and to my jms appender:
logger.fatal( "I FAILED MAN!" );

//remove it
logger.removeAppender( "JMSAppender" );