- java.lang.Object
-
- java.util.logging.Formatter
-
- 已知直接子类:
-
SimpleFormatter
,XMLFormatter
public abstract class Formatter extends Object
Formatter支持格式化LogRecords。通常,每个日志记录处理程序都有一个与之关联的Formatter。 Formatter采用LogRecord并将其转换为字符串。
某些格式化程序(例如XMLFormatter)需要在一组格式化记录周围包装head和tail字符串。 getHeader和getTail方法可用于获取这些字符串。
- 从以下版本开始:
- 1.4
-
-
构造方法摘要
构造方法 变量 构造器 描述 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样式格式。
- 如果没有参数,则不使用格式化程序。
- 否则,如果字符串包含“{<digit>”,其中<digit>在[0-9]中,则使用java.text.MessageFormat格式化字符串。
- 否则不执行格式化。
- 参数
-
record
- 包含原始消息的日志记录 - 结果
- 本地化和格式化的消息
-
-