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 String RUNTIME_LOGGER_CLASS  
    static String RUNTIME_LOGGER_FACTORY_CLASS  
    static 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.