Класс SimpleFormatter

public class SimpleFormatter
extends Formatter

Выводит краткое описание LogRecord в удобочитаемом формате. Обычно это 1 или 2 строки.

Настройка: SimpleFormatter инициализируется строкой формата, указанной в свойстве java.util.logging.SimpleFormatter.format, чтобы форматировать сообщения журнала. Это свойство может быть определено в файле конфигурации свойств ведения журнала или в качестве системного свойства. Если это свойство установлено как в свойствах ведения журнала, так и в системных свойствах, будет использована строка формата, указанная в системном свойстве. Если это свойство не определено или указанная строка формата является некорректной, используется формат по умолчанию, специфичный для реализации.

Since:
1.4
См. также:
Formatter

Конструкторы

Конструктор Описание
SimpleFormatter()

Методы

Модификатор и тип Метод Описание
String format​(LogRecord record)

Форматирует заданный LogRecord.

Методы, объявленные в классе java.util.logging.Formatter

formatMessage, getHead, getTail

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструкторы

SimpleFormatter

public SimpleFormatter()

Методы

format

public String format(LogRecord record)

Форматирует заданный LogRecord.

Форматирование можно настроить, указав строку формата в свойстве 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"

    Выводит 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) для локализации и форматирования поля сообщения.

Определено в:
format в классе Formatter
Параметры:
record - запись журнала для форматирования.
Возвращает:
отформатированная запись журнала

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.logging/java/util/logging/SimpleFormatter.html

Spec-Zone .ru
спецификации, руководства, описания, API