Package org.silverpeas.core.util.logging
The Java ecosystem is rich in logging solutions as it was no standard solution provided by Java until Java 1.5. In order to be agnostic to any logging solutions and to be able to change in the time, Silverpeas has defined its own solution with the goal to wrap any possible logging subsystem and to offer logging capabilities specific to Silverpeas.
The Silverpeas Logging Engine is based upon a set of well-defined loggers, each of them mapped to a specific Silverpeas module (a business set of features) that can be a Silverpeas component as well as a Silverpeas Core's engine/API. Each logger is defined by a namespace that defines a dot-separated logger hierarchy and a level that filters the kind of messages to record into the Silverpeas logs. If the level of a logger isn't set explicitly, then its level will be its nearest ancestor with a non-null logging level. It will be the first ancestor with a non-null logging level that will take in charge of the recording of the messages from its child loggers to the logs.
Silverpeas defines by configuration at least two logs: one for all traces and another for only
errors. For those logs, the Logging Engine provides two handlers/adapters that are set to the
Silverpeas root logger, Silverpeas
. This mechanism is set up by the Silverpeas
installer. It is the responsibility to the logging engine implementation to take care of the
handlers/adapters for each logger that have their level set (and hence not inherited).
- Author:
- mmoquillon
-
Interface Summary Interface Description SilverLogger The custom logger for Silverpeas.SilverLoggerFactory A factory of logger instances. -
Class Summary Class Description LogAnnotationProcessor A processor oforg.silverpeas.core.util.logging.Log
annotations.LoggerConfigurationManager There is a single global LoggerConfigurationManager object that is used to manage a set of configuration about the different Loggers available in Silverpeas.LoggerConfigurationManager.LoggerConfiguration LogsAccessor An accessor to the logs of Silverpeas.SilverLoggerProvider A provider of aSilverLogger
. -
Enum Summary Enum Description Level The different logging levels taken in charge by the Silverpeas logger. -
Annotation Types Summary Annotation Type Description Log An annotation applicable to methods and types for which you wish to trace the invocation of the method.Logger This annotation is for specifying the logger to use for the given package or class.