Methods' Details |
addLogHandler
- Description
- adds the given handler to the list of handlers.
When an event is logged, the logger will create a LogRecord
for this event, and pass this record to all registered handlers. Single handlers
might or might not log those records at their own discretion, and depending on
additional restrictions such as filters specified at handler level.
Note: The log level of the given handler (XLogHandler::Level) will
not be touched. In particular, it will not be set to the logger's log level. It's
the responsibility of the component which knits a logger with one or more
log handlers to ensure that all loggers have appropriate levels set.
- Parameter LogHandler
- the handler to add to the list of handlers. The call is ignored if this
parameter is NULL.
|
|
removeLogHandler
- Description
- removes the given handler from the list of handlers.
- Parameter LogHandler
- the handler to remove from the list of handlers. The call is ignored if this
parameter is NULL, or if the handler has not previously beed added.
|
|
isLoggable
boolean |
isLoggable( |
[in] long |
Level ); |
- Description
- determines whether logger instance would produce any output for the given level.
The method can be used to optimize performance as maybe complex parameter evaluation
in the log calls can be omitted if isLoggable evaluates to false.
- Parameter Level
- level to be checked against
- Returns
- true if there would be some output for this XLogger for the given level, false
otherwise. Note that a return value of false could also indicate that the logger
does not have any log handlers associated with it.
- See also
- addLogHandler, removeLogHandler
|
|
log
void |
log( |
[in] long |
Level, |
| [in] string |
Message ); |
- Description
- logs a given message
- Parameter Level
- the log level of this message. If this level is smaller than the logger's Level
attribute, then the call will be ignored.
- Parameter Message
- the message to log
|
|
logp
void |
logp( |
[in] long |
Level, |
| [in] string |
SourceClassName, |
| [in] string |
SourceMethodName, |
| [in] string |
Message ); |
- Description
- logs a given message, detailing the source class and method at which the logged
event occured.
- Parameter Level
- the log level of this message. If this level is smaller than the logger's Level
attribute, then the call will be ignored.
- Parameter SourceClass
- the source class at which the logged event occured.
- Parameter SourceMethod
- the source class at which the logged event occured.
- Parameter Message
- the message to log
|
|
Copyright © 2013, The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache, the Apache feather logo, Apache OpenOffice and OpenOffice.org are trademarks of The Apache Software Foundation. Other names may be trademarks of their respective owners.