Package org.webrtc

Class Logging

java.lang.Object

org.webrtc.Logging

public class Logging
extends Object

Java wrapper for WebRTC logging. Logging defaults to java.util.logging.Logger, but a custom logger implementing the Loggable interface can be injected along with a Severity. All subsequent log messages will then be redirected to the injected Loggable, except those with a severity lower than the specified severity, which will be discarded. It is also possible to switch to native logging (rtc::LogMessage) if one of the following static functions are called from the app: - Logging.enableLogThreads - Logging.enableLogTimeStamps - Logging.enableLogToDebugOutput The priority goes: 1. Injected loggable 2. Native logging 3. Fallback logging. Only one method will be used at a time. Injecting a Loggable or using any of the enable... methods requires that the native library is loaded, using PeerConnectionFactory.initialize.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	Logging.Severity
static enum	Logging.TraceLevel	Deprecated.

Field Summary

Fields

Modifier and Type	Field	Description
private static final Logger	fallbackLogger
private static Loggable	loggable
private static Logging.Severity	loggableSeverity
private static boolean	loggingEnabled

Constructor Summary

Constructors

Constructor	Description
Logging()

Method Summary

Modifier and Type	Method	Description
private static Logger	createFallbackLogger()
static void	d(String tag, String message)
(package private) static void	deleteInjectedLoggable()
static void	e(String tag, String message)
static void	e(String tag, String message, Throwable e)
static void	enableLogThreads()
static void	enableLogTimeStamps()
static void	enableLogToDebugOutput(Logging.Severity severity)
static void	enableTracing(String path, EnumSet<Logging.TraceLevel> levels)	Deprecated.
private static String	getStackTraceString(Throwable e)
(package private) static void	injectLoggable(Loggable injectedLoggable, Logging.Severity severity)
static void	log(Logging.Severity severity, String tag, String message)
private static void	nativeEnableLogThreads()
private static void	nativeEnableLogTimeStamps()
private static void	nativeEnableLogToDebugOutput(int nativeSeverity)
private static void	nativeLog(int severity, String tag, String message)
static void	v(String tag, String message)
static void	w(String tag, String message)
static void	w(String tag, String message, Throwable e)

Methods inherited from class java.lang.Object

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

Field Details

fallbackLogger

private static final Logger fallbackLogger

loggingEnabled

private static volatile boolean loggingEnabled

loggable

@Nullable
private static Loggable loggable

loggableSeverity

private static Logging.Severity loggableSeverity

Constructor Details

Logging

public Logging()

Method Details

createFallbackLogger

private static Logger createFallbackLogger()

injectLoggable

static void injectLoggable(Loggable injectedLoggable,
 Logging.Severity severity)

deleteInjectedLoggable

static void deleteInjectedLoggable()

enableLogThreads

public static void enableLogThreads()

enableLogTimeStamps

public static void enableLogTimeStamps()

enableTracing

@Deprecated
public static void enableTracing(String path,
 EnumSet<Logging.TraceLevel> levels)

Deprecated.

enableLogToDebugOutput

public static void enableLogToDebugOutput(Logging.Severity severity)

log

public static void log(Logging.Severity severity,
 String tag,
 String message)

d

public static void d(String tag,
 String message)

e

public static void e(String tag,
 String message)

w

public static void w(String tag,
 String message)

e

public static void e(String tag,
 String message,
 Throwable e)

w

public static void w(String tag,
 String message,
 Throwable e)

v

public static void v(String tag,
 String message)

getStackTraceString

private static String getStackTraceString(Throwable e)

nativeEnableLogToDebugOutput

private static void nativeEnableLogToDebugOutput(int nativeSeverity)

nativeEnableLogThreads

private static void nativeEnableLogThreads()

nativeEnableLogTimeStamps

private static void nativeEnableLogTimeStamps()

nativeLog

private static void nativeLog(int severity,
 String tag,
 String message)