Package java.util.logging

Class LogRecord

java.lang.Object
java.util.logging.LogRecord
All Implemented Interfaces:
Serializable
public class LogRecord
extends Object
implements Serializable
A LogRecord object represents a logging request. It is passed between the logging framework and individual logging handlers. Client applications should not modify a LogRecord object that has been passed into the logging framework.

The LogRecord class will infer the source method name and source class name the first time they are accessed if the client application didn't specify them explicitly. This automatic inference is based on the analysis of the call stack and is not guaranteed to be precise. Client applications should force the initialization of these two fields by calling getSourceClassName or getSourceMethodName if they expect to use them after passing the LogRecord object to another thread or transmitting it over RMI.

See Also:
Serialized Form

  • Constructor Details

    • LogRecord

      public LogRecord​(Level level, String msg)
      Constructs a LogRecord object using the supplied the logging level and message. The millis property is set to the current time. The sequence property is set to a new unique value, allocated in increasing order within the VM. The thread ID is set to a unique value for the current thread. All other properties are set to null.
      Parameters:
      level - the logging level, may not be null.
      msg - the raw message.
      Throws:
      NullPointerException - if level is null.

  • Method Details

    • getLevel

      public Level getLevel()
      Gets the logging level.
      Returns:
      the logging level.

    • setLevel

      public void setLevel​(Level level)
      Sets the logging level.
      Parameters:
      level - the level to set.
      Throws:
      NullPointerException - if level is null.

    • getLoggerName

      public String getLoggerName()
      Gets the name of the logger.
      Returns:
      the logger name.

    • setLoggerName

      public void setLoggerName​(String loggerName)
      Sets the name of the logger.
      Parameters:
      loggerName - the logger name to set.

    • getMessage

      public String getMessage()
      Gets the raw message.
      Returns:
      the raw message, may be null.

    • setMessage

      public void setMessage​(String message)
      Sets the raw message. When this record is formatted by a logger that has a localization resource bundle that contains an entry for message, then the raw message is replaced with its localized version.
      Parameters:
      message - the raw message to set, may be null.

    • getMillis

      public long getMillis()
      Gets the time when this event occurred, in milliseconds since 1970.
      Returns:
      the time when this event occurred, in milliseconds since 1970.

    • setMillis

      public void setMillis​(long millis)
      Sets the time when this event occurred, in milliseconds since 1970.
      Parameters:
      millis - the time when this event occurred, in milliseconds since 1970.

    • getParameters

      public Object[] getParameters()
      Gets the parameters.
      Returns:
      the array of parameters or null if there are no parameters.

    • setParameters

      public void setParameters​(Object[] parameters)
      Sets the parameters.
      Parameters:
      parameters - the array of parameters to set, may be null.

    • getResourceBundle

      public ResourceBundle getResourceBundle()
      Gets the resource bundle used to localize the raw message during formatting.
      Returns:
      the associated resource bundle, null if none is available or the message is not localizable.

    • setResourceBundle

      public void setResourceBundle​(ResourceBundle resourceBundle)
      Sets the resource bundle used to localize the raw message during formatting.
      Parameters:
      resourceBundle - the resource bundle to set, may be null.

    • getResourceBundleName

      public String getResourceBundleName()
      Gets the name of the resource bundle.
      Returns:
      the name of the resource bundle, null if none is available or the message is not localizable.

    • setResourceBundleName

      public void setResourceBundleName​(String resourceBundleName)
      Sets the name of the resource bundle.
      Parameters:
      resourceBundleName - the name of the resource bundle to set.

    • getSequenceNumber

      public long getSequenceNumber()
      Gets the sequence number.
      Returns:
      the sequence number.

    • setSequenceNumber

      public void setSequenceNumber​(long sequenceNumber)
      Sets the sequence number. It is usually not necessary to call this method to change the sequence number because the number is allocated when this instance is constructed.
      Parameters:
      sequenceNumber - the sequence number to set.

    • getSourceClassName

      public String getSourceClassName()
      Gets the name of the class that is the source of this log record. This information can be changed, may be null and is untrusted.
      Returns:
      the name of the source class of this log record (possiblity null)

    • setSourceClassName

      public void setSourceClassName​(String sourceClassName)
      Sets the name of the class that is the source of this log record.
      Parameters:
      sourceClassName - the name of the source class of this log record, may be null.

    • getSourceMethodName

      public String getSourceMethodName()
      Gets the name of the method that is the source of this log record.
      Returns:
      the name of the source method of this log record.

    • setSourceMethodName

      public void setSourceMethodName​(String sourceMethodName)
      Sets the name of the method that is the source of this log record.
      Parameters:
      sourceMethodName - the name of the source method of this log record, may be null.

    • getThreadID

      public int getThreadID()
      Gets a unique ID of the thread originating the log record. Every thread becomes a different ID.

      Notice : the ID doesn't necessary map the OS thread ID

      Returns:
      the ID of the thread originating this log record.

    • setThreadID

      public void setThreadID​(int threadID)
      Sets the ID of the thread originating this log record.
      Parameters:
      threadID - the new ID of the thread originating this log record.

    • getThrown

      public Throwable getThrown()
      Gets the Throwable object associated with this log record.
      Returns:
      the Throwable object associated with this log record.

    • setThrown

      public void setThrown​(Throwable thrown)
      Sets the Throwable object associated with this log record.
      Parameters:
      thrown - the new Throwable object to associate with this log record.