src/java.logging/share/classes/java/util/logging/LogRecord.java

Print this page




  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package java.util.logging;
  27 import java.time.Instant;
  28 import java.util.*;
  29 import java.util.concurrent.atomic.AtomicInteger;
  30 import java.util.concurrent.atomic.AtomicLong;
  31 import java.io.*;
  32 import java.time.Clock;
  33 
  34 import sun.misc.JavaLangAccess;
  35 import sun.misc.SharedSecrets;
  36 
  37 /**
  38  * LogRecord objects are used to pass logging requests between
  39  * the logging framework and individual log Handlers.
  40  * <p>
  41  * When a LogRecord is passed into the logging framework it
  42  * logically belongs to the framework and should no longer be
  43  * used or updated by the client application.
  44  * <p>
  45  * Note that if the client application has not specified an
  46  * explicit source method name and source class name, then the
  47  * LogRecord class will infer them automatically when they are
  48  * first accessed (due to a call on getSourceMethodName or
  49  * getSourceClassName) by analyzing the call stack.  Therefore,
  50  * if a logging Handler wants to pass off a LogRecord to another
  51  * thread, or to transmit it over RMI, and if it wishes to subsequently
  52  * obtain method name or class name information it should call
  53  * one of getSourceClassName or getSourceMethodName to force
  54  * the values to be filled in.
  55  * <p>




  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package java.util.logging;
  27 import java.time.Instant;
  28 import java.util.*;
  29 import java.util.concurrent.atomic.AtomicInteger;
  30 import java.util.concurrent.atomic.AtomicLong;
  31 import java.io.*;
  32 import java.time.Clock;
  33 
  34 import jdk.internal.misc.JavaLangAccess;
  35 import jdk.internal.misc.SharedSecrets;
  36 
  37 /**
  38  * LogRecord objects are used to pass logging requests between
  39  * the logging framework and individual log Handlers.
  40  * <p>
  41  * When a LogRecord is passed into the logging framework it
  42  * logically belongs to the framework and should no longer be
  43  * used or updated by the client application.
  44  * <p>
  45  * Note that if the client application has not specified an
  46  * explicit source method name and source class name, then the
  47  * LogRecord class will infer them automatically when they are
  48  * first accessed (due to a call on getSourceMethodName or
  49  * getSourceClassName) by analyzing the call stack.  Therefore,
  50  * if a logging Handler wants to pass off a LogRecord to another
  51  * thread, or to transmit it over RMI, and if it wishes to subsequently
  52  * obtain method name or class name information it should call
  53  * one of getSourceClassName or getSourceMethodName to force
  54  * the values to be filled in.
  55  * <p>