Package com.intellij.openapi.diagnostic

Class Logger

java.lang.Object

com.intellij.openapi.diagnostic.Logger

Direct Known Subclasses:

CompositeLogger, DefaultLogger, Log4jBasedLogger, RareLogger

public abstract class Logger
extends java.lang.Object

A standard interface to write to %system%/log/idea.log (or %system%/testlog/idea.log in tests).

In addition to writing to log file, "error" methods result in showing "IDE fatal errors" dialog in the IDE, in EAP versions or if "idea.fatal.error.notification" system property is "true" (). See DefaultIdeaErrorLogger.canHandle(com.intellij.openapi.diagnostic.IdeaLoggingEvent) for more details.

Note that in production, a call to "error" doesn't throw exceptions so the execution continues. In tests, however, an AssertionError is thrown.

In most non-performance tests, debug level is enabled by default, so that when a test fails the full contents of its log are printed to stdout.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Logger.Factory

Constructor Summary

Constructors

Constructor and Description
Logger()

Method Summary

Modifier and Type	Method and Description
boolean	assertTrue(boolean value)
boolean	assertTrue(boolean value, java.lang.Object message)
protected static java.lang.Throwable	checkException(java.lang.Throwable t)
abstract void	debug(java.lang.String message)
void	debug(java.lang.String message, java.lang.Object... details)
abstract void	debug(java.lang.String message, java.lang.Throwable t)
abstract void	debug(java.lang.Throwable t)
void	error(java.lang.Object message)
void	error(java.lang.String message)
void	error(java.lang.String message, Attachment... attachments)
void	error(java.lang.String message, java.lang.String... details)
void	error(java.lang.String message, java.lang.Throwable t)
void	error(java.lang.String message, java.lang.Throwable t, Attachment... attachments)
abstract void	error(java.lang.String message, java.lang.Throwable t, java.lang.String... details)
void	error(java.lang.Throwable t)
static Logger.Factory	getFactory()
static Logger	getInstance(java.lang.Class cl)
static Logger	getInstance(java.lang.String category)
abstract void	info(java.lang.String message)
abstract void	info(java.lang.String message, java.lang.Throwable t)
void	info(java.lang.Throwable t)
abstract boolean	isDebugEnabled()
static boolean	isInitialized()
boolean	isTraceEnabled()
static void	setFactory(java.lang.Class<? extends Logger.Factory> factory)
static void	setFactory(Logger.Factory factory)
abstract void	setLevel(Level level)
void	trace(java.lang.String message) Log a message with 'trace' level which finer-grained than 'debug' level.
void	trace(java.lang.Throwable t)
void	warn(java.lang.String message)
abstract void	warn(java.lang.String message, java.lang.Throwable t)
void	warn(java.lang.Throwable t)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Logger

public Logger()

Method Detail

setFactory

public static void setFactory(java.lang.Class<? extends Logger.Factory> factory)

setFactory

public static void setFactory(Logger.Factory factory)

getFactory

public static Logger.Factory getFactory()

isInitialized

public static boolean isInitialized()

getInstance

public static Logger getInstance(java.lang.String category)

getInstance

public static Logger getInstance(java.lang.Class cl)

isDebugEnabled

public abstract boolean isDebugEnabled()

debug

public abstract void debug(java.lang.String message)

debug

public abstract void debug(java.lang.Throwable t)

debug

public abstract void debug(java.lang.String message,
                           java.lang.Throwable t)

debug

public void debug(java.lang.String message,
                  java.lang.Object... details)

isTraceEnabled

public boolean isTraceEnabled()

trace

public void trace(java.lang.String message)

Log a message with 'trace' level which finer-grained than 'debug' level. Use this method instead of debug(String) for internal events of a subsystem to avoid overwhelming the log if 'debug' level is enabled.

trace

public void trace(java.lang.Throwable t)

info

public void info(java.lang.Throwable t)

info

public abstract void info(java.lang.String message)

info

public abstract void info(java.lang.String message,
                          java.lang.Throwable t)

warn

public void warn(java.lang.String message)

warn

public void warn(java.lang.Throwable t)

warn

public abstract void warn(java.lang.String message,
                          java.lang.Throwable t)

error

public void error(java.lang.String message)

error

public void error(java.lang.Object message)

error

public void error(java.lang.String message,
                  Attachment... attachments)

error

public void error(java.lang.String message,
                  java.lang.Throwable t,
                  Attachment... attachments)

error

public void error(java.lang.String message,
                  java.lang.String... details)

error

public void error(java.lang.String message,
                  java.lang.Throwable t)

error

public void error(java.lang.Throwable t)

error

public abstract void error(java.lang.String message,
                           java.lang.Throwable t,
                           java.lang.String... details)

assertTrue

public boolean assertTrue(boolean value,
                          java.lang.Object message)

assertTrue

public boolean assertTrue(boolean value)

setLevel

public abstract void setLevel(Level level)

checkException

protected static java.lang.Throwable checkException(java.lang.Throwable t)