Log (Javadocs [I2P+ 2.13.0+] - API Version 0.9.70+)

java.lang.Object
- net.i2p.util.Log

```
public class Log
extends Object
```
Wrapper class for whatever logging system I2P uses. This class should be instantiated and kept as a variable for each class it is used by, e.g. private final Log _log = context.logManager().getLog(MyClassName.class); If there is anything in here that doesn't make sense, turn off your computer and go fly a kite.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CRIT` CRIT.
`static int`	`DEBUG` DEBUG.
`static int`	`ERROR` ERROR.
`static int`	`INFO` INFO.
`static String`	`STR_CRIT` STR_CRIT.
`static String`	`STR_DEBUG` STR_DEBUG.
`static String`	`STR_ERROR` STR_ERROR.
`static String`	`STR_INFO` STR_INFO.
`static String`	`STR_WARN` STR_WARN.
`static int`	`WARN` WARN.

Constructor Summary

Constructors
Constructor and Description
`Log(Class<?> cls)` Warning - not recommended.
`Log(LogManager manager, Class<?> cls)` Log
`Log(LogManager manager, Class<?> cls, String name)` Log
`Log(LogManager manager, String name)` Log
`Log(String name)` Warning - not recommended.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`debug(String msg)` Log a debug message.
`void`	`debug(String msg, Throwable t)` Log a debug message with a throwable.
`void`	`error(String msg)` Log an error message.
`void`	`error(String msg, Throwable t)` Log an error message with a throwable.
`static int`	`getLevel(String level)` Get the log level integer for a string level name.
`int`	`getMinimumPriority()` Get the minimum priority for logging.
`String`	`getName()` Get the logger name.
`Object`	`getScope()` Returns the LogScope (private class).
`(package private) static String`	`getScope(String name, Class<?> cls)` Get the scope string for a name and class.
`void`	`info(String msg)` Log an info message.
`void`	`info(String msg, Throwable t)` Log an info message with a throwable.
`void`	`log(int priority, String msg)` Log a message at the given priority.
`void`	`log(int priority, String msg, Throwable t)` Log a message with a throwable at the given priority.
`void`	`logAlways(int priority, String msg)` Always log this message with the given priority, ignoring current minimum priority level.
`void`	`logCloseLoop(int level, Object... desc)` Logs a close loop when closing a resource This method is for debugging purposes only and is subject to change or removal w/o notice.
`void`	`logCloseLoop(Object... desc)` logs a loop when closing a resource with level DEBUG This method is for debugging purposes only and is subject to change or removal w/o notice.
`void`	`setMinimumPriority(int priority)` Set the minimum priority for logging.
`boolean`	`shouldDebug()` Check if DEBUG level logging is enabled.
`boolean`	`shouldError()` Check if ERROR level logging is enabled.
`boolean`	`shouldInfo()` Check if INFO level logging is enabled.
`boolean`	`shouldLog(int priority)` Check if messages at the given priority should be logged.
`boolean`	`shouldWarn()` Check if WARN level logging is enabled.
`static String`	`toLevelString(int level)` Convert a log level integer to its string representation.
`void`	`warn(String msg)` Log a warning message.
`void`	`warn(String msg, Throwable t)` Log a warning message with a throwable.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - CRIT
```
public static final int CRIT
```
    CRIT.
    See Also:
    Constant Field Values
  - DEBUG
```
public static final int DEBUG
```
    DEBUG.
    See Also:
    Constant Field Values
  - ERROR
```
public static final int ERROR
```
    ERROR.
    See Also:
    Constant Field Values
  - INFO
```
public static final int INFO
```
    INFO.
    See Also:
    Constant Field Values
  - STR_CRIT
```
public static final String STR_CRIT
```
    STR_CRIT.
    See Also:
    Constant Field Values
  - STR_DEBUG
```
public static final String STR_DEBUG
```
    STR_DEBUG.
    See Also:
    Constant Field Values
  - STR_ERROR
```
public static final String STR_ERROR
```
    STR_ERROR.
    See Also:
    Constant Field Values
  - STR_INFO
```
public static final String STR_INFO
```
    STR_INFO.
    See Also:
    Constant Field Values
  - STR_WARN
```
public static final String STR_WARN
```
    STR_WARN.
    See Also:
    Constant Field Values
  - WARN
```
public static final int WARN
```
    WARN.
    See Also:
    Constant Field Values
- Constructor Detail
  - Log
```
public Log(Class<?> cls)
```
    Warning - not recommended. Use I2PAppContext.getGlobalContext().logManager().getLog(cls)
  - Log
```
Log(LogManager manager,
    Class<?> cls)
```
    Log
  - Log
