Package com.sportradar.livedata.sdk.common.classes

Class NullSdkLogger

java.lang.Object

com.sportradar.livedata.sdk.common.classes.NullSdkLogger

All Implemented Interfaces:

SdkLogger

public class NullSdkLogger
extends Object
implements SdkLogger

Null SDK logger implementation.

Field Summary

Fields

Modifier and Type	Field	Description
static SdkLogger	INSTANCE

Method Summary

Modifier and Type	Method	Description
boolean	isDebugEnabled(SdkLogAppenderType sdkLogAppenderType)	Return true when logger with given appender type have current log level equal to debug, otherwise return false.
boolean	isErrorEnabled(SdkLogAppenderType sdkLogAppenderType)	Return true when logger with given appender type have current log level equal to error, otherwise return false.
boolean	isInfoEnabled(SdkLogAppenderType sdkLogAppenderType)	Return true when logger with given appender type have current log level equal to info, otherwise return false.
boolean	isLevelEnabled(ch.qos.logback.classic.Level level, SdkLogAppenderType sdkLogAppenderType)	Return true when logger with given appender type have current log level equal to given level, otherwise false.
boolean	isTraceEnabled(SdkLogAppenderType sdkLogAppenderType)	Return true when logger with given appender type have current log level equal to trace, otherwise return false.
boolean	isWarnEnabled(SdkLogAppenderType sdkLogAppenderType)	Return true when logger with given appender type have current log level equal to warn, otherwise return false.
void	logAlert(ch.qos.logback.classic.Level level, String message)	SDK will generate and signal alerts in case of any special events.
void	logAlert(ch.qos.logback.classic.Level level, String message, Exception exception)	SDK will generate and signal alerts in case of any special events.
void	logClientInteraction(ch.qos.logback.classic.Level level, String message)	All interaction with the client software on the SDK interface level will be logged in a separate client communication log.
void	logClientInteraction(ch.qos.logback.classic.Level level, String message, Exception exception)	All interaction with the client software on the SDK interface level will be logged in a separate client communication log.
void	logClientInteraction(ch.qos.logback.classic.Level level, String message, org.joda.time.Duration interval, Exception exception)	All interaction with the client software on the SDK interface level will be logged in a separate client communication log.
void	logInvalidMessage(ch.qos.logback.classic.Level level, String message)	Corrupt input feed data will be dumped into log files dedicated to corrupt input data (could be garbage and not even text, exceeding max buffer size).
void	logTraffic(boolean outgoing, String message)	Depending on configuration SDK will be able to dump all feed XML traffic into dedicated traffic logs.
void	logTraffic(String message)	Dump given message to traffic log.

Methods inherited from class java.lang.Object

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

Field Detail

INSTANCE

public static final SdkLogger INSTANCE

Method Detail

logInvalidMessage

public void logInvalidMessage(ch.qos.logback.classic.Level level,
                              String message)

Corrupt input feed data will be dumped into log files dedicated to corrupt input data (could be garbage and not even text, exceeding max buffer size). Invalid input messages will be dumped into log files dedicated to invalid input messages (text, but not necessarily XML).

Specified by:

logInvalidMessage in interface SdkLogger

Parameters:

level - Log level

message - Invalid message

logTraffic

public void logTraffic(boolean outgoing,
                       String message)

Depending on configuration SDK will be able to dump all feed XML traffic into dedicated traffic logs. This data is already logged at the feed server level but here the client will have possibility to configure traffic log filters based on the type of message, level of detail, match id, etc.

Specified by:

logTraffic in interface SdkLogger

Parameters:

outgoing - when true it specifies a message the SDK has sent; false means that a message SDK received

message - Message that was either read or written to the communication channel

logTraffic

public void logTraffic(String message)

Dump given message to traffic log.

Specified by:

logTraffic in interface SdkLogger

Parameters:

message - Message that was either read or written to the channel

logClientInteraction

public void logClientInteraction(ch.qos.logback.classic.Level level,
                                 String message)

All interaction with the client software on the SDK interface level will be logged in a separate client communication log. This includes all method invocations on the SDK interface including parameter values, request parameter validation errors and other errors returned by the SDK, unhandled client exceptions, errors reported by the client handlers, timings of each call, etc.

Specified by:

logClientInteraction in interface SdkLogger

Parameters:

level - Log level

message - String message

logClientInteraction

public void logClientInteraction(ch.qos.logback.classic.Level level,
                                 String message,
                                 Exception exception)

