java.util.logging
類別 Formatter

java.lang.Object
  java.util.logging.Formatter

直接已知子類別：

SimpleFormatter, XMLFormatter

public abstract class Formatter
extends Object

Formatter 為格式化 LogRecords 提供支持。

一般來說，每個日誌記錄 Handler 都有關聯的 Formatter。Formatter 接受 LogRecord，並將它轉換為一個字元串。

有些 Formatter（如 XMLFormatter）需要圍繞一組格式化記錄來包裹頭部和尾部字元串。可以使用 getHeader 和 getTail 方法來獲得這些字元串。

從以下版本開始：

1.4

建構子摘要

protected

Formatter() 建構一個新的 Formatter。

方法摘要

abstract String	format(LogRecord record) 格式化給定的日誌記錄，並返回格式化後的字元串。
String	formatMessage(LogRecord record) 本地化和格式化來自日誌記錄的訊息字元串。
String	getHead(Handler h) 返回一組格式化記錄的頭部字元串。
String	getTail(Handler h) 返回一組格式化記錄的尾部字元串。

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

Formatter

protected Formatter()

建構一個新的 Formatter。

方法詳細資訊

format

public abstract String format(LogRecord record)

格式化給定的日誌記錄，並返回格式化後的字元串。

得到的格式化 String 通常包括 LogRecord 訊息欄位的本地化和格式化版本。Formatter.formatMessage 這個便捷方法可以（可選）用來本地化和格式化訊息欄位。

參數：

record - 要格式化的日誌記錄。

返回：

格式化的日誌記錄

getHead

public String getHead(Handler h)

返回一組格式化記錄的頭部字元串。

此基礎類別返回一個空字元串，但是它可以通過子類別進行覆寫。

參數：

h - 目標 handler（可以為 null）

返回：

頭部字元串

getTail

public String getTail(Handler h)

返回一組格式化記錄的尾部字元串。

此基礎類別返回一個空字元串，但是它可以通過子類別進行覆寫。

參數：

h - 目標 handler（可以為 null）

返回：

尾部字元串

formatMessage

public String formatMessage(LogRecord record)

本地化和格式化來自日誌記錄的訊息字元串。在 Formatter 子類別執行格式化時，此方法可以作為一種便捷方法使用。

首先使用記錄的 ResourceBundle 將訊息字元串本地化為格式字元串。（如果不存在 ResourceBundle，或沒有找到訊息鍵，則將該鍵用作格式字元串。）格式 String 使用 java.text 樣式進行格式化。

• 如果沒有參數，則不使用 Formatter。
• 否則，如果字元串包含 "{0"，則使用 java.text.MessageFormat 來格式化字元串。
• 否則，不執行格式化。

參數：

record - 套件含原始訊息的日誌記錄

返回：

已本地化和格式化的訊息