flash.tools.debugger.threadsafe

Class ThreadSafeFrame

java.lang.Object

flash.tools.debugger.threadsafe.ThreadSafeFrame

All Implemented Interfaces:

Frame

public class ThreadSafeFrame
extends Object
implements Frame

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

Author:

Mike Morearty

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object other)
Variable[]	getArguments(Session s) Arguments that were passed into the function.
String	getCallSignature() Returns a string which contains the raw signature of the call.
int	getIsolateId() Returns the worker ID associated to this frame.
Variable[]	getLocals(Session s) Locals used within this function scope.
Location	getLocation() Location object related to this frame.
Variable[]	getScopeChain(Session s) Returns a list of objects which make up the scope chain of this frame.
Object	getSyncObject()
static Object	getSyncObject(Frame f)
Variable	getThis(Session s) 'this' variable for the frame.
int	hashCode()
String	toString()
static ThreadSafeFrame	wrap(Object syncObj, Frame frame) Wraps a Frame inside a ThreadSafeFrame.
static ThreadSafeFrame[]	wrapArray(Object syncObj, Frame[] frames) Wraps an array of Frames inside an array of ThreadSafeFrames.

Methods inherited from class java.lang.Object

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

Method Detail

wrap

public static ThreadSafeFrame wrap(Object syncObj,
                   Frame frame)

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

wrapArray

public static ThreadSafeFrame[] wrapArray(Object syncObj,
                          Frame[] frames)

Wraps an array of Frames inside an array of ThreadSafeFrames.

getSyncObject

public static Object getSyncObject(Frame f)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object other)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

getArguments

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

Description copied from interface: Frame

Arguments that were passed into the function. An empty array is used to denote that no arguments were passed into this function scope.

Specified by:

getArguments in interface Frame

Throws:

NoResponseException

NotSuspendedException

NotConnectedException

getCallSignature

public String getCallSignature()

Description copied from interface: Frame

Returns a string which contains the raw signature of the call. This information can be used for display purposes in the event the Location object contains a null SourceFile, which happens when a call is made into or through a non-debug executable. The format of the string is one of the following:

• declaringClass/[[namespace::]function] (for regular functions)
• declaringClass$cinit (class constructor for statics)
• declaringClass$iinit (class instance ctor)
• global$init

where declaringClass is the name of the class in which the function is declared (even if it is an anonymous inner function); namespace is the namespace of the function (the meaning of this varies depending on whether the function is private, protected etc.; see Variable.getNamespace() for more information); and function is the name of the function, or "" if the function is anonymous.

If the signature is unknown then the value "" will be returned. Note: this may occur even when Location contains a non-null SourceFile.

Examples:

• MyClass/myFunction for a public function
• MyClass/MyClass::myFunction for a private function
• MyClass/ for an anonymous inner function declared somewhere inside MyClass
• "" if unknown

Specified by:

getCallSignature in interface Frame

getLocals

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

Description copied from interface: Frame

Locals used within this function scope. An empty array is used to denote no locals are available within this function scope.

Specified by:

getLocals in interface Frame

Throws:

NoResponseException

NotSuspendedException

NotConnectedException

getLocation

public Location getLocation()

Description copied from interface: Frame

Location object related to this frame.

Specified by:

getLocation in interface Frame

getThis

public Variable getThis(Session s)
                 throws NoResponseException,
                        NotSuspendedException,
                        NotConnectedException

Description copied from interface: Frame

'this' variable for the frame. Will return null if no 'this' pointer available for the frame.

Specified by:

getThis in interface Frame

Throws:

NoResponseException

NotSuspendedException

NotConnectedException

getScopeChain

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

Description copied from interface: Frame

Returns a list of objects which make up the scope chain of this frame.

Some of the entries will be classes; some will be instances of classes; some will be functions; etc.

Bug: Currently, this does not include any scope chain entries which were created via "with var".

Specified by:

getScopeChain in interface Frame

Throws:

NoResponseException

NotSuspendedException

NotConnectedException

getIsolateId

public int getIsolateId()

Description copied from interface: Frame

Returns the worker ID associated to this frame. This will return Isolate.DEFAULT_ID, that is, the main worker.

Specified by:

getIsolateId in interface Frame

getSyncObject

public final Object getSyncObject()