Класс SimpleFormatter

Форматирование можно настроить, указав строку формата в свойстве java.util.logging.SimpleFormatter.format. Данный LogRecord будет отформатирован как если бы вызов был таким:

    String.format(format, date, source, logger, level, message, thrown);
 

1. format - строка формата java.util.Formatter, указанная в свойстве java.util.logging.SimpleFormatter.format, или формат по умолчанию.
2. date - объект ZonedDateTime, представляющий время события записи журнала в часовом поясе системы по умолчанию ZoneId.systemDefault().
3. source - строка, представляющая вызывающую сторону, если доступна; в противном случае - имя логгера.
4. logger - имя логгера.
5. level - уровень журнала.
6. message - отформатированное сообщение журнала, возвращаемое методом Formatter.formatMessage(LogRecord). Оно использует форматирование java.text и не использует аргумент java.util.Formatter format.
7. thrown - строка, представляющая исключение thrown, связанное с записью журнала и её трассировку, начинающуюся с символа новой строки, если таковая имеется; в противном случае — пустая строка.

Примеры форматов:

• java.util.logging.SimpleFormatter.format="%4$s: %5$s [%1$tc]%n"

  Выводит 1 строку с уровнем журнала (4$), сообщением журнала (5$) и меткой времени (1$) в квадратных скобках.

       WARNING: warning message [Tue Mar 22 13:11:31 PDT 2011]
       

• java.util.logging.SimpleFormatter.format="%1$tc %2$s%n%4$s: %5$s%6$s%n"

  Выводит 2 строки, где первая строка содержит метку времени (1$) и источник (2$); вторая строка содержит уровень журнала (4$) и сообщение журнала (5$) вместе с исключением и его трассировкой (6$), если таковое имеется:

       Tue Mar 22 13:11:31 PDT 2011 MyClass fatal
       SEVERE: several message with an exception
       java.lang.IllegalArgumentException: invalid argument
               at MyClass.mash(MyClass.java:9)
               at MyClass.crunch(MyClass.java:6)
               at MyClass.main(MyClass.java:3)
       

• java.util.logging.SimpleFormatter.format="%1$tb %1$td, %1$tY %1$tl:%1$tM:%1$tS %1$Tp %2$s%n%4$s: %5$s%n"

  Выводит 2 строки, аналогичные предыдущему примеру, с другим форматированием даты/времени и не выводит исключение и его трассировку:

       Mar 22, 2011 1:11:31 PM MyClass fatal
       SEVERE: several message with an exception
       

• java.util.logging.SimpleFormatter.format="%1$tb %1$td, %1$tY %1$tl:%1$tM:%1$tS.%1$tN %1$Tp %2$s%n%4$s: %5$s%6$s%n"

  Начиная с JDK 9, java.util.logging использует java.time для создания более точных меток времени. В приведенном выше формате можно добавить .%1$tN к форматированию даты/времени, чтобы напечатать также наносекунды:

       Feb 06, 2015 5:33:10.279216000 PM example.Main main
       INFO: This is a test
       

Этот метод также можно переопределить в подклассе. Рекомендуется использовать удобный метод Formatter.formatMessage(java.util.logging.LogRecord) для локализации и форматирования поля сообщения.