public class LogRecord
extends Object implements Serializable
| java.lang.Object | |
| ↳ | java.util.logging.LogRecord |
LogRecord对象用于在日志记录框架和各个日志处理程序之间传递日志记录请求。
当LogRecord传入日志框架时，它在逻辑上属于框架，不应再由客户端应用程序使用或更新。
请注意，如果客户端应用程序未指定明确的源方法名称和源类名称，则LogRecord类将在通过分析调用堆栈第一次访问（由于调用getSourceMethodName或getSourceClassName）时自动推断它们。 因此，如果日志记录处理程序想要将LogRecord传递给另一个线程，或者通过RMI传输它，并且如果它希望随后获取方法名称或类名称信息，则它应该调用getSourceClassName或getSourceMethodName中的一个来强制值为填写。
序列化注意事项：
Public constructors |
|
|---|---|
LogRecord(Level level, String msg) 用给定的级别和消息值构造一个LogRecord。 |
|
Public methods |
|
|---|---|
Level |
getLevel() 获取日志消息级别，例如Level.SEVERE。 |
String |
getLoggerName() 获取源记录器的名称。 |
String |
getMessage() 在本地化或格式化之前获取“原始”日志消息。 |
long |
getMillis() 获取自1970年以来的活动时间以毫秒为单位。 |
Object[] |
getParameters() 获取日志消息的参数。 |
ResourceBundle |
getResourceBundle() 获取本地化资源包 这是在格式化之前应该用于本地化消息字符串的ResourceBundle。 |
String |
getResourceBundleName() 获取本地化资源包名称 这是ResourceBundle的名称，应该用于在格式化消息字符串之前对其进行本地化。 |
long |
getSequenceNumber() 获取序列号。 |
String |
getSourceClassName() 获取（据称）发布日志请求的类的名称。 |
String |
getSourceMethodName() 获取（据称）发出日志请求的方法的名称。 |
int |
getThreadID() 获取消息始发线程的标识符。 |
Throwable |
getThrown() 获取与日志记录关联的任何throwable。 |
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) 设置与日志事件关联的throwable。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
LogRecord (Level level, String msg)
用给定的级别和消息值构造一个LogRecord。
序列属性将使用新的唯一值进行初始化。 这些序列值在VM内按升序分配。
毫米的财产将被初始化为当前时间。
线程ID属性将使用当前线程的唯一标识进行初始化。
所有其他属性将被初始化为“null”。
| Parameters | |
|---|---|
level |
Level: a logging level value |
msg |
String: the raw non-localized logging message (may be null) |
Level getLevel ()
获取日志消息级别，例如Level.SEVERE。
| Returns | |
|---|---|
Level |
the logging message level |
String getLoggerName ()
获取源记录器的名称。
| Returns | |
|---|---|
String |
source logger name (may be null) |
String getMessage ()
在本地化或格式化之前获取“原始”日志消息。
可能为空，相当于空字符串“”。
此消息可能是最终文本或本地化密钥。
在格式化期间，如果源记录器具有本地化ResourceBundle，并且该ResourceBundle具有此消息字符串的条目，则消息字符串将替换为本地化值。
| Returns | |
|---|---|
String |
the raw message string |
long getMillis ()
获取自1970年以来的活动时间以毫秒为单位。
| Returns | |
|---|---|
long |
event time in millis since 1970 |
Object[] getParameters ()
获取日志消息的参数。
| Returns | |
|---|---|
Object[] |
the log message parameters. May be null if there are no parameters. |
ResourceBundle getResourceBundle ()
获取本地化资源包
这是在格式化之前应该用于本地化消息字符串的ResourceBundle。 如果消息不可本地化，或者没有合适的ResourceBundle可用，结果可能为空。
| Returns | |
|---|---|
ResourceBundle |
|
String getResourceBundleName ()
获取本地化资源包名称
这是ResourceBundle的名称，应该用于在格式化消息字符串之前对其进行本地化。 如果消息不可本地化，结果可能为空。
| Returns | |
|---|---|
String |
|
long getSequenceNumber ()
获取序列号。
序列号通常在LogRecord构造函数中进行赋值，该构造函数按升序为每个新的LogRecord分配唯一的序号。
| Returns | |
|---|---|
long |
the sequence number |
String getSourceClassName ()
获取（据称）发布日志请求的类的名称。
请注意，此sourceClassName未经过验证，可能会被欺骗。 这些信息可以作为日志调用的一部分提供，也可以由日志框架自动推断出来。 在后一种情况下，信息可能只是近似的，并且实际上可能会描述堆栈帧上的较早呼叫。
如果无法获得信息，则可能为空。
| Returns | |
|---|---|
String |
the source class name |
String getSourceMethodName ()
获取（据称）发出日志请求的方法的名称。
请注意，此sourceMethodName未验证，可能是欺骗性的。 这些信息可以作为日志调用的一部分提供，也可以由日志框架自动推断出来。 在后一种情况下，信息可能只是近似的，并且实际上可能会描述堆栈帧上的较早呼叫。
如果无法获得信息，则可能为空。
| Returns | |
|---|---|
String |
the source method name |
int getThreadID ()
获取消息始发线程的标识符。
这是Java VM中的线程标识符，可能映射到或不映射到任何操作系统标识。
| Returns | |
|---|---|
int |
thread ID |
Throwable getThrown ()
获取与日志记录关联的任何throwable。
如果事件涉及异常，则这将是异常对象。 否则为空。
| Returns | |
|---|---|
Throwable |
a throwable |
void setLevel (Level level)
设置日志消息级别，例如Level.SEVERE。
| Parameters | |
|---|---|
level |
Level: the logging message level |
void setLoggerName (String name)
设置源记录器的名称。
| Parameters | |
|---|---|
name |
String: the source logger name (may be null) |
void setMessage (String message)
在本地化或格式化之前设置“原始”日志消息。
| Parameters | |
|---|---|
message |
String: the raw message string (may be null) |
void setMillis (long millis)
设置活动时间。
| Parameters | |
|---|---|
millis |
long: event time in millis since 1970 |
void setParameters (Object[] parameters)
将参数设置为日志消息。
| Parameters | |
|---|---|
parameters |
Object: the log message parameters. (may be null) |
void setResourceBundle (ResourceBundle bundle)
设置本地化资源包。
| Parameters | |
|---|---|
bundle |
ResourceBundle: localization bundle (may be null) |
void setResourceBundleName (String name)
设置本地化资源包名称。
| Parameters | |
|---|---|
name |
String: localization bundle name (may be null) |
void setSequenceNumber (long seq)
设置序列号。
序列号通常在LogRecord构造函数中分配，因此通常不需要使用此方法。
| Parameters | |
|---|---|
seq |
long
|
void setSourceClassName (String sourceClassName)
设置（据称）发布日志请求的类的名称。
| Parameters | |
|---|---|
sourceClassName |
String: the source class name (may be null) |
void setSourceMethodName (String sourceMethodName)
设置（据称）发出日志记录请求的方法的名称。
| Parameters | |
|---|---|
sourceMethodName |
String: the source method name (may be null) |
void setThreadID (int threadID)
设置消息始发线程的标识符。
| Parameters | |
|---|---|
threadID |
int: the thread ID |
void setThrown (Throwable thrown)
设置与日志事件关联的throwable。
| Parameters | |
|---|---|
thrown |
Throwable: a throwable (may be null) |
Android开发手册