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