/*

  * Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved.

  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

  *

  * This code is free software; you can redistribute it and/or modify it

  * under the terms of the GNU General Public License version 2 only, as

  * published by the Free Software Foundation.  Oracle designates this

  * particular file as subject to the "Classpath" exception as provided

  * by Oracle in the LICENSE file that accompanied this code.

  *

  * This code is distributed in the hope that it will be useful, but WITHOUT

  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

  * version 2 for more details (a copy is included in the LICENSE file that

  * accompanied this code).

  *

  * You should have received a copy of the GNU General Public License version

  * 2 along with this work; if not, write to the Free Software Foundation,

  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

  *

  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

  * or visit www.oracle.com if you need additional information or have any

  * questions.

  */

 package java.util.logging;

 import java.io.*;

 /**

  * LogRecord objects are used to pass logging requests between

  * the logging framework and individual log Handlers.

  * <p>

  * When a LogRecord is passed into the logging framework it

  * logically belongs to the framework and should no longer be

  * used or updated by the client application.

  * <p>

  * Note that if the client application has not specified an

  * explicit source method name and source class name, then the

  * LogRecord class will infer them automatically when they are

  * first accessed (due to a call on getSourceMethodName or

  * getSourceClassName) by analyzing the call stack.  Therefore,

  * if a logging Handler wants to pass off a LogRecord to another

  * thread, or to transmit it over RMI, and if it wishes to subsequently

  * obtain method name or class name information it should call

  * one of getSourceClassName or getSourceMethodName to force

  * the values to be filled in.

  * <p>

  * <b> Serialization notes:</b>

  * <ul>

  * <li>The LogRecord class is serializable.

  *

  * <li> Because objects in the parameters array may not be serializable,

  * during serialization all objects in the parameters array are

  * written as the corresponding Strings (using Object.toString).

  *

  * <li> The ResourceBundle is not transmitted as part of the serialized

  * form, but the resource bundle name is, and the recipient object's

  * readObject method will attempt to locate a suitable resource bundle.

  *

  * </ul>

  *

  * @since 1.4

  */

 public class LogRecord implements java.io.Serializable {

     private static long globalSequenceNumber = 0;

     /**

      * The default value of threadID will be the current thread's

      * thread id, for ease of correlation, unless it is greater than

      * MIN_SEQUENTIAL_THREAD_ID, in which case we try harder to keep

      * our promise to keep threadIDs unique by avoiding collisions due

      * to 32-bit wraparound.  Unfortunately, LogRecord.getThreadID()

      * returns int, while Thread.getId() returns long.

      */

     private static final int MIN_SEQUENTIAL_THREAD_ID = Integer.MAX_VALUE / 2;

     /**

      * @serial Logging message level

      */

     private Level level;

     /**

      * @serial Sequence number

      */

     private long sequenceNumber;

     /**

      * @serial Class that issued logging call

      */

     private String sourceClassName;

     /**

      * @serial Method that issued logging call

      */

     private String sourceMethodName;

     /**

      * @serial Non-localized raw message text

      */

     private String message;

     /**

      * @serial Thread ID for thread that issued logging call.

      */

     private int threadID;

     /**

      * @serial Event time in milliseconds since 1970

      */

     private long millis;

     /**

      * @serial The Throwable (if any) associated with log message

      */

     private Throwable thrown;

     /**

      * @serial Name of the source Logger.

      */

     private String loggerName;

     /**

      * @serial Resource bundle name to localized log message.

      */

     private String resourceBundleName;

     private transient boolean needToInferCaller;

     private transient Object parameters[];

     /**

      * Returns the default value for a new LogRecord's threadID.

      */

     private int defaultThreadID() {

         return 0;

     }

     /**

      * Construct a LogRecord with the given level and message values.

      * <p>

      * The sequence property will be initialized with a new unique value.

      * These sequence values are allocated in increasing order within a VM.

      * <p>

      * The millis property will be initialized to the current time.

      * <p>

      * The thread ID property will be initialized with a unique ID for

      * the current thread.

      * <p>

      * All other properties will be initialized to "null".

      *

      * @param level  a logging level value

      * @param msg  the raw non-localized logging message (may be null)

      */

     public LogRecord(Level level, String msg) {

         // Make sure level isn't null, by calling random method.

         level.getClass();

         this.level = level;

         message = msg;

         // Assign a thread ID and a unique sequence number.

         sequenceNumber = globalSequenceNumber++;

         threadID = defaultThreadID();

         millis = System.currentTimeMillis();

         needToInferCaller = true;

    }

     /**

      * Get the source Logger's name.

      *

      * @return source logger name (may be null)

      */

     public String getLoggerName() {

         return loggerName;

     }

     /**

      * Set the source Logger's name.

      *

      * @param name   the source logger name (may be null)

      */

     public void setLoggerName(String name) {

         loggerName = name;

     }

     /**

      * Get the localization resource bundle

      * <p>

      * This is the ResourceBundle that should be used to localize

      * the message string before formatting it.  The result may

      * be null if the message is not localizable, or if no suitable

      * ResourceBundle is available.

      */

 //    public ResourceBundle getResourceBundle() {

 //        return resourceBundle;

 //    }

     /**

      * Set the localization resource bundle.

      *

      * @param bundle  localization bundle (may be null)

      */

 //    public void setResourceBundle(ResourceBundle bundle) {

 //        resourceBundle = bundle;

 //    }

     /**

      * Get the localization resource bundle name

      * <p>

      * This is the name for the ResourceBundle that should be

      * used to localize the message string before formatting it.

      * The result may be null if the message is not localizable.

      */

     public String getResourceBundleName() {

         return resourceBundleName;

     }

     /**

      * Set the localization resource bundle name.

      *

      * @param name  localization bundle name (may be null)

      */

     public void setResourceBundleName(String name) {

         resourceBundleName = name;

     }

     /**

      * Get the logging message level, for example Level.SEVERE.

      * @return the logging message level

      */

     public Level getLevel() {

         return level;

     }

     /**

      * Set the logging message level, for example Level.SEVERE.

      * @param level the logging message level

      */

     public void setLevel(Level level) {

         if (level == null) {

             throw new NullPointerException();

         }

         this.level = level;

     }

     /**

      * Get the sequence number.

      * <p>

      * Sequence numbers are normally assigned in the LogRecord

      * constructor, which assigns unique sequence numbers to

      * each new LogRecord in increasing order.

      * @return the sequence number

      */

     public long getSequenceNumber() {

         return sequenceNumber;

     }

     /**

      * Set the sequence number.

      * <p>

      * Sequence numbers are normally assigned in the LogRecord constructor,

      * so it should not normally be necessary to use this method.

      */

     public void setSequenceNumber(long seq) {

         sequenceNumber = seq;

     }

     /**

      * Get the  name of the class that (allegedly) issued the logging request.

      * <p>

      * Note that this sourceClassName is not verified and may be spoofed.

      * This information may either have been provided as part of the

      * logging call, or it may have been inferred automatically by the

      * logging framework.  In the latter case, the information may only

      * be approximate and may in fact describe an earlier call on the

      * stack frame.

      * <p>

      * May be null if no information could be obtained.

      *

      * @return the source class name

      */

     public String getSourceClassName() {

         return sourceClassName;

     }

     /**

      * Set the name of the class that (allegedly) issued the logging request.

      *

      * @param sourceClassName the source class name (may be null)

      */

     public void setSourceClassName(String sourceClassName) {

         this.sourceClassName = sourceClassName;

         needToInferCaller = false;

     }

     /**

      * Get the  name of the method that (allegedly) issued the logging request.

      * <p>

      * Note that this sourceMethodName is not verified and may be spoofed.

      * This information may either have been provided as part of the

      * logging call, or it may have been inferred automatically by the

      * logging framework.  In the latter case, the information may only

      * be approximate and may in fact describe an earlier call on the

      * stack frame.

      * <p>

      * May be null if no information could be obtained.

      *

      * @return the source method name

      */

     public String getSourceMethodName() {

         return sourceMethodName;

     }

     /**

      * Set the name of the method that (allegedly) issued the logging request.

      *

      * @param sourceMethodName the source method name (may be null)

      */

     public void setSourceMethodName(String sourceMethodName) {

         this.sourceMethodName = sourceMethodName;

         needToInferCaller = false;

     }

     /**

      * Get the "raw" log message, before localization or formatting.

      * <p>

      * May be null, which is equivalent to the empty string "".

      * <p>

      * This message may be either the final text or a localization key.

      * <p>

      * During formatting, if the source logger has a localization

      * ResourceBundle and if that ResourceBundle has an entry for

      * this message string, then the message string is replaced

      * with the localized value.

      *

      * @return the raw message string

      */

     public String getMessage() {

         return message;

     }

     /**

      * Set the "raw" log message, before localization or formatting.

      *

      * @param message the raw message string (may be null)

      */

     public void setMessage(String message) {

         this.message = message;

     }

     /**

      * Get the parameters to the log message.

      *

      * @return the log message parameters.  May be null if

      *                  there are no parameters.

      */

     public Object[] getParameters() {

         return parameters;

     }

     /**

      * Set the parameters to the log message.

      *

      * @param parameters the log message parameters. (may be null)

      */

     public void setParameters(Object parameters[]) {

         this.parameters = parameters;

     }

     /**

      * Get an identifier for the thread where the message originated.

      * <p>

      * This is a thread identifier within the Java VM and may or

      * may not map to any operating system ID.

      *

      * @return thread ID

      */

     public int getThreadID() {

         return threadID;

     }

     /**

      * Set an identifier for the thread where the message originated.

      * @param threadID  the thread ID

      */

     public void setThreadID(int threadID) {

         this.threadID = threadID;

     }

     /**

      * Get event time in milliseconds since 1970.

      *

      * @return event time in millis since 1970

      */

     public long getMillis() {

         return millis;

     }

     /**

      * Set event time.

      *

      * @param millis event time in millis since 1970

      */

     public void setMillis(long millis) {

         this.millis = millis;

     }

     /**

      * Get any throwable associated with the log record.

      * <p>

      * If the event involved an exception, this will be the

      * exception object. Otherwise null.

      *

      * @return a throwable

      */

     public Throwable getThrown() {

         return thrown;

     }

     /**

      * Set a throwable associated with the log event.

      *

      * @param thrown  a throwable (may be null)

      */

     public void setThrown(Throwable thrown) {

         this.thrown = thrown;

     }

     private static final long serialVersionUID = 5372048053134512534L;

     /**

      * @serialData Default fields, followed by a two byte version number

      * (major byte, followed by minor byte), followed by information on

      * the log record parameter array.  If there is no parameter array,

      * then -1 is written.  If there is a parameter array (possible of zero

      * length) then the array length is written as an integer, followed

      * by String values for each parameter.  If a parameter is null, then

      * a null String is written.  Otherwise the output of Object.toString()

      * is written.

      */

     private void writeObject(ObjectOutputStream out) throws IOException {

         // We have to call defaultWriteObject first.

         out.defaultWriteObject();

         // Write our version number.

         out.writeByte(1);

         out.writeByte(0);

         if (parameters == null) {

             out.writeInt(-1);

             return;

         }

         out.writeInt(parameters.length);

         // Write string values for the parameters.

         for (int i = 0; i < parameters.length; i++) {

             if (parameters[i] == null) {

                 out.writeObject(null);

             } else {

                 out.writeObject(parameters[i].toString());

             }

         }

     }

     private boolean isLoggerImplFrame(String cname) {

         // the log record could be created for a platform logger

         return (cname.equals("java.util.logging.Logger") ||

                 cname.startsWith("java.util.logging.LoggingProxyImpl") ||

                 cname.startsWith("sun.util.logging."));

     }

 }