Most visited

Recently visited

Added in API level 1

Formatter

public abstract class Formatter
extends Object

java.lang.Object
   ↳ java.util.logging.Formatter
Known Direct Subclasses


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

通常,每个日志记录处理程序都会有一个与之关联的格式化程序 格式化程序需要一个LogRecord并将其转换为一个字符串。

某些格式化程序(如XMLFormatter)需要将头尾字符串包装在一组格式化的记录中。 getHeader和getTail方法可用于获取这些字符串。

Summary

Protected constructors

Formatter()

构建一个新的格式化程序。

Public methods

abstract String format(LogRecord record)

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

String formatMessage(LogRecord record)

从日志记录本地化和格式化消息字符串。

String getHead(Handler h)

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

String getTail(Handler h)

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

Inherited methods

From class java.lang.Object

Protected constructors

Formatter

Added in API level 1
Formatter ()

构建一个新的格式化程序。

Public methods

format

Added in API level 1
String format (LogRecord record)

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

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

Parameters
record LogRecord: the log record to be formatted.
Returns
String the formatted log record

formatMessage

Added in API level 1
String formatMessage (LogRecord record)

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

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

  • If there are no parameters, no formatter is used.
  • Otherwise, if the string contains "{0" then java.text.MessageFormat is used to format the string.
  • Otherwise no formatting is performed.

Parameters
record LogRecord: the log record containing the raw message
Returns
String a localized and formatted message

getHead

Added in API level 1
String getHead (Handler h)

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

这个基类返回一个空字符串,但是这可能会被子类覆盖。

Parameters
h Handler: The target handler (can be null)
Returns
String header string

getTail

Added in API level 1
String getTail (Handler h)

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

这个基类返回一个空字符串,但是这可能会被子类覆盖。

Parameters
h Handler: The target handler (can be null)
Returns
String tail string

Hooray!