| A TopicalLogger dispatches events to a set of Handlers. A TopicalLogger
is a sort of message router.
A topic is associated with each TopicalLogger. A topic
is represented by a dotted string, which is used to build a hierarchical
namespace. The latter should typically be aligned with the Java packaging
namespace.
The name hierarchy of TopicalLogger allows adding properties
inheritance. For example, a TopicalLogger with the "a.b.c" name can inherit
of the Handlers list and the level from the "a.b" parent.
Another property for a TopicalLogger is the capacity to have several
topics. This is important when a component is used by several other
components. This will allow events logged by the shared component to
appear for each component using this shared component. A consequence
of this property is that a Logger may have several parents
The additivity flag indicates if the current TopicalLogger inherits the
handlers of its parents. The default value is true.
|