Logger (SciJava Javadocs 0-SNAPSHOT API)

All Known Subinterfaces:

LogService

All Known Implementing Classes:

AbstractLogService, DefaultLogger, SLF4JLogService, StderrLogService
```
public interface Logger
```
Interface for objects which can produce log messages.
It provides methods for logging messages, exception stack traces and combinations of the two.

Author:

Curtis Rueden

See Also:

LogLevel, LogService

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`void`	`addLogListener(LogListener listener)` Adds an item to the list of registered listeners.
`void`	`alwaysLog(int level, Object msg, Throwable t)` Logs a message with an exception.
`default void`	`debug(Object msg)`
`default void`	`debug(Object msg, Throwable t)`
`default void`	`debug(Throwable t)`
`default void`	`error(Object msg)`
`default void`	`error(Object msg, Throwable t)`
`default void`	`error(Throwable t)`
`int`	`getLevel()` Returns the log level of this logger.
`default String`	`getName()` Returns the name of this logger.
`LogSource`	`getSource()` Returns the `LogSource` associated with this logger.
`default void`	`info(Object msg)`
`default void`	`info(Object msg, Throwable t)`
`default void`	`info(Throwable t)`
`default boolean`	`isDebug()`
`default boolean`	`isError()`
`default boolean`	`isInfo()`
`default boolean`	`isLevel(int level)`
`default boolean`	`isTrace()`
`default boolean`	`isWarn()`
`default void`	`log(int level, Object msg)` Logs a message.
`default void`	`log(int level, Object msg, Throwable t)` Logs a message with an exception.
`default void`	`log(int level, Throwable t)` Logs an exception.
`void`	`notifyListeners(LogMessage message)` Broadcasts the given log message to the registered listeners.
`void`	`removeLogListener(LogListener listener)` Removes an item from the list of registered listeners.
`default Logger`	`subLogger(String name)` Creates a sub logger, that forwards the message it gets to this logger.
`Logger`	`subLogger(String name, int level)` Creates a sub logger, that forwards the message it gets to this logger.
`default void`	`trace(Object msg)`
`default void`	`trace(Object msg, Throwable t)`
`default void`	`trace(Throwable t)`
`default void`	`warn(Object msg)`
`default void`	`warn(Object msg, Throwable t)`
`default void`	`warn(Throwable t)`

- Method Detail
  - debug
```
default void debug(Object msg)
```
  - debug
```
default void debug(Throwable t)
```
  - debug
```
default void debug(Object msg,
                   Throwable t)
```
  - error
```
default void error(Object msg)
```
  - error
```
default void error(Throwable t)
```
  - error
```
default void error(Object msg,
                   Throwable t)
```
  - info
```
default void info(Object msg)
```
  - info
```
default void info(Throwable t)
```
  - info
```
default void info(Object msg,
                  Throwable t)
```
  - trace
```
default void trace(Object msg)
```
  - trace
```
default void trace(Throwable t)
```
  - trace
```
default void trace(Object msg,
                   Throwable t)
```
  - warn
```
default void warn(Object msg)
```
  - warn
```
default void warn(Throwable t)
```
  - warn
```
default void warn(Object msg,
                  Throwable t)
```
  - isDebug
```
default boolean isDebug()
```
  - isError
```
default boolean isError()
```
  - isInfo
```
default boolean isInfo()
```
  - isTrace
```
default boolean isTrace()
```
  - isWarn
```
default boolean isWarn()
```
  - isLevel
```
default boolean isLevel(int level)
```
  - log
```
default void log(int level,
                 Object msg)
```
    Logs a message.
    
    Parameters:
    
    level - The level at which the message will be logged. If the current level (given by getLevel() is below this one, no logging is performed.
    
    msg - The message to log.
  - log
```
default void log(int level,
                 Throwable t)
```
    Logs an exception.
    
    Parameters:
    
    level - The level at which the exception will be logged. If the current level (given by getLevel() is below this one, no logging is performed.
    
    t - The exception to log.
  - log
```
default void log(int level,
                 Object msg,
                 Throwable t)
```
    Logs a message with an exception.
    
    Parameters:
    
    level - The level at which the information will be logged. If the current level (given by getLevel() is below this one, no logging is performed.
    
    msg - The message to log.
    
    t - The exception to log.
  - alwaysLog
```
void alwaysLog(int level,
               Object msg,
               Throwable t)
```
    Logs a message with an exception. This message will always be logged even if its level is above the current level (given by getLevel()).
    
    Parameters:
    
    level - The level at which the information will be logged.
    
    msg - The message to log.
    
    t - The exception to log.
  - getName
```
default String getName()
```
    Returns the name of this logger.
  - getSource
```
LogSource getSource()
```
    Returns the LogSource associated with this logger.
  - getLevel
```
int getLevel()
```
    Returns the log level of this logger. see LogLevel
  - subLogger
```
default Logger subLogger(String name)
```
    Creates a sub logger, that forwards the message it gets to this logger. The sub logger will have the same log level as this logger.
  - subLogger
```
Logger subLogger(String name,
                 int level)
```
    Creates a sub logger, that forwards the message it gets to this logger.
    
    Parameters:
    
    name - The name of the sub logger.
    
    level - The log level of the sub logger.
  - addLogListener
```
void addLogListener(LogListener listener)
```
    Adds an item to the list of registered listeners.
  - removeLogListener
```
void removeLogListener(LogListener listener)
```
    Removes an item from the list of registered listeners.
  - notifyListeners
```
void notifyListeners(LogMessage message)
```
    Broadcasts the given log message to the registered listeners.

Interface Logger

Method Summary

Method Detail

debug

debug

debug

error

error

error

info

info

info

trace

trace

trace

warn

warn

warn

isDebug

isError

isInfo

isTrace

isWarn

isLevel

log

log

log

alwaysLog

getName

getSource

getLevel

subLogger

subLogger

addLogListener

removeLogListener

notifyListeners