uk.ac.soton.simulation.jsit.anylogic

Class AnyLogicLogger

java.lang.Object

uk.ac.soton.simulation.jsit.anylogic.AnyLogicLogger

All Implemented Interfaces:

org.slf4j.Logger

public class AnyLogicLogger
extends java.lang.Object
implements org.slf4j.Logger

Helper class (an SLF4J Logger instance) to perform JSIT (Logback-backed) logging in AnyLogic models, where model instances may change threads and thus break the expectations of Logback as regards MDC key availability.

AnyLogic models should normally log via an instance of this class, not via a standard Logback Logger instance (see the User Guide).

Since:

0.2

Author:

Stuart Rossiter

Field Summary

Fields inherited from interface org.slf4j.Logger

ROOT_LOGGER_NAME

Method Summary

Modifier and Type	Method and Description
void	debug(org.slf4j.Marker arg0, java.lang.String arg1)
void	debug(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object... arg2)
void	debug(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object arg2)
void	debug(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object arg2, java.lang.Object arg3)
void	debug(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Throwable arg2)
void	debug(java.lang.String arg0)
void	debug(java.lang.String arg0, java.lang.Object... arg1)
void	debug(java.lang.String arg0, java.lang.Object arg1)
void	debug(java.lang.String arg0, java.lang.Object arg1, java.lang.Object arg2)
void	debug(java.lang.String arg0, java.lang.Throwable arg1)
void	ensureExternalLoggingForBlock() Use to ensure that any logging not being done via AnyLogicLoggers (e.g., logging from third-party libraries you are using, including JSIT) will work OK for the current code block.
void	error(org.slf4j.Marker arg0, java.lang.String arg1)
void	error(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object... arg2)
void	error(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object arg2)
void	error(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object arg2, java.lang.Object arg3)
void	error(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Throwable arg2)
void	error(java.lang.String arg0)
void	error(java.lang.String arg0, java.lang.Object... arg1)
void	error(java.lang.String arg0, java.lang.Object arg1)
void	error(java.lang.String arg0, java.lang.Object arg1, java.lang.Object arg2)
void	error(java.lang.String arg0, java.lang.Throwable arg1)
java.lang.String	getName()
void	info(org.slf4j.Marker arg0, java.lang.String arg1)
void	info(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object... arg2)
void	info(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object arg2)
void	info(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object arg2, java.lang.Object arg3)
void	info(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Throwable arg2)
void	info(java.lang.String arg0)
void	info(java.lang.String arg0, java.lang.Object... arg1)
void	info(java.lang.String arg0, java.lang.Object arg1)
void	info(java.lang.String arg0, java.lang.Object arg1, java.lang.Object arg2)
void	info(java.lang.String arg0, java.lang.Throwable arg1)
boolean	isDebugEnabled()
boolean	isDebugEnabled(org.slf4j.Marker arg0)
boolean	isErrorEnabled()
boolean	isErrorEnabled(org.slf4j.Marker arg0)
boolean	isInfoEnabled()
boolean	isInfoEnabled(org.slf4j.Marker arg0)
boolean	isTraceEnabled()
boolean	isTraceEnabled(org.slf4j.Marker arg0)
boolean	isWarnEnabled()
boolean	isWarnEnabled(org.slf4j.Marker arg0)
void	trace(org.slf4j.Marker arg0, java.lang.String arg1)
void	trace(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object... arg2)
void	trace(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object arg2)
void	trace(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object arg2, java.lang.Object arg3)
void	trace(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Throwable arg2)
void	trace(java.lang.String arg0)
void	trace(java.lang.String arg0, java.lang.Object... arg1)
void	trace(java.lang.String arg0, java.lang.Object arg1)
void	trace(java.lang.String arg0, java.lang.Object arg1, java.lang.Object arg2)
void	trace(java.lang.String arg0, java.lang.Throwable arg1)
void	warn(org.slf4j.Marker arg0, java.lang.String arg1)
void	warn(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object... arg2)
void	warn(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object arg2)
void	warn(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Object arg2, java.lang.Object arg3)
void	warn(org.slf4j.Marker arg0, java.lang.String arg1, java.lang.Throwable arg2)
void	warn(java.lang.String arg0)
void	warn(java.lang.String arg0, java.lang.Object... arg1)
void	warn(java.lang.String arg0, java.lang.Object arg1)
void	warn(java.lang.String arg0, java.lang.Object arg1, java.lang.Object arg2)
void	warn(java.lang.String arg0, java.lang.Throwable arg1)

