|
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, getTailpublic 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