flash.tools.debugger.threadsafe

Class ThreadSafeValue

java.lang.Object

flash.tools.debugger.threadsafe.ThreadSafeValue

All Implemented Interfaces:

Value

public class ThreadSafeValue
extends Object
implements Value

Thread-safe wrapper for flash.tools.debugger.Value

Author:

Mike Morearty

Field Summary

Fields inherited from interface flash.tools.debugger.Value

BASE_ID, GLOBAL_ID, LEVEL_ID, ROOT_ID, THIS_ID, TRAITS_TYPE_NAME, UNDEFINED, UNKNOWN_ID

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object other)
int	getAttributes() Variable attributes define further information regarding the variable.
String[]	getClassHierarchy(boolean allLevels) Returns the list of classes that contributed members to this object, from the class itself all the way down to Object (or, if allLevels == false, down to the lowest-level class that actually contributed members).
String	getClassName() The class name of the value.
long	getId() Returns a unique ID for the object referred to by this variable.
int	getIsolateId() Get the worker id of the isolate to which this value belongs.
int	getMemberCount(Session s) Returns the number of child members of this variable.
Variable	getMemberNamed(Session s, String name) Returns a specific child member of this variable.
Variable[]	getMembers(Session s) Returns all child members of this variable.
Variable[]	getPrivateInheritedMemberNamed(String name) Get all the private variables with the given name.
Variable[]	getPrivateInheritedMembers() Returns all child members of this variable that are private and are present in its inheritance chain.
static Value	getRaw(Value v) Returns the raw Value underlying a ThreadSafeValue.
Object	getSyncObject()
static Object	getSyncObject(Value v)
int	getType() Variable type can be one of VariableType.OBJECT, VariableType.FUNCTION, VariableType.NUMBER, VariableType.STRING, VariableType.UNDEFINED, VariableType.NULL.
String	getTypeName() The type name of the value: "Number" "Boolean" "String" "null" "undefined" Value.TRAITS_TYPE_NAME if this value represents the traits of a class "[package::]Classname@hexaddr" if this value represents an instance of a non-primitive object.
Object	getValueAsObject() Returns the value of the variable, as an Object.
String	getValueAsString() Returns the value of the variable, converted to a string.
boolean	isAttributeSet(int variableAttribute)
String	toString()
static ThreadSafeValue	wrap(Object syncObj, Value val) Wraps a Value inside a ThreadSafeValue.
static ThreadSafeValue[]	wrapArray(Object syncObj, Value[] values) Wraps an array of Values inside an array of ThreadSafeValues.

Methods inherited from class java.lang.Object

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

Method Detail

wrap

public static ThreadSafeValue wrap(Object syncObj,
                   Value val)

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

wrapArray

public static ThreadSafeValue[] wrapArray(Object syncObj,
                          Value[] values)

Wraps an array of Values inside an array of ThreadSafeValues.

getRaw

public static Value getRaw(Value v)

Returns the raw Value underlying a ThreadSafeValue.

getSyncObject

public static Object getSyncObject(Value v)

equals

public boolean equals(Object other)

Overrides:

equals in class Object

getAttributes

public int getAttributes()

Description copied from interface: Value

Variable attributes define further information regarding the variable. They are bitfields identified as VariableAttribute.xxx

Specified by:

getAttributes in interface Value

See Also:

VariableAttribute

getClassName

public String getClassName()

Description copied from interface: Value

The class name of the value. This isn't actually very useful, and should probably go away; it had more relevant in ActionScript 2, when the return value from this function could have been any one of the strings returned by DVariable.classNameFor(long, boolean). In the AS3 world, the only possible return values from this function are:

• "Object" for instances of non-primitive classes such as Object, Array, etc.
• "" all primitive values (Number, Boolean, String, null, undefined), or the traits of a class.

Specified by:

getClassName in interface Value

getId

public long getId()

Description copied from interface: Value

Returns a unique ID for the object referred to by this variable. If two variables point to the same underlying object, their getId() functions will return the same value. This is only meaningful for variables that store an Object or MovieClip. For other types of variables (e.g. integers and strings), this returns UNKNOWN_ID.

Specified by:

getId in interface Value

getMemberCount

public int getMemberCount(Session s)
                   throws NotSuspendedException,
                          NoResponseException,
                          NotConnectedException