Methods inherited from class java.lang.Object

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

Method Detail

ensureExternalLoggingForBlock

public void ensureExternalLoggingForBlock()

Use to ensure that any logging not being done via AnyLogicLoggers (e.g., logging from third-party libraries you are using, including JSIT) will work OK for the current code block. You do not need to explicitly call this for logging via AnyLogicLoggers, and it will automatically be true if you have previously logged from an AnyLogicLogger in this code block.

(Technically, it will work until the next point at which the execution thread of the run could change; I think this amounts to the end of whatever scheduling event the current code is running as part of. It is easier and safer to assume it is required for any block of code (e.g., method body) where 'vanilla' logging may be used at a log level that has been set as enabled.)

JSIT code itself uses 'vanilla' Logback Loggers, rather than AnyLogicLogger-style ones (a) to minimise processing overhead; (b) because only AnyLogic models are affected by the problem; (c) because the outcome of logging 'wrongly' is relatively minor---the messages will go to a log in a missingOutputsFolder directory instead of the correct one for the run; (d) because most standard (INFO) level JSIT messages occur at simulation initialisation or model-end (where the logging is guaranteed to work anyway); and (e) because adding such a logging capability would require all JSIT classes to have some reference to a MainModel instance, which would mean the JSIT user having to supply one (or a reference to itself so that JSIT could find it) at instantiation time for certain classes (resulting in awkward and bloated user coding).

debug

public void debug(java.lang.String arg0)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(java.lang.String arg0,
                  java.lang.Object arg1)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(java.lang.String arg0,
                  java.lang.Object... arg1)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(java.lang.String arg0,
                  java.lang.Throwable arg1)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(org.slf4j.Marker arg0,
                  java.lang.String arg1)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(java.lang.String arg0,
                  java.lang.Object arg1,
                  java.lang.Object arg2)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Object arg2)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Object... arg2)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Throwable arg2)

Specified by:

debug in interface org.slf4j.Logger

debug

public void debug(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Object arg2,
                  java.lang.Object arg3)

Specified by:

debug in interface org.slf4j.Logger

error

public void error(java.lang.String arg0)

Specified by:

error in interface org.slf4j.Logger

error

public void error(java.lang.String arg0,
                  java.lang.Object arg1)

Specified by:

error in interface org.slf4j.Logger

error

public void error(java.lang.String arg0,
                  java.lang.Object... arg1)

Specified by:

error in interface org.slf4j.Logger

error

public void error(java.lang.String arg0,
                  java.lang.Throwable arg1)

Specified by:

error in interface org.slf4j.Logger

error

public void error(org.slf4j.Marker arg0,
                  java.lang.String arg1)

Specified by:

error in interface org.slf4j.Logger

error

public void error(java.lang.String arg0,
                  java.lang.Object arg1,
                  java.lang.Object arg2)

Specified by:

error in interface org.slf4j.Logger

error

public void error(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Object arg2)

Specified by:

error in interface org.slf4j.Logger

error

public void error(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Object... arg2)

Specified by:

error in interface org.slf4j.Logger

error

public void error(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Throwable arg2)

Specified by:

error in interface org.slf4j.Logger

error

public void error(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Object arg2,
                  java.lang.Object arg3)

Specified by:

error in interface org.slf4j.Logger

getName

public java.lang.String getName()

Specified by:

getName in interface org.slf4j.Logger

info

public void info(java.lang.String arg0)

Specified by:

info in interface org.slf4j.Logger

info

public void info(java.lang.String arg0,
                 java.lang.Object arg1)

Specified by:

info in interface org.slf4j.Logger

info

public void info(java.lang.String arg0,
                 java.lang.Object... arg1)

Specified by:

info in interface org.slf4j.Logger

info

public void info(java.lang.String arg0,
                 java.lang.Throwable arg1)

Specified by:

info in interface org.slf4j.Logger

info

public void info(org.slf4j.Marker arg0,
                 java.lang.String arg1)

