Класс 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 — строка, представляющая исключение, связанное с записью журнала, и его трассировку стека, начинающуюся с символа новой строки, если они имеются; в противном случае — пустая строка.

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

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

  Выводит одну строку с уровнем ведения журнала (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"

  Выводит две строки: первая содержит временную метку (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"

  Выводит две строки, аналогичные примеру выше, но с другим форматом даты и времени; исключение и его трассировка стека не выводятся:

      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(LogRecord).