Java java.util.logging 类 LogRecord（JDK5）

139 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.util.logging
类 LogRecord

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

所有已实现的接口：: Serializable

public class LogRecord
extends Object

implements Serializable
extends Object
implements Serializable

LogRecord 对象用于在日志框架和单个日志 Handler 之间传递日志请求。

将 LogRecord 传递到日志框架中后，它在逻辑上已经属于该框架，客户端应用程序不应再使用或更新它。

注意，如果客户端应用程序尚未显式指定源方法名和源类名，则 LogRecord 类将在第一次访问它们时通过分析调用堆栈来自动推导（根据对 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。

返回：: 日志消息级别