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" );

results matching ""

    No results matching ""