NullLogger

Dummy implementation of logger with no real effect.

Implements: ILogger

Description

The NullLogger class provides a dummy logger with no real effect.

Important points

  • It can be used in testing or in situations when a logger is required but must be disabled.

Instance methods

debug

Logs high-level debug information for troubleshooting.

void debug(IContext context, String message, Object… args)

  • context: IContext - (optional) a context to trace execution through a call chain.
  • message: String - a human-readable message to log.
  • args: Object - arguments to parameterize the message.

error

Logs recoverable application error.

error(context: Optional[IContext], error: Exception, message: str, *args: Any, **kwargs: Any) void error(IContext context, Exception error, String message, Object… args)

  • context: IContext - (optional) a context to trace execution through a call chain.
  • error: Exception - an error object associated with this message.
  • message: String - a human-readable message to log.
  • args: Object - arguments to parameterize the message.

fatal

Logs fatal (unrecoverable) message that caused the process to crash.

fatal(context: Optional[IContext], error: Exception, message: str, *args: Any, **kwargs: Any) void fatal(IContext context, Exception error, String message, Object… args)

  • context: IContext - (optional) a context to trace execution through a call chain.
  • error: Exception - an error object associated with this message.
  • message: String - a human-readable message to log.
  • args: Object - arguments to parameterize the message.

getLevel

Gets the maximum log level. Messages with higher log level are filtered out.

LogLevel getLevel()

  • returns: LogLevel - the maximum log level.

info

Logs an important information message

info(context: Optional[IContext], message: str, *args: Any, **kwargs: Any) void info(IContext context, String message, Object… args)

  • context: IContext - (optional) a context to trace execution through a call chain.
  • message: String - a human-readable message to log.
  • args: Object - arguments to parameterize the message.

log

Logs a message at specified log level.

void log(LogLevel level, IContext context, Exception error, String message, Object… args)

  • level: LogLevel - a log level.
  • context: IContext - (optional) a context to trace execution through a call chain.
  • error: Exception - an error object associated with this message.
  • message: String - a human-readable message to log.
  • args: Object - arguments to parameterize the message.

trace

Logs low-level debug information for troubleshooting.

trace(context: Optional[IContext], message: str, *args: Any, **kwargs: Any) void trace(IContext context, String message, Object… args)

  • context: IContext - (optional) a context to trace execution through a call chain.
  • message: String - a human-readable message to log.
  • args: Object - arguments to parameterize the message.

warn

Logs a warning that may or may not have a negative impact.

void warn(IContext context, String message, Object… args)

  • context: IContext - (optional) a context to trace execution through a call chain.
  • message: String - a human-readable message to log.
  • args: Object - arguments to parameterize the message.

See also