compact1, compact2, compact3

java.util.logging

Class SimpleFormatter

java.lang.Object

java.util.logging.Formatter

java.util.logging.SimpleFormatter

public class SimpleFormatter
extends Formatter

以人类可读格式打印LogRecord的简要摘要。 摘要通常为1或2行。

Configuration:的SimpleFormatter被初始化与format string在指定java.util.logging.SimpleFormatter.format属性format日志消息。 该属性可以在logging properties配置文件中定义或作为系统属性定义。 如果在记录属性和系统属性中设置此属性，则将使用系统属性中指定的格式字符串。 如果未定义此属性或给定格式字符串为illegal ，则默认格式为实现特定。

从以下版本开始：

1.4

另请参见：

Formatter

构造方法摘要

构造方法

Constructor and Description
SimpleFormatter()

方法摘要

Modifier and Type	Method and Description
String	format(LogRecord record) 格式化给定的LogRecord。

Methods inherited from class java.util.logging.Formatter

formatMessage, getHead, getTail

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

SimpleFormatter

public SimpleFormatter()

方法详细信息

format

public String format(LogRecord record)

格式化给定的LogRecord。

该格式可以通过指定定制format string在java.util.logging.SimpleFormatter.format财产。 给定的LogRecord将格式化为通过调用：

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

其中的论点是：

1. format - 在java.util.logging.SimpleFormatter.format属性中指定的java.util.Formatter格式字符串或默认格式。
2. date - 一个Date对象，代表日志记录的event time 。
3. source - 表示呼叫者的字符串（如果可用） 否则，记录器的名称。
4. logger - 记录器的名称。
5. level - log level 。
6. message - 从Formatter.formatMessage(LogRecord)方法返回的格式化的日志消息。 它使用java.text格式化，不使用java.util.Formatter format参数。
7. thrown -代表一个字符串throwable与日志记录和它的跟踪与换行符开始，如果有相关的; 否则，一个空字符串。

一些示例格式：

• java.util.logging.SimpleFormatter.format="%4$s: %5$s [%1$tc]%n"

  这将以方括号中的日志级别（ 4$ ），日志消息（ 5$ ）和时间戳（ 1$ ）打印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"

  这样打印出与上述示例类似的两行，并使用不同的日期/时间格式化，并且不会打印可抛出物体及其回溯：

    Mar 22, 2011 1:11:31 PM MyClass fatal
       SEVERE: several message with an exception 

这个方法也可以在一个子类中被覆盖。 建议使用Formatter.formatMessage(java.util.logging.LogRecord)方便的方法来本地化和格式化消息字段。

Specified by:

format在类别 Formatter

参数

record - 要格式化的日志记录。

结果

格式化的日志记录