Package org.robolectric.shadows

Class ShadowLog

java.lang.Object

org.robolectric.shadows.ShadowLog

@Implements(android.util.Log.class)
public class ShadowLog
extends Object

Controls the behavior of Log and provides access to log messages.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ShadowLog.LogItem	A single log item.

Field Summary

Fields

Modifier and Type	Field	Description
static PrintStream	stream

Constructor Summary

Constructors

Constructor	Description
ShadowLog()

Method Summary

Modifier and Type	Method	Description
static void	clear()	Clear all accumulated logs.
protected static int	d(String tag, String msg)
protected static int	d(String tag, String msg, Throwable throwable)
protected static int	e(String tag, String msg)
protected static int	e(String tag, String msg, Throwable throwable)
static com.google.common.collect.ImmutableList<ShadowLog.LogItem>	getLogs()	Returns ordered list of all log entries.
static com.google.common.collect.ImmutableList<ShadowLog.LogItem>	getLogsForTag(String tag)	Returns ordered list of all log items for a specific tag.
protected static int	i(String tag, String msg)
protected static int	i(String tag, String msg, Throwable throwable)
protected static boolean	isLoggable(String tag, int level)
protected static char	levelToChar(int level)
protected static int	println_native(int bufID, int priority, String tag, String msg)
static void	reset()
static void	setCaptureLogsEnabled(boolean isEnabled)	By default this Shadow will capture all logs in memory in order to facilitate the getLogs() and getLogsForTag(String) APIs.
static void	setLoggable(String tag, int level)	Sets the log level of a given tag, that isLoggable(java.lang.String, int) will follow.
static void	setTimeSupplier(Supplier<String> supplier)	Sets supplier that can be used to get time to add to logs.
static void	setupLogging()
static void	setWtfIsFatal(boolean fatal)	Sets whether calling Log.wtf(java.lang.String, java.lang.String) will throw Log.TerribleFailure.
protected static int	v(String tag, String msg)
protected static int	v(String tag, String msg, Throwable throwable)
protected static int	w(String tag, String msg)
protected static int	w(String tag, String msg, Throwable throwable)
protected static int	w(String tag, Throwable throwable)
protected static int	wtf(String tag, String msg)
protected static int	wtf(String tag, String msg, Throwable throwable)

Methods inherited from class java.lang.Object

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

Field Details

stream

public static PrintStream stream

Constructor Details

ShadowLog

public ShadowLog()

Method Details

e

@Implementation
protected static int e(String tag,
 String msg)

e

@Implementation
protected static int e(String tag,
 String msg,
 Throwable throwable)

d

@Implementation
protected static int d(String tag,
 String msg)

d

@Implementation
protected static int d(String tag,
 String msg,
 Throwable throwable)

i

@Implementation
protected static int i(String tag,
 String msg)

i

@Implementation
protected static int i(String tag,
 String msg,
 Throwable throwable)

v

@Implementation
protected static int v(String tag,
 String msg)

v

@Implementation
protected static int v(String tag,
 String msg,
 Throwable throwable)

w

@Implementation
protected static int w(String tag,
 String msg)

w

@Implementation
protected static int w(String tag,
 Throwable throwable)

w

@Implementation
protected static int w(String tag,
 String msg,
 Throwable throwable)

wtf

@Implementation
protected static int wtf(String tag,
 String msg)

wtf

@Implementation
protected static int wtf(String tag,
 String msg,
 Throwable throwable)

setWtfIsFatal

public static void setWtfIsFatal(boolean fatal)

Sets whether calling Log.wtf(java.lang.String, java.lang.String) will throw Log.TerribleFailure.

setTimeSupplier

public static void setTimeSupplier(Supplier<String> supplier)

Sets supplier that can be used to get time to add to logs.

isLoggable

@Implementation
protected static boolean isLoggable(String tag,
 int level)

println_native

@Implementation
protected static int println_native(int bufID,
 int priority,
 String tag,
 String msg)

setLoggable

public static void setLoggable(String tag,
 int level)

Sets the log level of a given tag, that isLoggable(java.lang.String, int) will follow.

Parameters:

tag - A log tag

level - A log level, from Log

levelToChar

protected static char levelToChar(int level)

setCaptureLogsEnabled

public static void setCaptureLogsEnabled(boolean isEnabled)

By default this Shadow will capture all logs in memory in order to facilitate the getLogs() and getLogsForTag(String) APIs. This is wasteful if these APIs are not actually used by tests.

This API allows disabling this behavior.

If log capturing is disabled, getLogs() and getLogsForTag(String) will throw if called.

Parameters:

isEnabled -

getLogs

public static com.google.common.collect.ImmutableList<ShadowLog.LogItem> getLogs()

Returns ordered list of all log entries.

Returns:

List of log items

getLogsForTag

public static com.google.common.collect.ImmutableList<ShadowLog.LogItem> getLogsForTag(String tag)

Returns ordered list of all log items for a specific tag.

Parameters:

tag - The tag to get logs for

Returns:

The list of log items for the tag or an empty list if no logs for that tag exist.

clear

public static void clear()

Clear all accumulated logs.

reset

@Resetter
public static void reset()

setupLogging

public static void setupLogging()