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 |