compact1, compact2, compact3

java.util.logging

Class Formatter

java.lang.Object

java.util.logging.Formatter

已知直接子类：

SimpleFormatter ， XMLFormatter

public abstract class Formatter
extends Object

格式化程序提供对LogRecords进行格式化的支持。

通常每个记录处理程序都将有一个与它相关联的格式化程序。 格式化器采用LogRecord并将其转换为字符串。

一些格式化器（如XMLFormatter）需要围绕一组格式化的记录包裹头和尾字符串。 getHeader和getTail方法可用于获取这些字符串。

从以下版本开始：

1.4

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	Formatter() 构造一个新的格式化程序

方法摘要

Modifier and Type	Method and Description
abstract String	format(LogRecord record) 格式化给定的日志记录并返回格式化的字符串。
String	formatMessage(LogRecord record) 从日志记录本地化和格式化消息字符串。
String	getHead(Handler h) 返回一组格式化记录的标题字符串。
String	getTail(Handler h) 返回一组格式化记录的尾部字符串。

Methods inherited from class java.lang.Object

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

构造方法详细信息

Formatter

protected Formatter()

构造一个新的格式化程序

方法详细信息

format

public abstract String format(LogRecord record)

格式化给定的日志记录并返回格式化的字符串。

生成的格式化的字符串通常会包含LogRecord消息字段的本地化和格式化版本。 建议使用formatMessage(java.util.logging.LogRecord)方便的方法来定位和格式化消息字段。

参数

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

结果

格式化的日志记录

getHead

public String getHead(Handler h)

返回一组格式化记录的标题字符串。

这个基类返回一个空字符串，但这可以被子类覆盖。

参数

h - 目标处理程序（可以为null）

结果

标题字符串

getTail

public String getTail(Handler h)

返回一组格式化记录的尾部字符串。

这个基类返回一个空字符串，但这可以被子类覆盖。

参数

h - 目标处理程序（可以为null）

结果

尾弦

formatMessage

public String formatMessage(LogRecord record)

从日志记录本地化和格式化消息字符串。 提供此方法作为Formatter子类在执行格式化时使用的方便。

消息字符串首先使用记录的ResourceBundle本地化为格式字符串。 （如果没有ResourceBundle，或者如果没有找到消息键，则将该键用作格式字符串。）格式String使用java.text样式格式化。

• 如果没有参数，则不使用格式化器。
• 否则，如果字符串包含“{0”，则使用java.text.MessageFormat格式化字符串。
• 否则不执行格式化。

参数

record - 包含原始消息的日志记录

结果

本地化和格式化的消息