public class LogRecord extends Object implements Serializable
当LogRecord被传递到日志框架中时,逻辑上属于框架,不应再被客户端应用程序使用或更新。
请注意,如果客户端应用程序尚未指定明确的源代码方法名称和源类名称,则LogRecord类将在首次访问(通过调用getSourceMethodName或getSourceClassName)时自动推断出它们,方法是分析调用堆栈。 因此,如果记录处理程序希望将LogRecord传递到另一个线程,或者通过RMI传输,并且如果希望随后获取方法名称或类名称信息,则应调用getSourceClassName或getSourceMethodName之一来强制将值填写。
序列化注释:
| Modifier and Type | Method and Description | 
|---|---|
| Level | getLevel()
              获取日志消息级别,例如Level.SEVERE。 
             | 
| String | getLoggerName()
              获取源记录器的名称。 
             | 
| String | getMessage()
              在本地化或格式化之前获取“原始”日志消息。 
             | 
| long | getMillis()
              自1970年以来,以毫秒为单位获得活动时间。 
             | 
| Object[] | getParameters()
              获取日志消息的参数。 
             | 
| ResourceBundle | getResourceBundle()
              获取本地化资源包 
             | 
| String | getResourceBundleName()
              获取本地化资源包名称 
             | 
| long | getSequenceNumber()
              获取序列号。 
             | 
| String | getSourceClassName()
              获取(据称)发出日志记录请求的类的名称。 
             | 
| String | getSourceMethodName()
              获取(据称)发出日志记录请求的方法的名称。 
             | 
| int | getThreadID()
              获取消息发起的线程的标识符。 
             | 
| Throwable | getThrown()
              获取与日志记录相关联的任何可抛出的值。 
             | 
| void | setLevel(Level level)
              设置日志消息级别,例如Level.SEVERE。 
             | 
| void | setLoggerName(String name)
              设置源记录器的名称。 
             | 
| 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)
              设置与日志事件相关联的可抛出。 
             | 
public String getLoggerName()
public void setLoggerName(String name)
name - 源记录器名称(可以为空) 
           public ResourceBundle getResourceBundle()
这是ResourceBundle,它应该用于在格式化之前本地化消息字符串。 如果消息不可本地化,或者没有合适的ResourceBundle可用,则结果可能为null。
public void setResourceBundle(ResourceBundle bundle)
bundle - 本地化捆绑(可能为null) 
           public String getResourceBundleName()
这是ResourceBundle的名称,它应该用于在格式化之前本地化消息字符串。 如果消息不可本地化,结果可能为null。
public void setResourceBundleName(String name)
name - 本地化包名称(可以为空) 
           public Level getLevel()
public void setLevel(Level level)
level - 日志消息级别 
           public long getSequenceNumber()
序列号通常在LogRecord构造函数中分配,它以增加的顺序为每个新的LogRecord分配唯一的序列号。
public void setSequenceNumber(long seq)
序列号通常在LogRecord构造函数中分配,因此通常不需要使用此方法。
seq - 序列号 
           public String getSourceClassName()
请注意,该sourceClassName未经验证,可能会被欺骗。 该信息可能已经作为日志记录调用的一部分提供,也可能由日志框架自动推断。 在后一种情况下,信息可能仅仅是近似的,并且实际上可以描述堆栈帧上的较早的呼叫。
如果不能获得任何信息,可以为null。
public void setSourceClassName(String sourceClassName)
sourceClassName - 源类名(可能为null) 
           public String getSourceMethodName()
请注意,此sourceMethodName未经过验证,可能会被欺骗。 该信息可能已经作为日志记录调用的一部分提供,也可能由日志框架自动推断。 在后一种情况下,信息可能仅仅是近似的,并且实际上可以描述堆栈帧上的较早的呼叫。
如果不能获得任何信息,可以为null。
public void setSourceMethodName(String sourceMethodName)
sourceMethodName - 源方法名称(可以为null) 
           public String getMessage()
可以为空,这相当于空字符串“”。
该消息可以是最终文本或本地化密钥。
在格式化期间,如果源记录器具有本地化ResourceBundle,并且如果该ResourceBundle具有此消息字符串的条目,则消息字符串将替换为本地化值。
public void setMessage(String message)
message - 原始消息字符串(可以为空) 
           public Object[] getParameters()
public void setParameters(Object[] parameters)
parameters - 日志信息参数。 
            (可能为空) 
           public int getThreadID()
这是Java VM中的线程标识符,并且可能映射到或不映射到任何操作系统ID。
public void setThreadID(int threadID)
threadID - 线程ID 
           public long getMillis()
public void setMillis(long millis)
millis - 自1970年以来以毫秒 
            millis事件时间 
           public Throwable getThrown()
如果事件涉及异常,这将是异常对象。 否则为null。
public void setThrown(Throwable thrown)
thrown - 可抛出(可能为空) 
            Submit a bug or feature 
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
 Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.