Module org.refcodes.mixin
Package org.refcodes.mixin

Interface Loggable

public interface Loggable
This interface probes for the RuntimeLogger library by means of reflection to finally do logging. If no logger was found, then System.out and System.err are used for logging. The purpose of this interface is to provide logging facilities for low level APIs which cannot depend on the logging library as a whole.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    RUNTIME_LOGGER_CLASS
     
    static final String
    RUNTIME_LOGGER_FACTORY_CLASS
     
    static final String
    RUNTIME_LOGGER_FACTORY_METHOD
     

  • Method Summary

    Modifier and Type
    Method
    Description
    default void
    alert(String aMessage)
    Logs a log message with log priority ALERT.
    default void
    alert(String aMessage, Throwable aThrowable)
    Logs a log message with log priority ALERT.
    default void
    critical(String aMessage)
    Logs a log message with log priority CRITICAL.
    default void
    critical(String aMessage, Throwable aThrowable)
    Logs a log message with log priority CRITICAL.
    default void
    debug(String aMessage)
    Logs a log message with log priority DEBUG.
    default void
    error(String aMessage, Throwable aThrowable)
    Logs a log message with log priority ERROR.
    default void
    info(String aMessage)
    Logs a log message with log priority INFO.
    default void
    notice(String aMessage)
    Logs a log message with log priority NOTICE.
    default void
    panic(String aMessage, Throwable aThrowable)
    Logs a log message with log priority PANIC.
    default void
    trace(String aMessage)
    Logs a log message with log priority TRACE.
    default void
    warn(String aMessage)
    Logs a log message with log priority WARN.
    default void
    warn(String aMessage, Throwable aThrowable)
    Logs a log message with log priority WARN.

  • Field Details

  • Method Details

    • alert

      default void alert(String aMessage)
      Logs a log message with log priority ALERT. "Should be corrected immediately, therefore notify staff who can fix the problem. An example would be the loss of a primary ISP connection." See also http://en.wikipedia.org/wiki/Syslog
      Parameters:
      aMessage - The message to be logged.

    • alert

      default void alert(String aMessage, Throwable aThrowable)
      Logs a log message with log priority ALERT.
      Parameters:
      aMessage - The message to be logged.
      aThrowable - An exception that the message should contain.

    • critical

      default void critical(String aMessage)
      Logs a log message with log priority CRITICAL. "Should be corrected immediately, but indicates failure in a secondary system, an example is a loss of a backup ISP connection." See also http://en.wikipedia.org/wiki/Syslog
      Parameters:
      aMessage - The message to be logged.

    • critical

      default void critical(String aMessage, Throwable aThrowable)
      Logs a log message with log priority CRITICAL. "Should be corrected immediately, but indicates failure in a secondary system, an example is a loss of a backup ISP connection." See also http://en.wikipedia.org/wiki/Syslog
      Parameters:
      aMessage - The message to be logged.
      aThrowable - An exception that the message should contain.

    • debug

      default void debug(String aMessage)
      Logs a log message with log priority DEBUG. "Info useful to developers for debugging the application, not useful during operations." See also http://en.wikipedia.org/wiki/Syslog
      Parameters:
      aMessage - The message to be logged.

    • error

      default void error(String aMessage, Throwable aThrowable)
      Logs a log message with log priority ERROR. "Non-urgent failures, these should be relayed to developers or admins; each item must be resolved within a given time." See also http://en.wikipedia.org/wiki/Syslog
      Parameters:
      aMessage - The message to be logged.
      aThrowable - An exception that the message should contain.

    • info

      default void info(String aMessage)
      Logs a log message with log priority INFO. "Additional information which might be useful for some stability period." See also http://en.wikipedia.org/wiki/Syslog
      Parameters:
      aMessage - The message to be logged.

    • notice

      default void notice(String aMessage)
      Logs a log message with log priority NOTICE. "Events that are unusual but not error conditions - might be summarized in an email to developers or admins to spot potential problems - no immediate action required." See also http://en.wikipedia.org/wiki/Syslog
      Parameters:
      aMessage - The message to be logged.

    • panic

      default void panic(String aMessage, Throwable aThrowable)
      Logs a log message with log priority PANIC. "A "panic" condition usually affecting multiple apps/servers/sites. At this level it would usually notify all tech staff on call." ( See also http://en.wikipedia.org/wiki/Syslog
      Parameters:
      aMessage - The message to be logged.
      aThrowable - An exception that the message should contain.

    • trace

      default void trace(String aMessage)
      Logs a log message with log priority TRACE.
      Parameters:
      aMessage - The message to be logged.

    • warn

      default void warn(String aMessage)
      Logs a log message with log priority WARN. "Warning messages, not an error, but indication that an error will occur if action is not taken, e.g. file system 85% full - each item must be resolved within a given time." See also http://en.wikipedia.org/wiki/Syslog
      Parameters:
      aMessage - The message to be logged.

    • warn

      default void warn(String aMessage, Throwable aThrowable)
      Logs a log message with log priority WARN. "Warning messages, not an error, but indication that an error will occur if action is not taken, e.g. file system 85% full - each item must be resolved within a given time." See also http://en.wikipedia.org/wiki/Syslog
      Parameters:
      aMessage - The message to be logged.
      aThrowable - An exception that the message should contain.