|Enhydra 3.0 API|
|PREV CLASS NEXT CLASS||FRAMES NO FRAMES|
|SUMMARY: INNER | FIELD | CONSTR | METHOD||DETAIL: FIELD | CONSTR | METHOD|
java.lang.Object | +--com.lutris.logging.Logger
A general-purpose logging facility. It is modeled after
syslogd. This is a base class from which an actual
implementation is derived. It only defines how log message are written
by a client. Where the log message is written and the mechanism for
controlling logging is left up to the implementation. This class does
not define any of these mechanism and their definition is not necessary
for understand how to use this class.
Each log message is associate with a facility and has a level assigned to it. A facility is a symbolic (String) name that defines a class of log messages. A level is used to indicate the It is expected that the implementation can enable, disable and direct log messages based on these attributes. Facilities and levels are defined symbolicly, with no restriction on the name, and form a tuple. Several standard levels are defined as integer constants and their use is expected to be higher performing than symbolic levels..
Normally, a single, global instance of the object is exists and is obtainable by a static method in this class.
Log messages are written via an object implementing
A channel is associated with a single facility, with the level being
specified when a message is written. Normally, a
is obtained once at initialization time and use repeatedly. It is
permissible to obtain multiple references to the log channel for a facility,
but this is discouraged for performance reasons.
Log messages, even debugging ones, should be defined with care. They should be terse, but clear to someone who isn't intimately familiar with the code. Permanent debugging messages should be designed with the idea of use when supportting a deployed product.
The central logging object needs to be configured very early in the startup
process. If logging can't be configured, then the startup should be aborted
or a object created that does some simple form of logging, such as write
. A client should never have to check if the global
logger object exists.
A condition that should be corrected immediately
protected static Logger
Messages that contain information normally of use only when debugging.
Debug detail level 1.
Debug detail level 2.
Debug detail level 3.
Debug detail level 4.
Debug detail level 5.
Debug detail level 6.
Debug detail level 7.
Debug detail level 8.
Debug detail level 9.
Temporary debugging; should not be left in shipping code.
Standard level for urgent condition that requires immediate attention and indicates that the system is no longer functioning.
Errors that have been correctly handled.
Largest fixed logging level.
Conditions that are not error conditions, but should possi bly be handled specially.
protected static java.lang.String
Table of standard level names
Get the central (global) logging object.
Get the log channel object for a facility.
Methods inherited from class java.lang.Object
public static final int EMERGENCY
public static final int ALERT
public static final int CRITICAL
public static final int ERROR
public static final int WARNING
public static final int NOTICE
public static final int INFO
public static final int DEBUG
public static final int DEBUG1
public static final int DEBUG2
public static final int DEBUG3
public static final int DEBUG4
public static final int DEBUG5
public static final int DEBUG6
public static final int DEBUG7
public static final int DEBUG8
public static final int DEBUG9
public static final int DEBUGTMP
public static final int MAX_STD_LEVEL
protected static Logger centralLogger
protected static final java.lang.String standardLevelNames
public static Logger getCentralLogger()
null is returned. However, this is
considered a bug in the design of the initialization. Clients
do not need to check for
public abstract LogChannel getChannel(java.lang.String facility)
facility - Facility the channel is associated with.
Enhydra 3.0 API
SUMMARY: INNER | FIELD | CONSTR | METHOD
DETAIL: FIELD | CONSTR | METHOD