Specified by:

info in interface org.slf4j.Logger

info

public void info(java.lang.String arg0,
                 java.lang.Object arg1,
                 java.lang.Object arg2)

Specified by:

info in interface org.slf4j.Logger

info

public void info(org.slf4j.Marker arg0,
                 java.lang.String arg1,
                 java.lang.Object arg2)

Specified by:

info in interface org.slf4j.Logger

info

public void info(org.slf4j.Marker arg0,
                 java.lang.String arg1,
                 java.lang.Object... arg2)

Specified by:

info in interface org.slf4j.Logger

info

public void info(org.slf4j.Marker arg0,
                 java.lang.String arg1,
                 java.lang.Throwable arg2)

Specified by:

info in interface org.slf4j.Logger

info

public void info(org.slf4j.Marker arg0,
                 java.lang.String arg1,
                 java.lang.Object arg2,
                 java.lang.Object arg3)

Specified by:

info in interface org.slf4j.Logger

isDebugEnabled

public boolean isDebugEnabled()

Specified by:

isDebugEnabled in interface org.slf4j.Logger

isDebugEnabled

public boolean isDebugEnabled(org.slf4j.Marker arg0)

Specified by:

isDebugEnabled in interface org.slf4j.Logger

isErrorEnabled

public boolean isErrorEnabled()

Specified by:

isErrorEnabled in interface org.slf4j.Logger

isErrorEnabled

public boolean isErrorEnabled(org.slf4j.Marker arg0)

Specified by:

isErrorEnabled in interface org.slf4j.Logger

isInfoEnabled

public boolean isInfoEnabled()

Specified by:

isInfoEnabled in interface org.slf4j.Logger

isInfoEnabled

public boolean isInfoEnabled(org.slf4j.Marker arg0)

Specified by:

isInfoEnabled in interface org.slf4j.Logger

isTraceEnabled

public boolean isTraceEnabled()

Specified by:

isTraceEnabled in interface org.slf4j.Logger

isTraceEnabled

public boolean isTraceEnabled(org.slf4j.Marker arg0)

Specified by:

isTraceEnabled in interface org.slf4j.Logger

isWarnEnabled

public boolean isWarnEnabled()

Specified by:

isWarnEnabled in interface org.slf4j.Logger

isWarnEnabled

public boolean isWarnEnabled(org.slf4j.Marker arg0)

Specified by:

isWarnEnabled in interface org.slf4j.Logger

trace

public void trace(java.lang.String arg0)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(java.lang.String arg0,
                  java.lang.Object arg1)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(java.lang.String arg0,
                  java.lang.Object... arg1)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(java.lang.String arg0,
                  java.lang.Throwable arg1)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(org.slf4j.Marker arg0,
                  java.lang.String arg1)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(java.lang.String arg0,
                  java.lang.Object arg1,
                  java.lang.Object arg2)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Object arg2)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Object... arg2)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Throwable arg2)

Specified by:

trace in interface org.slf4j.Logger

trace

public void trace(org.slf4j.Marker arg0,
                  java.lang.String arg1,
                  java.lang.Object arg2,
                  java.lang.Object arg3)

Specified by:

trace in interface org.slf4j.Logger

warn

public void warn(java.lang.String arg0)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(java.lang.String arg0,
                 java.lang.Object arg1)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(java.lang.String arg0,
                 java.lang.Object... arg1)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(java.lang.String arg0,
                 java.lang.Throwable arg1)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(org.slf4j.Marker arg0,
                 java.lang.String arg1)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(java.lang.String arg0,
                 java.lang.Object arg1,
                 java.lang.Object arg2)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(org.slf4j.Marker arg0,
                 java.lang.String arg1,
                 java.lang.Object arg2)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(org.slf4j.Marker arg0,
                 java.lang.String arg1,
                 java.lang.Object... arg2)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(org.slf4j.Marker arg0,
                 java.lang.String arg1,
                 java.lang.Throwable arg2)

Specified by:

warn in interface org.slf4j.Logger

warn

public void warn(org.slf4j.Marker arg0,
                 java.lang.String arg1,
                 java.lang.Object arg2,
                 java.lang.Object arg3)

Specified by:

warn in interface org.slf4j.Logger