com.oracle.graal.debug.internal

Class DebugScope

java.lang.Object

com.oracle.graal.debug.internal.DebugScope

All Implemented Interfaces:

Debug.Scope, AutoCloseable

public final class DebugScope
extends Object
implements Debug.Scope

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	DebugScope.IndentImpl

Field Summary

Fields

Modifier and Type	Field and Description
private static ThreadLocal<DebugConfig>	configTL
private Object[]	context
private int	currentDumpLevel
private int	currentLogLevel
(package private) static Object[]	EMPTY_CONTEXT
private static ThreadLocal<DebugScope>	instanceTL
private static ThreadLocal<DebugScope>	lastClosedTL
private static ThreadLocal<Throwable>	lastExceptionThrownTL
private DebugScope.IndentImpl	lastUsedIndent
private boolean	logScopeName
private boolean	memUseTrackingEnabled
private boolean	meterEnabled
private PrintStream	output
private DebugScope	parent
private DebugConfig	parentConfig
private String	qualifiedName
private boolean	sandbox
private static char	SCOPE_SEP
private boolean	timeEnabled
private String	unqualifiedName
private DebugValueMap	valueMap
private boolean	verifyEnabled

Constructor Summary

Constructors

Modifier	Constructor and Description
private	DebugScope(String unqualifiedName, DebugScope parent, boolean sandbox, Object... context)
private	DebugScope(Thread thread)

Method Summary

Modifier and Type	Method and Description
static <T> T	call(Callable<T> callable)
void	close()
private void	computeValueMap(String name)
private DebugScope	createChild(String newName, Object[] newContext)
void	dump(int dumpLevel, Object object, String formatString, Object... args)
private static TopLevelDebugConfig	fetchTopLevelDebugConfig(String msg)
static void	forceDump(Object object, String format, Object... args) This method exists mainly to allow a debugger (e.g., Eclipse) to force dump a graph.
static DebugConfig	getConfig()
Iterable<Object>	getCurrentContext()
(package private) long	getCurrentValue(int index)
static DebugScope	getInstance()
DebugScope.IndentImpl	getLastUsedIndent()
String	getQualifiedName()
private DebugValueMap	getValueMap()
RuntimeException	handle(Throwable e)
private RuntimeException	interceptException(Throwable e)
boolean	isDumpEnabled(int dumpLevel)
boolean	isLogEnabled(int logLevel)
boolean	isMemUseTrackingEnabled()
boolean	isMeterEnabled()
boolean	isTimeEnabled()
boolean	isVerifyEnabled()
void	log(int logLevel, String msg, Object... args)
Indent	pushIndentLogger()
private static void	recursiveUpdateFlags()
DebugScope	scope(CharSequence name, DebugConfig sandboxConfig, Object... newContextObjects) Creates and enters a new debug scope which is either a child of the current scope or a disjoint top level scope.
void	setConfig(DebugConfig newConfig)
(package private) void	setCurrentValue(int index, long l)
static void	setDumpLevel(int dumpLevel) Enable dumping at the new dumpLevel for the remainder of enclosing scopes.
static void	setLogLevel(int logLevel) Enable logging at the new logLevel for the remainder of enclosing scopes.
private void	updateFlags()
void	verify(Object object, String formatString, Object... args)

Methods inherited from class java.lang.Object

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

Field Detail

instanceTL

private static final ThreadLocal<DebugScope> instanceTL

lastClosedTL

private static final ThreadLocal<DebugScope> lastClosedTL

configTL

private static final ThreadLocal<DebugConfig> configTL

lastExceptionThrownTL

private static final ThreadLocal<Throwable> lastExceptionThrownTL

parent

private final DebugScope parent

parentConfig

private final DebugConfig parentConfig

sandbox

private final boolean sandbox

lastUsedIndent

private DebugScope.IndentImpl lastUsedIndent

logScopeName

private boolean logScopeName

