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.
    • Method Summary

      All Methods Instance Methods Default Methods 
      Modifier and Type Method Description
      default void alert​(java.lang.String aMessage)
      Logs a log message with log priority ALERT.
      default void alert​(java.lang.String aMessage, java.lang.Throwable aThrowable)
      Logs a log message with log priority ALERT.
      default void critical​(java.lang.String aMessage)
      Logs a log message with log priority CRITICAL.
      default void critical​(java.lang.String aMessage, java.lang.Throwable aThrowable)
      Logs a log message with log priority CRITICAL.
      default void debug​(java.lang.String aMessage)
      Logs a log message with log priority DEBUG.
      default void error​(java.lang.String aMessage, java.lang.Throwable aThrowable)
      Logs a log message with log priority ERROR.
      default void info​(java.lang.String aMessage)
      Logs a log message with log priority INFO.
      default void notice​(java.lang.String aMessage)
      Logs a log message with log priority NOTICE.
      default void panic​(java.lang.String aMessage, java.lang.Throwable aThrowable)
      Logs a log message with log priority PANIC.
      default void trace​(java.lang.String aMessage)
      Logs a log message with log priority TRACE.
      default void warn​(java.lang.String aMessage)
      Logs a log message with log priority WARN.
      default void warn​(java.lang.String aMessage, java.lang.Throwable aThrowable)
      Logs a log message with log priority WARN.
    • Field Detail

      • RUNTIME_LOGGER_FACTORY_METHOD

        static final java.lang.String RUNTIME_LOGGER_FACTORY_METHOD
        See Also:
        Constant Field Values
      • RUNTIME_LOGGER_FACTORY_CLASS

        static final java.lang.String RUNTIME_LOGGER_FACTORY_CLASS
        See Also:
        Constant Field Values
      • RUNTIME_LOGGER_CLASS

        static final java.lang.String RUNTIME_LOGGER_CLASS
        See Also:
        Constant Field Values
    • Method Detail

      • alert

        default void alert​(java.lang.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​(java.lang.String aMessage,
                           java.lang.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​(java.lang.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​(java.lang.String aMessage,
                              java.lang.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​(java.lang.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​(java.lang.String aMessage,
                           java.lang.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​(java.lang.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​(java.lang.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​(java.lang.String aMessage,
                           java.lang.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​(java.lang.String aMessage)
        Logs a log message with log priority TRACE.
        Parameters:
        aMessage - The message to be logged.
      • warn

        default void warn​(java.lang.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​(java.lang.String aMessage,
                          java.lang.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.