Spec-Zone .ru
спецификации, руководства, описания, API
|
public class SimpleFormatter extends Formatter
LogRecord
в удобочитаемом формате. Сводка обычно будет 1 или 2 строками.
Конфигурация: SimpleFormatter
инициализируется со строкой формата, определенной в java.util.logging.SimpleFormatter.format
свойство, чтобы отформатировать сообщения журнала. Это свойство может быть определено в конфигурационном файле свойств журналирования или как системное свойство. Если это свойство будет установлено и в свойствах журналирования и в системных свойствах, то строка формата, определенная в системном свойстве, будет использоваться. Если это свойство не определяется, или данная строка формата недопустима, формат значения по умолчанию специфичен для реализации.
Formatter
Конструктор и Описание |
---|
SimpleFormatter() |
Модификатор и Тип | Метод и Описание |
---|---|
Строка |
format(LogRecord record)
Отформатируйте данный LogRecord.
|
formatMessage, getHead, getTail
public String format(LogRecord record)
Форматирование может быть настроено, определяя строку формата в
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
- a Date
время события представления объекта записи журнала.source
- строка, представляющая вызывающую сторону, при наличии; иначе, имя регистратора.logger
- имя регистратора.level
- уровень журнала.message
- отформатированное сообщение журнала, возвращенное из Formatter.formatMessage(LogRecord)
метод. Это использует java.text
форматирование и не использует java.util.Formatter format
параметр.thrown
- строка, представляющая throwable, связанный с записью журнала и ее следом, начинающимся с символа новой строки, если любой; иначе, пустая строка.Некоторые форматы в качестве примера:
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$
) сопровождаемый с throwable и его следом (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 строки, подобные примеру выше с различным форматированием даты/времени, и не печатает throwable и его след:
Mar 22, 2011 1:11:31 PM MyClass fatal SEVERE: several message with an exception
Этот метод может также быть переопределен в подклассе. Рекомендуется использовать Formatter.formatMessage(java.util.logging.LogRecord)
метод удобства, чтобы локализовать и отформатировать поле сообщения.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92