Класс 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- объектDate, представляющий время события записи журнала. -
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 exception
Этот метод также может быть переопределен в подклассе. Рекомендуется использовать удобный метод 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.