 |
Qore Logger Module Reference
0.2
|
|
Qore Logger Module Reference
0.2
|
Implements main logger class whose instance will be used by user code when logging. More...
Public Member Methods | |
| addAppender (LoggerAppender appender) | |
| Adds an appender to the appender list. More... | |
| callAppenders (LoggerEvent event) | |
| Forwards the given logging event to all linked appenders. More... | |
| constructor (LoggerLevel level) | |
| Creates the object with an empty name and the given initial level. More... | |
| constructor (string name, LoggerLevel level) | |
| Creates the object. More... | |
| constructor (string name='') | |
| Creates the object. More... | |
| *LoggerLevel | decLevel () |
| Decrement logger level. More... | |
| bool | getAdditivity () |
| Returns the additivity flag. | |
| list< LoggerAppender > | getAppenders () |
| Returns the appender list. More... | |
| *LoggerLevel | getLevel (bool effective=True) |
| Returns the logging level. More... | |
| string | getName () |
| Returns the logger name. | |
| *Logger | getParent () |
| Returns the parent logger, if any. | |
| *LoggerLevel | incLevel () |
| Increment logger level. More... | |
| removeAllAppenders () | |
| Clears the appender list by removing all appenders. | |
| removeAppender (LoggerAppender appender) | |
| Removes the appender from the list. More... | |
| setAdditivity (bool enable) | |
| Sets the additivity flag; when additivity is active, events are passed to parent loggers. More... | |
| setLevel (*LoggerLevel level) | |
| Sets the logging level. More... | |
| setLevel (int level) | |
| Sets the logging level. More... | |
| setLevel (string level) | |
| Sets the logging level. More... | |
| setParent (*Logger value) | |
| Sets the parent logger. More... | |
Private Member Methods | |
| hash< CallStackInfo > | getLocation () |
| Returns the call location where the log function was called from. | |
Private:Internal Member Methods | |
| transient RWLock | lock () |
| The lock to protect object manipulation. | |
Static Private:Internal Member Methods | |
| static RWLock | hierarchyLock () |
| The lock to protect access to parent/child hierarchy. | |
Private:Internal Attributes | |
| bool | additivity = True |
| Logger additivity. If set to true then child loggers will inherit the appenders of their ancestors by default. | |
| list< LoggerAppender > | appenders |
| A collection of appenders linked to this logger. | |
| *LoggerLevel | currentLevel |
| The assigned Logger level. If NOTHING, the parent level is used. | |
| string | name |
| The name of this Logger instance. | |
| *Logger | parent |
| The parent logger. Unassigned if this is the root logger. | |
Implements main logger class whose instance will be used by user code when logging.
The Logger object is provided to user code. When a log is triggered then message, arguments, current code position, time are appended into LoggerEvent event instance when the logging level is enabled. The event is passed to all registered appenders in the given Logger as well as in parents in the hierarchy when additivity is enabled.
| Logger::Logger::addAppender | ( | LoggerAppender | appender | ) |
Adds an appender to the appender list.
| appender | add a new LoggerAppender |
| LOGGER-ERROR | exception if appender is already in list |
| Logger::Logger::callAppenders | ( | LoggerEvent | event | ) |
Forwards the given logging event to all linked appenders.
| event | the event to forward |
| Logger::Logger::constructor | ( | LoggerLevel | level | ) |
Creates the object with an empty name and the given initial level.
| level | the initial level for the logger |
| Logger::Logger::constructor | ( | string | name, |
| LoggerLevel | level | ||
| ) |
Creates the object.
| name | the name of the object |
| level | the initial level for the logger |
| Logger::Logger::constructor | ( | string | name = '' | ) |
Creates the object.
| name | the name of the object |
| *LoggerLevel Logger::Logger::decLevel | ( | ) |
Decrement logger level.
LoggerLevel | list<LoggerAppender> Logger::Logger::getAppenders | ( | ) |
Returns the appender list.
Note that the appender list may be manipulated in another thread as internal lock is released when list is returned
| *LoggerLevel Logger::Logger::getLevel | ( | bool | effective = True | ) |
Returns the logging level.
| effective | if False then get current level which can be NOTHING, if True then get level which might be inherited from parent, Default: True |
| LOGGER-ERROR | if cannot get effective level from hierarchy |
| *LoggerLevel Logger::Logger::incLevel | ( | ) |
Increment logger level.
LoggerLevel | Logger::Logger::removeAppender | ( | LoggerAppender | appender | ) |
Removes the appender from the list.
| appender | the appender to remove |
| Logger::Logger::setAdditivity | ( | bool | enable | ) |
Sets the additivity flag; when additivity is active, events are passed to parent loggers.
| enable | the additivity flag; when additivity is active, events are passed to parent loggers |
| Logger::Logger::setLevel | ( | *LoggerLevel | level | ) |
Sets the logging level.
| level | if nothing then inherits level from parent |
| Logger::Logger::setLevel | ( | int | level | ) |
Sets the logging level.
| level | the logging level to set |
| Logger::Logger::setLevel | ( | string | level | ) |
Sets the logging level.
| level | the logging level as a string |
| Logger::Logger::setParent | ( | *Logger | value | ) |
Sets the parent logger.
| value | the parent logger |
| LOGGER-ERROR | in case of circular reference |