java.util.logging
類別 LogRecord

java.lang.Object
  java.util.logging.LogRecord

所有已實作的介面：

Serializable

public class LogRecord
extends Object
implements Serializable

LogRecord 物件用於在日誌框架和單個日誌 Handler 之間傳遞日誌請求。

將 LogRecord 傳遞到日誌框架中後，它在邏輯上已經屬於該框架，客戶端應用程序不應再使用或更新它。

注意，如果客戶端應用程序尚未顯式指定源方法名和源類別名，則 LogRecord 類別將在第一次存取它們時通過解析調用堆疊(stack)空間來自動推導（根據對 getSourceMethodName 或 getSourceClassName 的調用）。因此，如果日誌 Handler 要將 LogRecord 傳遞給另一個執行緒或者通過 RMI 傳輸它，並且如果它希望後續獲取方法名或類別名資訊，則其應該調用 getSourceClassName 和 getSourceMethodName 的其中之一來強制將值填入。

序列化注意事項：

• LogRecord 類別是可序列化的。
• 因為參數陣列中的物件可能不可序列化，所以在序列化過程中，應該寫入參數陣列中所有物件的相應 String（使用 Object.toString）。
• ResourceBundle 不是作為序列化形式的一部分傳輸的，但是資源套件的名稱是，而接收物件的 readObject 方法將嘗試尋找合適的資源套件。

從以下版本開始：

1.4

另請參見：

序列化表格

建構子摘要

LogRecord(Level level, String msg)
用給定級別和訊息值建構 LogRecord。

方法摘要

Level	getLevel() 獲取日誌訊息級別，例如 Level.SEVERE。
String	getLoggerName() 獲取源 Logger 名稱
String	getMessage() 獲取本地化或格式化之前的“原始”日誌訊息。
long	getMillis() 獲取自從 1970 年以毫秒為單位的事件時間。
Object[]	getParameters() 獲取日誌訊息的參數。
ResourceBundle	getResourceBundle() 獲取本地化資源套件。
String	getResourceBundleName() 獲取本地化資源套件名稱。
long	getSequenceNumber() 獲取序列號。
String	getSourceClassName() 獲取發出日誌請求的類別的名稱。
String	getSourceMethodName() 獲取（可能）發出日誌請求的方法的名稱。
int	getThreadID() 獲取產生訊息的執行緒的標識符。
Throwable	getThrown() 獲取與日誌記錄相關聯的所有 throwable。
void	setLevel(Level level) 設置日誌訊息級別，例如 Level.SEVERE。
void	setLoggerName(String name) 設置源 Logger 名稱。
void	setMessage(String message) 設置本地化或格式化之前的“原始”日誌訊息。
void	setMillis(long millis) 設置事件時間。
void	setParameters(Object[] parameters) 設置日誌訊息的參數。
void	setResourceBundle(ResourceBundle bundle) 設置本地化資源套件。
void	setResourceBundleName(String name) 設置本地化資源套件名稱。
void	setSequenceNumber(long seq) 設置序列號。
void	setSourceClassName(String sourceClassName) 設置（可能）發出日誌請求的類別的名稱。
void	setSourceMethodName(String sourceMethodName) 設置（可能）發出日誌請求的方法的名稱。
void	setThreadID(int threadID) 設置產生訊息的執行緒的標識符。
void	setThrown(Throwable thrown) 設置與日誌事件相關聯的 throwable。

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

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

建構子詳細資訊

LogRecord

public LogRecord(Level level,
                 String msg)

用給定級別和訊息值建構 LogRecord。

使用新的唯一值初始化序列屬性。這些序列值在 VM 中以升序進行分派。

將該 millis 屬性初始化為當前時間。

使用當前執行緒的唯一 ID 初始化該執行緒的 ID 屬性。

將所有其他屬性初始化為 "null"。

參數：

level - 日誌級別值

msg - 原始的非本地化日誌訊息（可以為 null）

方法詳細資訊

getLoggerName

public String getLoggerName()

獲取源 Logger 名稱

返回：

源 logger 名稱（可以為 null）

setLoggerName

public void setLoggerName(String name)

設置源 Logger 名稱。

參數：

name - 源 logger 名稱（可以為 null）

getResourceBundle

public ResourceBundle getResourceBundle()

獲取本地化資源套件。

這是用於本地化訊息字元串（格式化前）的 ResourceBundle。如果訊息是不可本地化的或者沒有合適的 ResourceBundle 可用，則結果可能為 null。

