Interface LoggerProvider
Logger
instances for each Source
object.
It is not usually necessary for users to create implementations of this interface, as
several predefined instances are defined which provide the most commonly required Logger
implementations.
By default, a LoggerProvider
is chosen automatically according to the algorithm described in the static Config.LoggerProvider
property.
This automatic choice can be overridden by setting the Config.LoggerProvider
property manually with an instance of this interface,
but this is also usually not necessary.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final LoggerProvider
ALoggerProvider
implementation that disables all log messages.static final LoggerProvider
ALoggerProvider
implementation that wraps the standardjava.util.logging
system included in the Java SDK version 1.4 and above.static final LoggerProvider
ALoggerProvider
implementation that wraps the Jakarta Commons Logging (JCL) framework.static final LoggerProvider
ALoggerProvider
implementation that wraps the Apache Log4J framework.static final LoggerProvider
ALoggerProvider
implementation that wraps the SLF4J framework.static final LoggerProvider
ALoggerProvider
implementation that sends all log messages to the standard error output stream (System.err
). -
Method Summary
-
Field Details
-
DISABLED
ALoggerProvider
implementation that disables all log messages. -
STDERR
ALoggerProvider
implementation that sends all log messages to the standard error output stream (System.err
).The implementation uses the following code to create each logger:
new
WriterLogger
(new OutputStreamWriter(System.err),name)
-
JAVA
ALoggerProvider
implementation that wraps the standardjava.util.logging
system included in the Java SDK version 1.4 and above.This is the default used if no other logging framework is detected. See the description of the static
Config.LoggerProvider
property for more details.The following mapping of logging levels is used:
Logger
leveljava.util.logging.Level
ERROR
SEVERE
WARN
WARNING
INFO
INFO
DEBUG
FINE
-
JCL
ALoggerProvider
implementation that wraps the Jakarta Commons Logging (JCL) framework.See the description of the static
Config.LoggerProvider
property for details on when this implementation is used as the default.The following mapping of logging levels is used:
Logger
levelorg.apache.commons.logging
levelERROR
error
WARN
warn
INFO
info
DEBUG
debug
-
LOG4J
ALoggerProvider
implementation that wraps the Apache Log4J framework.See the description of the static
Config.LoggerProvider
property for details on when this implementation is used as the default.The following mapping of logging levels is used:
Logger
levelorg.apache.log4j.Level
ERROR
ERROR
WARN
WARN
INFO
INFO
DEBUG
DEBUG
-
SLF4J
ALoggerProvider
implementation that wraps the SLF4J framework.See the description of the static
Config.LoggerProvider
property for details on when this implementation is used as the default.The following mapping of logging levels is used:
Logger
levelorg.slf4j.Logger
levelERROR
error
WARN
warn
INFO
info
DEBUG
debug
-
-
Method Details
-
getLogger
Creates a newLogger
instance with the specified name.The
name
argument is used by the underlying logging implementation, and is normally a dot-separated name based on the package name or class name of the subsystem.The name used for all automatically created
Logger
instances is "net.htmlparser.jericho
".- Parameters:
name
- the name of the logger, the use of which is determined by the underlying logging implementation, may benull
.- Returns:
- a new
Logger
instance with the specified name.
-