context

private final Object[] context

valueMap

private DebugValueMap valueMap

qualifiedName

private String qualifiedName

unqualifiedName

private final String unqualifiedName

SCOPE_SEP

private static final char SCOPE_SEP

See Also:

Constant Field Values

meterEnabled

private boolean meterEnabled

timeEnabled

private boolean timeEnabled

memUseTrackingEnabled

private boolean memUseTrackingEnabled

verifyEnabled

private boolean verifyEnabled

currentDumpLevel

private int currentDumpLevel

currentLogLevel

private int currentLogLevel

output

private PrintStream output

EMPTY_CONTEXT

static final Object[] EMPTY_CONTEXT

Constructor Detail

DebugScope

private DebugScope(Thread thread)

DebugScope

private DebugScope(String unqualifiedName,
                   DebugScope parent,
                   boolean sandbox,
                   Object... context)

Method Detail

getInstance

public static DebugScope getInstance()

getConfig

public static DebugConfig getConfig()

computeValueMap

private void computeValueMap(String name)

close

public void close()

Specified by:

close in interface Debug.Scope

Specified by:

close in interface AutoCloseable

isDumpEnabled

public boolean isDumpEnabled(int dumpLevel)

setDumpLevel

public static void setDumpLevel(int dumpLevel)

Enable dumping at the new dumpLevel for the remainder of enclosing scopes. This only works if a TopLevelDebugConfig was installed at a higher scope.

Parameters:

dumpLevel -

setLogLevel

public static void setLogLevel(int logLevel)

Enable logging at the new logLevel for the remainder of enclosing scopes. This only works if a TopLevelDebugConfig was installed at a higher scope.

Parameters:

logLevel -

recursiveUpdateFlags

private static void recursiveUpdateFlags()

fetchTopLevelDebugConfig

private static TopLevelDebugConfig fetchTopLevelDebugConfig(String msg)

isVerifyEnabled

public boolean isVerifyEnabled()

isLogEnabled

public boolean isLogEnabled(int logLevel)

isMeterEnabled

public boolean isMeterEnabled()

isTimeEnabled

public boolean isTimeEnabled()

isMemUseTrackingEnabled

public boolean isMemUseTrackingEnabled()

log

public void log(int logLevel,
                String msg,
                Object... args)

dump

public void dump(int dumpLevel,
                 Object object,
                 String formatString,
                 Object... args)

forceDump

public static void forceDump(Object object,
                             String format,
                             Object... args)

This method exists mainly to allow a debugger (e.g., Eclipse) to force dump a graph.

verify

public void verify(Object object,
                   String formatString,
                   Object... args)

See Also:

Debug.verify(Object, String)

scope

public DebugScope scope(CharSequence name,
                        DebugConfig sandboxConfig,
                        Object... newContextObjects)

Creates and enters a new debug scope which is either a child of the current scope or a disjoint top level scope.

Parameters:

name - the name of the new scope

sandboxConfig - the configuration to use for a new top level scope, or null if the new scope should be a child scope

newContextObjects - objects to be appended to the debug context

Returns:

the new scope which will be exited when its close() method is called

handle

public RuntimeException handle(Throwable e)

updateFlags

private void updateFlags()

interceptException

private RuntimeException interceptException(Throwable e)

getValueMap

private DebugValueMap getValueMap()

getCurrentValue

long getCurrentValue(int index)

setCurrentValue

void setCurrentValue(int index,
                     long l)

createChild

private DebugScope createChild(String newName,
                               Object[] newContext)

getCurrentContext

public Iterable<Object> getCurrentContext()

call

public static <T> T call(Callable<T> callable)

setConfig

public void setConfig(DebugConfig newConfig)

getQualifiedName

public String getQualifiedName()

pushIndentLogger

public Indent pushIndentLogger()

getLastUsedIndent

public DebugScope.IndentImpl getLastUsedIndent()