public abstract class Formatter
extends Object
java.lang.Object | |
↳ | java.util.logging.Formatter |
Known Direct Subclasses |
格式化程序提供格式化LogRecords的支持。
通常,每个日志记录处理程序都会有一个与之关联的格式化程序 格式化程序需要一个LogRecord并将其转换为一个字符串。
某些格式化程序(如XMLFormatter)需要将头尾字符串包装在一组格式化的记录中。 getHeader和getTail方法可用于获取这些字符串。
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
|
String format (LogRecord record)
格式化给定的日志记录并返回格式化的字符串。
生成的格式化字符串通常会包含LogRecord消息字段的本地化和格式化版本。 建议使用formatMessage(LogRecord)
便捷方法来定位和格式化消息字段。
Parameters | |
---|---|
record |
LogRecord : the log record to be formatted. |
Returns | |
---|---|
String |
the formatted log record |
String formatMessage (LogRecord record)
从日志记录本地化和格式化消息字符串。 提供此方法是为了便于Formatter子类在执行格式化时使用。
消息字符串首先使用记录的ResourceBundle本地化为格式字符串。 (如果没有ResourceBundle,或者找不到消息键,则该键用作格式字符串。)格式String使用java.text样式格式。
Parameters | |
---|---|
record |
LogRecord : the log record containing the raw message |
Returns | |
---|---|
String |
a localized and formatted message |
String getHead (Handler h)
返回一组格式化记录的标题字符串。
这个基类返回一个空字符串,但是这可能会被子类覆盖。
Parameters | |
---|---|
h |
Handler : The target handler (can be null) |
Returns | |
---|---|
String |
header string |
String getTail (Handler h)
返回一组格式化记录的尾部字符串。
这个基类返回一个空字符串,但是这可能会被子类覆盖。
Parameters | |
---|---|
h |
Handler : The target handler (can be null) |
Returns | |
---|---|
String |
tail string |