```
Log(LogManager manager,
    Class<?> cls,
    String name)
```
    Log
  - Log
```
Log(LogManager manager,
    String name)
```
    Log
  - Log
```
public Log(String name)
```
    Warning - not recommended. Use I2PAppContext.getGlobalContext().logManager().getLog(name)
- Method Detail
  - debug
```
public void debug(String msg)
```
    Log a debug message.
    Parameters:
    msg - the message
  - debug
```
public void debug(String msg,
                  Throwable t)
```
    Log a debug message with a throwable.
    Parameters:
    msg - the message
    t - the throwable
  - error
```
public void error(String msg)
```
    Log an error message.
    Parameters:
    msg - the message
  - error
```
public void error(String msg,
                  Throwable t)
```
    Log an error message with a throwable.
    Parameters:
    msg - the message
    t - the throwable
  - getLevel
```
public static int getLevel(String level)
```
    Get the log level integer for a string level name.
    Parameters:
    level - the level
    Returns:
    the integer level
  - getMinimumPriority
```
public int getMinimumPriority()
```
    Get the minimum priority for logging.
    Returns:
    the minimum priority
  - getName
```
public String getName()
```
    Get the logger name.
    Returns:
    the name
  - getScope
```
public Object getScope()
```
    Returns the LogScope (private class).
    Returns:
    the LogScope
  - getScope
```
static String getScope(String name,
                       Class<?> cls)
```
    Get the scope string for a name and class.
    Parameters:
    name - the logger name
    cls - the class
    Returns:
    the scope string
  - info
```
public void info(String msg)
```
    Log an info message.
    Parameters:
    msg - the message
  - info
```
public void info(String msg,
                 Throwable t)
```
    Log an info message with a throwable.
    Parameters:
    msg - the message
    t - the throwable
  - log
```
public void log(int priority,
                String msg)
```
    Log a message at the given priority.
    Parameters:
    priority - the priority level
    msg - the message
  - log
```
public void log(int priority,
                String msg,
                Throwable t)
```
    Log a message with a throwable at the given priority.
    Parameters:
    priority - the priority level
    msg - the message
    t - the throwable
  - logAlways
```
public void logAlways(int priority,
                      String msg)
```
    Always log this message with the given priority, ignoring current minimum priority level. This allows an INFO message about changing port numbers, for example, to always be logged.
  - logCloseLoop
```
public void logCloseLoop(int level,
                         Object... desc)
```
    Logs a close loop when closing a resource This method is for debugging purposes only and is subject to change or removal w/o notice. NOT a supported API.
    Parameters:
    desc - vararg description of the resource
    level - level at which to log
  - logCloseLoop
```
public void logCloseLoop(Object... desc)
```
    logs a loop when closing a resource with level DEBUG This method is for debugging purposes only and is subject to change or removal w/o notice. NOT a supported API.
    Parameters:
    desc - vararg description
  - setMinimumPriority
```
public void setMinimumPriority(int priority)
```
    Set the minimum priority for logging.
    Parameters:
    priority - the minimum priority
  - shouldDebug
```
public boolean shouldDebug()
```
    Check if DEBUG level logging is enabled.
    Returns:
    whether debug
  - shouldError
```
public boolean shouldError()
```
    Check if ERROR level logging is enabled.
    Returns:
    whether error
  - shouldInfo
```
public boolean shouldInfo()
```
    Check if INFO level logging is enabled.
    Returns:
    whether info
  - shouldLog
```
public boolean shouldLog(int priority)
```
    Check if messages at the given priority should be logged.
    Parameters:
    priority - the priority level
    Returns:
    true if messages at this priority will be logged
  - shouldWarn
```
public boolean shouldWarn()
```
    Check if WARN level logging is enabled.
    Returns:
    whether warn
  - toLevelString
```
public static String toLevelString(int level)
```
    Convert a log level integer to its string representation.
    Parameters:
    level - the integer level
    Returns:
    the level string
  - warn
```
public void warn(String msg)
```
    Log a warning message.
    Parameters:
    msg - the message
  - warn
```
public void warn(String msg,
                 Throwable t)
```
    Log a warning message with a throwable.
    Parameters:
    msg - the message
    t - the throwable

Class Log

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CRIT

DEBUG

ERROR

INFO

STR_CRIT

STR_DEBUG

STR_ERROR

STR_INFO

STR_WARN

WARN

Constructor Detail

Log

Log

Log

Log

Log

Method Detail

debug

debug

error

error

getLevel

getMinimumPriority

getName

getScope

getScope

info

info

log

log

logAlways

logCloseLoop

logCloseLoop

setMinimumPriority

shouldDebug

shouldError

shouldInfo

shouldLog

shouldWarn

toLevelString

warn

warn