SimpleFormatter

SimpleFormatter

SimpleFormatter ()

format

String format (LogRecord record)

格式化给定的LogRecord。

可以通过在java.util.logging.SimpleFormatter.format属性中指定format string来自定义格式。 给定的LogRecord将被格式化，就好像通过调用：

    String.format(format, date, source, logger, level, message, thrown);
 

1. format - the java.util.Formatter format string specified in the java.util.logging.SimpleFormatter.format property or the default format.
2. date - a Date object representing event time of the log record.
3. source - a string representing the caller, if available; otherwise, the logger's name.
4. logger - the logger's name.
5. level - the log level.
6. message - the formatted log message returned from the formatMessage(LogRecord) method. It uses java.text formatting and does not use the java.util.Formatter format argument.
7. thrown - a string representing the throwable associated with the log record and its backtrace beginning with a newline character, if any; otherwise, an empty string.

一些示例格式：

• 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
       

这个方法也可以在子类中重写。 建议使用formatMessage(LogRecord)便捷方法来定位和格式化消息字段。