Abstract Protected _determineDetermines the log message origin based on the origin configured and the globally set origin. If the origins of this logger and the root are set and differ, they will be concatenated using a slash ('/).
Optional explicitOrigin: null | stringThe origin configured in this logger is extensible by an explicit string specified.
Protected Abstract _getProtected _getProtected _getIf the implementor of this interface provides a category, the category string will be determined in form of a string with the syntax 'Category.Subcategory.*'. If the category specified in this object starts with a period ('.'), it is appended to this and/or a parent logger's category.
Optional explicitCategory: null | string | CategoryThe category specified to this object can be overridden by providing an absolute category string (not starting with period) or a category object.
Protected Abstract _getProtected Abstract _getProtected Abstract _getNeeds to be implemented by subclasses in order to provide the parent log entity providing the parent ref fragment, category, and origin for the propagation to log messages.
Protected Abstract _getProtected _getThe implementor of this interface provides a ref fragment, else, a parent's ref will be used. If it also provides a parent logger entity, its ref fragment will be prepended to this ref fragment so that the resulting ref string has the syntax 'Module:SubModule:*:Class:Function' of which every element is optional.
Optional subRef: null | stringIf specified, this ref will be appended to the logger's basic ref.
Abstract addAdds a new appender to the logger's local appenders list. This can be used for handling logger-specific appenders.
The appender to add;
enables chaining calls to the logger
Abstract categorySets a category for the next log message. The respective log method must be called on the returned object (method chaining). The returned object allows to call more parameter specifying methods. If the returned object is withdrawn, the set category information is lost. The category of the new log message defaults to the logger's category.
The category to set for the next log message. If a Category object or a string is provided, it will be used as the actual category of the message. If a string is provided that starts with a period, e.g. '.subcategory', it will be used as a sub category of the parent logger's category. The categories will then be concatenated separated by a perios ('.').
The log message builder object that allows to specify more parameters of the next log message.
Abstract fallSets the next log message to be appended to the fallback appender. The respective log method must be called on the returned object (method chaining). If the returned object is withdrawn, the set fallback information is lost. This disables the evaluation of message filters to the appenders. The log framework does this internally, if errors in custom code or appenders occur.
Optional fallBack: booleanIf true, the next message will be handled by a fallback appender.
The returned object allows to call more parameter specifying methods.
Abstract getAbstract handleHandles the log message within the respective implementor.
The log message to handle.
Abstract idSets the id for the next log message. The respective log method must be called on the returned object (method chaining). The returned object allows to call more parameter specifying methods. If the returned object is withdrawn, the set id information is lost.
The id to set for the next log message
The log message builder object that allows to specify more parameters of the next log message.
Information about the actions that are executed by the software. For User feedback.
The actual log message.
Optional parameters: null | objectThe log message parameters. Its keys will replace the '%key%' placeholders in the message string.
Creates a new LogMessage by calling the abstract methods in this interface.
The severity of the log message. Possible values are specified by the LogMessage.Severity Enum.
The actual log message.
Optional parameters: null | objectThe log message parameters. Its keys will replace the '%key%' placeholders in the message string.
Abstract onceSets the onceId for the new log message. The respective log method must be called on the returned object (method chaining). If the returned object is withdrawn, the set fallback information is lost. If set, other messages using the same onceid will not be handled.
Optional onceId: string | booleanif set to true, only, the combination of loglevel, id or message text will be used for identifying similar messages
Abstract originSets the origin (current environment) for the next log message. The respective log method must be called on the returned object (method chaining). The returned object allows to call more parameter specifying methods. If the returned object is withdrawn, the set origin information is lost. The origin of the new log message defaults to the logger's origin. If providing an origin that differs from the logger's origin, the strings are concatenated separated by a slash ('/')
The origin to set for the next log message
The log message builder object that allows to specify more parameters of the next log message.
Abstract refSets a ref fragment for the next log message. The respective log method must be called on the returned object (method chaining). The returned object allows to call more parameter specifying methods. If the returned object is withdrawn, the set ref fragment information is lost. The ref fragment of the new log message defaults to the logger's ref fragment. All fragments in the chain of loggers are concatenated separated by a colon (':')
The ref fragment to set for the next log message
The log message builder object that allows to specify more parameters of the next log message.
Abstract removeRemoves an appender from the logger's local appenders list.
The appender to remove;
enables chaining calls to the logger
Abstract subCreates a new logger instance as a child of this logger.
The ref fragment of the source code organization unit (e.g. module, class, function) that requests the new logger.
Optional category: null | string | CategoryThe (new sub-/root-) category of the new logger.
Optional origin: null | stringThe origin of the new logger.
Warnings about unintended behaviour or usage of the software or possible security and safety risks.
The actual log message.
Optional parameters: null | objectThe log message parameters. Its keys will replace the '%key%' placeholders in the message string.
The LogMethods interface provides all methods handling the creation of log messages. In order to provide the additional log message information, the abstract methods should be implemented by subclasses.