Constructor Detail

Method Detail

• getLogger

   final static <T extends Any> Logger getLogger(KClass<T> clazz)

• getLogger

   final static <T extends Any> Logger getLogger(KClass<T> clazz, String postfix)

• getLogger

   final static Logger getLogger(Object target)

• getLogger

   final static Logger getLogger(Object target, String postfix)

• getTracerOrNull

   final static Logger getTracerOrNull(Object target)

• getRandomLogger

   final static Logger getRandomLogger()

• catastrophicError

   final static Unit catastrophicError(Throwable t, String message, Object args)

  Log messages using System.err and Throwable.printStackTrace in the case when the logging system was crashed.

  Parameters:

  t - the exception thrown by the close method

  message - the message to log

• warn

   final static Unit warn(Object target, String message, Object args)

• warn

   final static Unit warn(Object target, Throwable t, String message, Object args)

• warnInterruptible

   final static Unit warnInterruptible(Object target, Throwable t)

  Log a warning message for an interruptible exception.

  This method logs the exception and manages InterruptedException.

  Parameters:

  target - the object that is being closed

  t - the exception thrown by the close method

• warnInterruptible

   final static Unit warnInterruptible(Object target, Throwable t, String message, Object args)

  Log a warning message for an interruptible exception.

  This method logs the exception and manages InterruptedException.

  Parameters:

  target - the object that is being closed

  t - the exception thrown by the close method

  message - the message to log

• warnUnexpected

   final static Unit warnUnexpected(Object target, Throwable t)

  Log a warning message for an unexpected exception.

  The exception is unexpected, it's best managed within custom code, such as event handlers. This method logs the exception, manages InterruptedException, and logs a message to emphasize that the exception is unexpected.

  Parameters:

  target - the object that is being closed

  t - the exception thrown by the close method

• warnUnexpected

   final static Unit warnUnexpected(Object target, Throwable t, String message, Object args)

  Log a warning message for an unexpected exception.

  The exception is unexpected, it's best managed within custom code, such as event handlers. This method logs the exception, manages InterruptedException, and logs a message to emphasize that the exception is unexpected.

  Parameters:

  target - the object that is being closed

  t - the exception thrown by the close method

  message - the message to log

• warnForClose

   final static Unit warnForClose(Object target, Throwable t)

  Log a warning message for a close method that throws an exception.

  It's very common for the close method to suppress exceptions and just log it, but some exceptions should be carefully handled, such as InterruptedException. It's strongly advised to not have the close method throw InterruptedException, but it's not guaranteed, so we suppress it and log a warning message if it happens.

  Parameters:

  target - the object that is being closed

  t - the exception thrown by the close method

• warnForClose

   final static Unit warnForClose(Object target, Throwable t, String message, Object args)

  Log a warning message for a close method that throws an exception.

  It's very common for the close method to suppress exceptions and just log it, but some exceptions should be carefully handled, such as InterruptedException. It's strongly advised to not have the close method throw InterruptedException, but it's not guaranteed, so we suppress it and log a warning message if it happens.

  Parameters:

  target - the object that is being closed

  t - the exception thrown by the close method

  message - the message to log