An implementation of a LoggingModule provides information about a component for which to provide logging
facilities. It is an abstraction from the "logging by package" concept used by lower-level logging frameworks.
A user can select to change the logging configuration for a module, resulting in all packages managed by this
module to be logged according to the new configuration. This allows to group packages together that conceptually
LoggingModule providers are injected by the LoggingService using CDI injection. As such they should be proper CDI
bearns and probably live in application scope.
- Sebastian Schaffert (email@example.com)
Return a unique identifier for this logging module. This identifier will e.g. be used in the configuration file
to store the configuration for this module. For this reason it should only consist of alpha-numeric characters
plus _ and _.
- a unique identifier for the module, suitable for use in the configuration file
Return a human-readable name for this logging module. This name is used for displaying information about the
module to the user, e.g. in a configuration interface.
- a human-readable name for the module, suitable for displaying in a user interface
Return a collection of packages covered by this logging module. This method should be used to group together
those packages that conceptually make up the functionality described by the logging module (e.g. "SPARQL").
- a collection of package names
Return the default (logback) level used by this logging module. Should in most cases be INFO or WARN.
Return the currently configured (logback) level used by this logging module. This field is read from the
configuration file and defaults to getDefaultLevel()
Update the currently active (logback) level used by this logging module. This method directly updates the
Return the identifiers of all logging outputs configured for this module
Set the identifiers of all logging outputs for this module
Return the logging outputs configured for this module (resolved using the LoggingService).
Set the logging outputs configured for this module (internally calls setLoggingOutputIds).