playn.core

Class Log

java.lang.Object

playn.core.Log

public abstract class Log
extends java.lang.Object

Simple PlayN logging interface.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Log.Collector Allows for collection of log messages (in addition to standard logging).
static class	Log.Level Tags a log message with a level.

Constructor Summary

Constructors

Constructor and Description
Log()

Method Summary

Modifier and Type	Method and Description
void	debug(java.lang.String msg) Logs msg at the debug level.
void	debug(java.lang.String msg, java.lang.Object... args) Logs msg at the debug level.
void	debug(java.lang.String msg, java.lang.Throwable e) Logs msg and e at the debug level.
void	error(java.lang.String msg) Logs msg at the error level.
void	error(java.lang.String msg, java.lang.Object... args) Logs msg at the error level.
void	error(java.lang.String msg, java.lang.Throwable e) Logs msg and e at the error level.
static java.lang.StringBuilder	format(java.lang.StringBuilder into, java.lang.Object... args) Formats the supplied key/value arguments into the supplied string builder as key=value, key=value, ....
void	info(java.lang.String msg) Logs msg at the info level.
void	info(java.lang.String msg, java.lang.Object... args) Logs msg at the info level.
void	info(java.lang.String msg, java.lang.Throwable e) Logs msg and e at the info level.
void	setCollector(Log.Collector collector) Configures a log message collector.
void	setMinLevel(Log.Level level) Configures the minimum log level that will be logged.
void	warn(java.lang.String msg) Logs msg at the warn level.
void	warn(java.lang.String msg, java.lang.Object... args) Logs msg at the warn level.
void	warn(java.lang.String msg, java.lang.Throwable e) Logs msg and e at the warn level.

Methods inherited from class java.lang.Object

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

Constructor Detail

Log

public Log()

Method Detail

format

public static java.lang.StringBuilder format(java.lang.StringBuilder into,
                                             java.lang.Object... args)

Formats the supplied key/value arguments into the supplied string builder as key=value, key=value, ....

Returns:

the supplied string builder.

setCollector

public void setCollector(Log.Collector collector)

Configures a log message collector. This allows games to intercept (and record and submit with bug reports, for example) all messages logged via the PlayN logging system. This will include errors logged internally by PlayN code.

setMinLevel

public void setMinLevel(Log.Level level)

Configures the minimum log level that will be logged. Messages at a level lower than level will be suppressed. Note that all messages are still passed to any registered Log.Collector, but suppressed messages are not sent to the platform logging system.

debug

public void debug(java.lang.String msg)

Logs msg at the debug level.

debug

public void debug(java.lang.String msg,
                  java.lang.Object... args)

Logs msg at the debug level.

Parameters:

args - additional arguments formatted via format(java.lang.StringBuilder, java.lang.Object...) and appended to the message. args may contain an exception as its lone final argument which will be logged long with the formatted message.

debug

public void debug(java.lang.String msg,
                  java.lang.Throwable e)

Logs msg and e at the debug level.

info

public void info(java.lang.String msg)

Logs msg at the info level.

info

public void info(java.lang.String msg,
                 java.lang.Object... args)

Logs msg at the info level.

Parameters:

args - additional arguments formatted via format(java.lang.StringBuilder, java.lang.Object...) and appended to the message. args may contain an exception as its lone final argument which will be logged long with the formatted message.

info

public void info(java.lang.String msg,
                 java.lang.Throwable e)

Logs msg and e at the info level.

warn

public void warn(java.lang.String msg)

Logs msg at the warn level.

warn

public void warn(java.lang.String msg,
                 java.lang.Object... args)

Logs msg at the warn level.

Parameters:

args - additional arguments formatted via format(java.lang.StringBuilder, java.lang.Object...) and appended to the message. args may contain an exception as its lone final argument which will be logged long with the formatted message.

warn

public void warn(java.lang.String msg,
                 java.lang.Throwable e)

Logs msg and e at the warn level.

error

public void error(java.lang.String msg)

Logs msg at the error level.

error

public void error(java.lang.String msg,
                  java.lang.Object... args)

Logs msg at the error level.

Parameters:

args - additional arguments formatted via format(java.lang.StringBuilder, java.lang.Object...) and appended to the message. args may contain an exception as its lone final argument which will be logged long with the formatted message.

error

public void error(java.lang.String msg,
                  java.lang.Throwable e)

Logs msg and e at the error level.