setResourceBundle

public void setResourceBundle(ResourceBundle bundle)

設置本地化資源套件。

參數：

bundle - 本地化包（可以為 null）

getResourceBundleName

public String getResourceBundleName()

獲取本地化資源套件名稱。

這是用於本地化訊息字元串（格式化前）的 ResourceBundle 的名稱。如果訊息是不可本地化的，則結果可能為 null。

setResourceBundleName

public void setResourceBundleName(String name)

設置本地化資源套件名稱。

參數：

name - 本地化套件名稱（可以為 null）

getLevel

public Level getLevel()

獲取日誌訊息級別，例如 Level.SEVERE。

返回：

日誌訊息級別

setLevel

public void setLevel(Level level)

設置日誌訊息級別，例如 Level.SEVERE。

參數：

level - 日誌訊息級別

getSequenceNumber

public long getSequenceNumber()

獲取序列號。

序列號通常是在 LogRecord 建構子中分派的，該建構子按升序為每個新 LogRecord 分派一個唯一的序列號。

返回：

序列號

setSequenceNumber

public void setSequenceNumber(long seq)

設置序列號。

序列號通常是在 LogRecord 建構子中分派的，所以一般不必使用這一方法。

getSourceClassName

public String getSourceClassName()

獲取發出日誌請求的類別的名稱。

注意，此 sourceClassName 未經過驗證，可能是欺騙的。此資訊可以作為日誌調用的一部分提供，也可以通過日誌框架自動推導。在後一種情況下，資訊可能只是近似的，實際上可能描述的是堆疊(stack)訊框上的較早調用。

如果未能獲取任何資訊，則返回 null。

返回：

源類別名

setSourceClassName

public void setSourceClassName(String sourceClassName)

設置（可能）發出日誌請求的類別的名稱。

參數：

sourceClassName - 源類別名（可以為 null）

getSourceMethodName

public String getSourceMethodName()

獲取（可能）發出日誌請求的方法的名稱。

注意，此 sourceMethodName 未經過驗證，可能是欺騙的。此資訊可以作為日誌調用的一部分提供，也可以通過日誌框架自動推導。在後一種情況下，資訊可能只是近似的，實際上可能描述的是堆疊(stack)訊框上的較早調用。

如果未能獲取任何資訊，則返回 null。

返回：

源方法名

setSourceMethodName

public void setSourceMethodName(String sourceMethodName)

設置（可能）發出日誌請求的方法的名稱。

參數：

sourceMethodName - 源方法名（可以為 null）

getMessage

public String getMessage()

獲取本地化或格式化之前的“原始”日誌訊息。

可能為 null，該值等效於空字元串 ""。

此訊息可能是最終文本或本地化鍵。

在格式化期間，如果源 logger 具有本地化 ResourceBundle 並且該 ResourceBundle 具有此訊息字元串的條目，則使用本地化值替換該訊息字元串。

返回：

原始訊息字元串

setMessage

public void setMessage(String message)

設置本地化或格式化之前的“原始”日誌訊息。

參數：

message - 原始訊息字元串（可以為 null）

getParameters

public Object[] getParameters()

獲取日誌訊息的參數。

返回：

日誌訊息參數。如果沒有參數，則可能為 null。

setParameters

public void setParameters(Object[] parameters)

設置日誌訊息的參數。

參數：

parameters - 日誌訊息參數。（可以為 null）

getThreadID

public int getThreadID()

獲取產生訊息的執行緒的標識符。

它是 Java VM 中的執行緒標識符，可能映射也可能不映射到任何作業系統 ID 中。

返回：

執行緒 ID

setThreadID

public void setThreadID(int threadID)

設置產生訊息的執行緒的標識符。

參數：

threadID - 執行緒 ID

getMillis

public long getMillis()

獲取自從 1970 年以毫秒為單位的事件時間。

返回：

自從 1970 年以 millis 為單位的事件時間

setMillis

public void setMillis(long millis)

設置事件時間。

參數：

自從 - 1970 年以 millis 為單位的事件時間

getThrown

public Throwable getThrown()

獲取與日誌記錄相關聯的所有 throwable。

如果涉及異常，則此為異常物件。否則為 null。

返回：

一個 throwable

setThrown

public void setThrown(Throwable thrown)

設置與日誌事件相關聯的 throwable。

參數：

thrown - throwable（可以為 null）