El API estándar de bitácoras de Java, se forma principalmente por el concepto de logger. Dicho concepto corresponde a un nombre de estructura jerárquica similar a la de los paquetes y clases, además representa una configuración particular para grabar eventos. Así, una clase, paquete o aplicación particular puede tener un logger particular cuya configuración puede ser cambiada en tiempo de despliegue.

Además, Java proporciona la forma de establecer un formato para el registro de eventos. Para ello existen dos tipos de formatos que son SimpleFormatter y XMLFormatter. Para establecer un formato personalizado se debe crear una clase que herede de la clase java.util.logging.Formatter.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

import java.util.logging.Formatter;
import java.util.logging.LogRecord;

public class MyFormatter extends Formatter
{
  public String format(LogRecord record)
  {
    return("MyFormatter: " + record.getLevel().intValue()
      + " - " + record.getMessage() + System.getProperty("line.separator"));
  }
}

En el formato anterior, se define que cada registro de evento debe contener la palabra reservada MyFormatter, el valor del nivel del evento y el mensaje que describe el evento ocurrido.

Para crear un objeto logger en la aplicación, es necesario importar las siguientes clases.

1
2
3
4

import java.util.logging.FileHandler;
import java.util.logging.Level;
import java.util.logging.Logger;
import java.util.logging.SimpleFormatter;

Para crear una instancia de la clase Logger se debe invocar el método estático Logger.getLogger pasandole como parámetro el nombre del logger.

1
2
3
4
5

class CLI
{
  public static void main(String argv[]) throws Exception
  {
    Logger logger = Logger.getLogger(“”);

Luego se configura el manejador de eventos que se encargará de registrar el evento a una salida especifica.

1

FileHandler fh = new FileHandler("CLI.log");

El formato personalizado creado anteriormente debe asignarse al manejador de eventos que, en última instancia, es quien registra el evento según el formato definido.

1

fh.setFormatter(new MyFormatter());

Luego se establece el nivel del evento que se quiere registrar en el archivo de log y se agrega el manejador de eventos al logger.

1
2

logger.setLevel(Level.ALL);
logger.addHandler(fh);

Se registran algunos eventos de diferentes niveles en el log de la aplicación llamado CLI.log.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

    logger.info("procesando...");
    try
    {
      throw(new Exception());
    }
    catch (Exception e)
    {
      logger.log(Level.WARNING, "houston... we've got a problem", e);
    }
    logger.fine("hecho!");
  }
}

Se compila y ejecuta el programa

1
2
3
4
5
6
7

$ javac MyFormatter.java
$ javac CLI.java
$ java CLI
$ cat CLI.log
MyFormatter: 800 - procesando...
MyFormatter: 900 - houston... we've got a problem
MyFormatter: 500 - hecho!