All interaction with the client software on the SDK interface level will be logged in a separate client communication log. This includes all method invocations on the SDK interface including parameter values, request parameter validation errors and other errors returned by the SDK, unhandled client exceptions, errors reported by the client handlers, timings of each call, etc.

Specified by:

logClientInteraction in interface SdkLogger

Parameters:

level - Log level

message - String message

exception - Optional exception

logClientInteraction

public void logClientInteraction(ch.qos.logback.classic.Level level,
                                 String message,
                                 org.joda.time.Duration interval,
                                 Exception exception)

All interaction with the client software on the SDK interface level will be logged in a separate client communication log. This includes all method invocations on the SDK interface including parameter values, request parameter validation errors and other errors returned by the SDK, unhandled client exceptions, errors reported by the client handlers, timings of each call, etc.

Specified by:

logClientInteraction in interface SdkLogger

Parameters:

level - Log level

message - String message

interval - Elapsed time while processing client request or client handler invocation (optional)

exception - Optional exception

logAlert

public void logAlert(ch.qos.logback.classic.Level level,
                     String message)

SDK will generate and signal alerts in case of any special events. This could happen when network connection is dropped, rate-limiting thresholds are exceeded, when going over queue low/high watermarks, when feed error recovery is in progress, if persistent state store gets out-of-sync, when event dispatching is put on pause, when SDK library is reloaded, current status of login sequence, etc. Alerts will be dumped into dedicated alert logs. Special alerts (configurable) could be logged to other log appenders, like SMTP appender, NT Event Log appender or JmxLogger appender.

Specified by:

logAlert in interface SdkLogger

Parameters:

level - Log level

message - Alert message

logAlert

public void logAlert(ch.qos.logback.classic.Level level,
                     String message,
                     Exception exception)

SDK will generate and signal alerts in case of any special events. This could happen when network connection is dropped, rate-limiting thresholds are exceeded, when going over queue low/high watermarks, when feed error recovery is in progress, if persistent state store gets out-of-sync, when event dispatching is put on pause, when SDK library is reloaded, current status of login sequence, etc. Alerts will be dumped into dedicated alert logs. Special alerts (configurable) could be logged to other log appenders, like SMTP appender, NT Event Log appender or JmxLogger appender.

Specified by:

logAlert in interface SdkLogger

Parameters:

level - - Log level

message - Alert message

exception - Optional exception

isLevelEnabled

public boolean isLevelEnabled(ch.qos.logback.classic.Level level,
                              SdkLogAppenderType sdkLogAppenderType)

Return true when logger with given appender type have current log level equal to given level, otherwise false.

Specified by:

isLevelEnabled in interface SdkLogger

Parameters:

level - specified level

sdkLogAppenderType - specified appender type

Returns:

true when logger with appender type have current level equal to level, otherwise false

isDebugEnabled

public boolean isDebugEnabled(SdkLogAppenderType sdkLogAppenderType)

Return true when logger with given appender type have current log level equal to debug, otherwise return false.

Specified by:

isDebugEnabled in interface SdkLogger

Parameters:

sdkLogAppenderType - specified appender type

Returns:

true when logger with appender type have current level equal to debug, otherwise false

isInfoEnabled

public boolean isInfoEnabled(SdkLogAppenderType sdkLogAppenderType)

Return true when logger with given appender type have current log level equal to info, otherwise return false.

Specified by:

isInfoEnabled in interface SdkLogger

Parameters:

sdkLogAppenderType - specified appender type

Returns:

true when logger with appender type have current level equal to info, otherwise false

isWarnEnabled

public boolean isWarnEnabled(SdkLogAppenderType sdkLogAppenderType)

Return true when logger with given appender type have current log level equal to warn, otherwise return false.

Specified by:

isWarnEnabled in interface SdkLogger

Parameters:

sdkLogAppenderType - specified appender type

Returns:

true when logger with appender type have current level equal to warn, otherwise false

isErrorEnabled

public boolean isErrorEnabled(SdkLogAppenderType sdkLogAppenderType)

Return true when logger with given appender type have current log level equal to error, otherwise return false.

Specified by:

isErrorEnabled in interface SdkLogger

Parameters:

sdkLogAppenderType - specified appender type

Returns:

true when logger with appender type have current level equal to error, otherwise false

isTraceEnabled

public boolean isTraceEnabled(SdkLogAppenderType sdkLogAppenderType)

Return true when logger with given appender type have current log level equal to trace, otherwise return false.

Specified by:

isTraceEnabled in interface SdkLogger

Parameters:

sdkLogAppenderType - specified appender type

Returns:

true when logger with appender type have current level equal to trace, otherwise false