Класс SimpleFormatter
- java.lang.Object
-
- java.util.logging.Formatter
-
- java.util.logging.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);
где аргументы:
-
format-java.util.Formatterстрока формата, заданная в свойствеjava.util.logging.SimpleFormatter.format, или по умолчанию. -
date- объектZonedDateTime, представляющий время события записи журнала в часовом поясе системыZoneId.systemDefault(). -
source- строка, представляющая вызывающий элемент, если доступно; в противном случае - имя регистратора. -
logger- имя регистратора. -
level- уровень журнала. -
message- отформатированное сообщение журнала, возвращенное из методаFormatter.formatMessage(LogRecord). Используется форматированиеjava.text, и аргументjava.util.Formatter formatне используется. -
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 exceptionjava.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) для локализации и форматирования поля сообщения.
© 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