Description copied from interface: Value

Returns the number of child members of this variable. If called for a variable which has a simple type such as integer or string, returns zero.

Specified by:

getMemberCount in interface Value

Throws:

NotSuspendedException

NoResponseException

NotConnectedException

getMemberNamed

public Variable getMemberNamed(Session s,
                      String name)
                        throws NotSuspendedException,
                               NoResponseException,
                               NotConnectedException

Description copied from interface: Value

Returns a specific child member of this variable. Can only be called for variables of type Object or MovieClip.

Specified by:

getMemberNamed in interface Value

Parameters:

s - the session

name - just a varname name, without its namespace (see getName())

Returns:

the specified child member, or null if there is no such child.

Throws:

NotSuspendedException

NoResponseException

NotConnectedException

getMembers

public Variable[] getMembers(Session s)
                      throws NotSuspendedException,
                             NoResponseException,
                             NotConnectedException

Description copied from interface: Value

Returns all child members of this variable. Can only be called for variables of type Object or MovieClip.

Specified by:

getMembers in interface Value

Throws:

NotSuspendedException

NoResponseException

NotConnectedException

getType

public int getType()

Description copied from interface: Value

Variable type can be one of VariableType.OBJECT, VariableType.FUNCTION, VariableType.NUMBER, VariableType.STRING, VariableType.UNDEFINED, VariableType.NULL.

Specified by:

getType in interface Value

getTypeName

public String getTypeName()

Description copied from interface: Value

The type name of the value:

• "Number"
• "Boolean"
• "String"
• "null"
• "undefined"
• Value.TRAITS_TYPE_NAME if this value represents the traits of a class
• "[package::]Classname@hexaddr" if this value represents an instance of a non-primitive object. For example, if this is an instance of mx.core.Application, the type name might be "mx.core::Application@1234abcd".

Specified by:

getTypeName in interface Value

getValueAsObject

public Object getValueAsObject()

Description copied from interface: Value

Returns the value of the variable, as an Object. The return value will always be one of the following:

• null
• Value.UNDEFINED
• a Boolean
• a Double (careful, it might be Double.NaN)
• a String
• a Long if this value represents a non-primitive type, such as an Object. If it is a Long, then it is the id of the Value (the same value returned by getId()).

Specified by:

getValueAsObject in interface Value

getValueAsString

public String getValueAsString()

Description copied from interface: Value

Returns the value of the variable, converted to a string. Strings are returned as the exact value of the string itself, with no extra quotation marks and no escaping of characters within the string.

Specified by:

getValueAsString in interface Value

isAttributeSet

public boolean isAttributeSet(int variableAttribute)

Specified by:

isAttributeSet in interface Value

See Also:

VariableAttribute

getClassHierarchy

public String[] getClassHierarchy(boolean allLevels)

Description copied from interface: Value

Returns the list of classes that contributed members to this object, from the class itself all the way down to Object (or, if allLevels == false, down to the lowest-level class that actually contributed members).

Specified by:

getClassHierarchy in interface Value

Parameters:

allLevels - if true, the caller wants the entire class hierarchy. If false, the caller wants only that portion of the class hierarchy that actually contributed member variables to the object. For example, Object has no members, so if the caller passes true then the returned array of strings will always end with Object, but if the caller passes false then the returned array of strings will never end with Object.

Returns:

an array of fully qualified class names.

toString

public String toString()

Overrides:

toString in class Object

getPrivateInheritedMembers

public Variable[] getPrivateInheritedMembers()

Description copied from interface: Value

Returns all child members of this variable that are private and are present in its inheritance chain. Only relevant after a call to getMembers(). Warning: This may contain variables with the same name (when there is more than two level inheritance).

Specified by:

getPrivateInheritedMembers in interface Value

getPrivateInheritedMemberNamed

public Variable[] getPrivateInheritedMemberNamed(String name)

Description copied from interface: Value

Get all the private variables with the given name. Usually one, but more may be present if the inheritance chain is long.

Specified by:

getPrivateInheritedMemberNamed in interface Value

Parameters:

name - Variable name.

getIsolateId

public int getIsolateId()

Description copied from interface: Value

Get the worker id of the isolate to which this value belongs.

Specified by:

getIsolateId in interface Value

getSyncObject

public final Object getSyncObject()