Package org.geotoolkit.util.logging

Extensions to the Java logging framework.

See:
Description

Interface Summary

LogProducer

Interface for objects that produce logs of special interest.

Class Summary

CommonsLoggerFactory	A factory for loggers that redirect all Java logging events to the Apache Commons-logging framework.
Log4JLoggerFactory	A factory for loggers that redirect all Java logging events to the Apache Log4J framework.
LoggedFormat<T>	Wraps a Format object in order to either parse fully a string, or log a warning.
LoggerAdapter	An adapter that redirect all Java logging events to an other logging framework.
LoggerFactory<L>	A factory for Java Logger wrapping an other logging framework.
Logging	A set of utilities method for configuring loggings in Geotk.
MonolineFormatter	A formatter writing log messages on a single line.
PerformanceLevel	Logging levels for measurements of execution time.

Package org.geotoolkit.util.logging Description

Extensions to the Java logging framework. This package provides:

• A Logging utility class with static methods for fetching a logger (see Choosing a logging framework below) or logging an exception.
• A PerformanceLevel with configurable levels for logging the duration of lengthly processes.
• A MonolineFormatter for formatting the log records on single line with colors, for easier reading on the console output.

Choosing a logging framework
The Geotk project uses the standard Logger API for its logging, but this package allows redirection of logging messages to some other frameworks like Log4J.

We recommend to stick to standard Java logging when possible. However if inter-operability with an other logging framework is required, then the only action needed is to include one of the following JAR on the classpath:

• geotk-logging-commons.jar for Apache logging
• geotk-logging-log4j.jar for Log4J logging

Note for Geotk developers
All Geotk code should fetch their logger through a call to our custom Logging.getLogger(String) method, not the standard Logger.getLogger(String) method. This is necessary in order to give Geotk a chance to redirect log events to an other logging framework.

Since:

2.4

Version:

3.16

Author:

Martin Desruisseaux (IRD, Geomatys)

See Also:

Java Logging Overview

Module:

utility/geotk-utility (download)