flash.tools.debugger.threadsafe

Class ThreadSafeValueExp

java.lang.Object

flash.tools.debugger.threadsafe.ThreadSafeValueExp

All Implemented Interfaces:

ValueExp

public class ThreadSafeValueExp
extends Object
implements ValueExp

Thread-safe wrapper for flash.tools.debugger.expression.ValueExp

Author:

Mike Morearty

Constructor Summary

Constructors

Constructor and Description
ThreadSafeValueExp(Object syncObj, ValueExp valueExp)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	containsAssignment() Returns whether the expression contains any assignments (= or ++ or --).
Object	evaluate(Context context) Evaluates the expression.
Object	getSyncObject()
boolean	isLookupMembers() Returns whether evaluate() will return an object that explicitly shows the values of all members of the expression.
static ThreadSafeValueExp	wrap(Object syncObj, ValueExp valueExp) Wraps a ValueExp inside a ThreadSafeValueExp.

Methods inherited from class java.lang.Object

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

Constructor Detail

ThreadSafeValueExp

public ThreadSafeValueExp(Object syncObj,
                  ValueExp valueExp)

Method Detail

wrap

public static ThreadSafeValueExp wrap(Object syncObj,
                      ValueExp valueExp)

Wraps a ValueExp inside a ThreadSafeValueExp. If the passed-in ValueExp is null, then this function returns null.

evaluate

public Object evaluate(Context context)
                throws NumberFormatException,
                       NoSuchVariableException,
                       PlayerFaultException,
                       PlayerDebugException

Description copied from interface: ValueExp

Evaluates the expression. For example, if this node is a "+" node, with a 2 left child and a 2 right child, then the return value will be a long (that is, a java.lang.Long) with the value 4.

Specified by:

evaluate in interface ValueExp

Parameters:

context - the context in which the expression should be evaluated; primarily used for looking up variables. For example, when evaluating the expression "myvar", the context looks at locals, members of "this", etc.; when evaluating "myfield" node of the expression "myvar.myfield", the context looks at members of the variable "myvar".

Returns:

the value of the expression. This might be a literal Java constant (e.g. a Boolean, Integer, String, etc.); or it might be an UndefinedExp, representing the value 'undefined'; or it might be a Value; or it might be a Variable.

Throws:

NumberFormatException

NoSuchVariableException

PlayerFaultException

PlayerDebugException

See Also:

Context.lookup(Object)

containsAssignment

public boolean containsAssignment()

Description copied from interface: ValueExp

Returns whether the expression contains any assignments (= or ++ or --). Note, there are other kinds of expressions that can have side effects as well, such as function calls, or even simple expressions like "foo" if foo is a getter.

Specified by:

containsAssignment in interface ValueExp

isLookupMembers

public boolean isLookupMembers()

Description copied from interface: ValueExp

Returns whether evaluate() will return an object that explicitly shows the values of all members of the expression. For example, in fdb, if the user writes "print myvar", then isLookupMembers will be false, and the debugger will show just the value of myvar, but not the values of its members; but if the user writes "print myvar." (with a "." at the end), then the debugger will show the values of all of the members of myvar.

Specified by:

isLookupMembers in interface ValueExp

See Also:

ASTBuilder.ASTBuilder(boolean), ASTBuilder.isIndirectionOperatorAllowed()

getSyncObject

public final Object getSyncObject()