Package lazyj

Class Log

java.lang.Object
lazyj.Log
public final class Log extends Object
Logging facility. Provides package- and class-based logging level and destination folder.
Since:
2006-10-16
Author:
costing

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    ERROR
    Constant for the ERROR log level
    static final int
    FATAL
    Constant for the FATAL log level
    static final int
    FINE
    Constant for the FINE log level
    static final int
    FINER
    Constant for the FINER log level
    static final int
    FINEST
    Constant for the FINEST log level
    static final int
    INFO
    Constant for the INFO log level
    static final int
    WARNING
    Constant for the WARNING log level

  • Constructor Summary

    Constructors
    Constructor
    Description
    Log()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    static Integer
    getLevel(String sComponent)
    Get the current logging level for a component
    static String
    getLogDir(String sComponent)
    For a given component, get the folder where the log files should be put.
    static boolean
    isLoggable(int level, String sComponent)
    Check if a message of a given level for a given component will be actually logged.
    static void
    log(int level, String sMessage)
    Log a message of a given severity for a given component
    static void
    log(int level, String sComponent, String sMessage)
    Log a message of a given severity for a given component
    static void
    log(int level, String sComponent, String sMessage, Object o)
    Log a message of a given severity for a given component, with an attached object.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

  • Constructor Details

    • Log

      public Log()

  • Method Details

    • getLevel

      public static Integer getLevel(String sComponent)
      Get the current logging level for a component
      Parameters:
      sComponent - component to get the level for
      Returns:
      the logging level

    • getLogDir

      public static String getLogDir(String sComponent)
      For a given component, get the folder where the log files should be put.
      Parameters:
      sComponent - component (class hierarchy)
      Returns:
      the target log dir

    • isLoggable

      public static boolean isLoggable(int level, String sComponent)
      Check if a message of a given level for a given component will be actually logged. If it would not be logged then it makes no sense to try to log the message in the first place. You should use the logger with constructions like this when the log message is complicated to build:
       if (Log.isLoggable(Log.DEBUG, "class.name")){
     Log.log(Log.DEBUG, "class.name", "Some complicated message here : "+object.toString());
 }
      Parameters:
      level - desired logging level
      sComponent - component
      Returns:
      true if the message will be logged, false otherwise

    • log

      public static void log(int level, String sMessage)
      Log a message of a given severity for a given component
      Parameters:
      level - severity of the message. Check the constants in this class for possible values.
      sMessage - message to log

    • log

      public static void log(int level, String sComponent, String sMessage)
      Log a message of a given severity for a given component
      Parameters:
      level - severity of the message. Check the constants in this class for possible values.
      sComponent - component name. Usually "servlet_zone/servlet_name", but could be the class name or something else you want
      sMessage - message to log

    • log

      public static void log(int level, String sComponent, String sMessage, Object o)
      Log a message of a given severity for a given component, with an attached object.
      Parameters:
      level - severity of the message. Check the constants in this class for possible values.
      sComponent - component name. Usually "servlet_zone/servlet_name", but could be the class name or something else you want
      sMessage - message to log
      o - object to attach, it is intended for use with a Throwable here, but works for any other objects too by invoking the .toString() method on them