Java Logging: Basic Usage

Jakob Jenkov
Last update: 2014-06-23

The most common way of using the Java Logging API is to create a Logger in each class that needs to log. This instance is typically made static and final, meaning all instances of that class use the same Logger instance. Here is an example:

public class LoggingExamples {

    private static final Logger logger =
        Logger.getLogger(LoggingExamples.class.getName());

}

As you can see from this example, it is common practice to use the class name including package name as name for the Logger. The name of the Logger to create is passed as string parameter to the Logger.getLogger() method.

Once instantiated, you can call the various logging methods on the Logger. All this is explained in the text on the Logger.

There are several different places in your code that you may log from. It all depends on what you want to log. For instance, ordinary debug trace logging calls to entering() and exiting() would be called at the beginning and end of a method call. If, on the other hand, you want to log an exception that occurred, you might want to log from inside a catch clause. Here are a few examples of logging:

public class LoggingExamples {

    private static final Logger logger =
        Logger.getLogger(LoggingExamples.class.getName());


    public void doIt() {
        logger.entering(getClass().getName(), "doIt");

        try{
            //... something that can throw an exception
        } catch (Exception e) {
            logger.log(Level.SEVERE, "Error doing XYZ", e);
        }

        logger.exiting(getClass().getName(), "doIt");
    }

}

Jakob Jenkov

Featured Videos

Java Generics

Java ForkJoinPool

P2P Networks Introduction



















Close TOC
All Tutorial Trails
All Trails
Table of contents (TOC) for this tutorial trail
Trail TOC
Table of contents (TOC) for this tutorial
Page TOC
Previous tutorial in this tutorial trail
Previous
Next tutorial in this tutorial trail
Next