| org.eclipse.jdt.debug.core.IJavaObject
All known Subclasses: org.eclipse.jdt.internal.debug.core.model.JDIObjectValue, org.eclipse.jdt.internal.debug.core.logicalstructures.LogicalObjectStructureValue,
IJavaObject | public interface IJavaObject extends IJavaValue(Code) | | A value referencing an object on a target VM.
Clients are not intended to implement this interface.
See Also: IJavaValue since: 2.0 |
Method Summary | |
public void | disableCollection() Prevents this object from being garbage collected. | public void | enableCollection() Permits this object to be garbage collected. | public IJavaFieldVariable | getField(String name, boolean superField) Returns a variable representing the field in this object
with the given name, or null if there is no
field with the given name, or the name is ambiguous.
Parameters: name - field name Parameters: superField - whether or not to get the field in the superclassof this objects. | public IJavaFieldVariable | getField(String name, String typeSignature) Returns a variable representing the field in this object
with the given name declared in the type with the given
signature, or null if there is no
field with the given name, or the name is ambiguous.
Parameters: name - field name Parameters: typeSignature - the signature of the type in which the fieldis defined the variable representing the field, or null exception: DebugException - if this method fails. | public IJavaThread | getOwningThread() Returns the threads which owns for the monitor associated to this object, or
null if no thread owns the monitor.
the thread which owns the monitor, or null . exception: DebugException - if this method fails. | public IJavaObject[] | getReferringObjects(long max) Returns objects that directly reference this object. | public long | getUniqueId() Returns the unique id for this object. | public IJavaThread[] | getWaitingThreads() Returns the threads waiting for the monitor associated to this object, or
null if no thread is waiting for the monitor.
the thread waiting for the monitor, or null . exception: DebugException - if this method fails. | public IJavaValue | sendMessage(String selector, String signature, IJavaValue[] args, IJavaThread thread, boolean superSend) Returns the result of sending the specified message to this object
with the given arguments in the specified thread. | public IJavaValue | sendMessage(String selector, String signature, IJavaValue[] args, IJavaThread thread, String typeSignature) Returns the result of sending the specified message on the specified declaring type
to this object with the given arguments in the specified thread. |
disableCollection | public void disableCollection() throws DebugException(Code) | | Prevents this object from being garbage collected. Has no effect if this
VM does not support enabling/disabling of garbage collection of specific
objects.
throws: CoreException - if request fails See Also: IJavaDebugTarget since: 3.4 |
enableCollection | public void enableCollection() throws DebugException(Code) | | Permits this object to be garbage collected. Has no effect if this
VM does not support enabling/disabling of garbage collection of
specific objects.
throws: CoreException - if request fails See Also: IJavaDebugTarget since: 3.4 |
getField | public IJavaFieldVariable getField(String name, boolean superField) throws DebugException(Code) | | Returns a variable representing the field in this object
with the given name, or null if there is no
field with the given name, or the name is ambiguous.
Parameters: name - field name Parameters: superField - whether or not to get the field in the superclassof this objects. the variable representing the field, or null exception: DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
|
getField | public IJavaFieldVariable getField(String name, String typeSignature) throws DebugException(Code) | | Returns a variable representing the field in this object
with the given name declared in the type with the given
signature, or null if there is no
field with the given name, or the name is ambiguous.
Parameters: name - field name Parameters: typeSignature - the signature of the type in which the fieldis defined the variable representing the field, or null exception: DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
|
getOwningThread | public IJavaThread getOwningThread() throws DebugException(Code) | | Returns the threads which owns for the monitor associated to this object, or
null if no thread owns the monitor.
the thread which owns the monitor, or null . exception: DebugException - if this method fails. Reasons include:- The VM is not able to retrieve the monitor information
- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
since: 3.1 |
getReferringObjects | public IJavaObject[] getReferringObjects(long max) throws DebugException(Code) | | Returns objects that directly reference this object.
Parameters: max - the maximum number of references to retrieve or 0 for all references objects that directly reference this object throws: DebugException - since: 3.3 |
getUniqueId | public long getUniqueId() throws DebugException(Code) | | Returns the unique id for this object.
unique id or -1 if this value is null throws: DebugException - since: 3.4 |
getWaitingThreads | public IJavaThread[] getWaitingThreads() throws DebugException(Code) | | Returns the threads waiting for the monitor associated to this object, or
null if no thread is waiting for the monitor.
the thread waiting for the monitor, or null . exception: DebugException - if this method fails. Reasons include:- The VM is not able to retrieve the monitor information
- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
since: 3.1 |
sendMessage | public IJavaValue sendMessage(String selector, String signature, IJavaValue[] args, IJavaThread thread, boolean superSend) throws DebugException(Code) | | Returns the result of sending the specified message to this object
with the given arguments in the specified thread. The given
thread is resumed to perform the method invocation. The thread will suspend
in its original location when the method invocation is complete. This
method does not return until the method invocation is complete.
Invoking a method in the target VM can result in breakpoints being
hit, infinite loops, and deadlock.
Parameters: selector - the selector of the method to be invoked Parameters: signature - the JNI style signature of the method to be invoked Parameters: args - the arguments of the method, which can benull or empty if there are none Parameters: thread - the thread in which to invoke the method Parameters: superSend - true if the method lookup should begin in this object's superclass the result of invoking the method exception: DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
- This object does not implement the specified method
- An exception occurs while invoking the specified method
- The given thread is already performing a message send,(status code
IJavaThread.ERR_NESTED_METHOD_INVOCATION ) - The given thread is not currently suspended(status code
IJavaThread.ERR_THREAD_NOT_SUSPENDED ) - The given thread was explicitly suspended(status code
IJavaThread.ERR_INCOMPATIBLE_THREAD_STATE )
|
sendMessage | public IJavaValue sendMessage(String selector, String signature, IJavaValue[] args, IJavaThread thread, String typeSignature) throws DebugException(Code) | | Returns the result of sending the specified message on the specified declaring type
to this object with the given arguments in the specified thread. The given
thread is resumed to perform the method invocation. The thread will suspend
in its original location when the method invocation is complete. This
method does not return until the method invocation is complete.
Invoking a method in the target VM can result in breakpoints being
hit, infinite loops, and deadlock.
Parameters: selector - the selector of the method to be invoked Parameters: signature - the JNI style signature of the method to be invoked Parameters: args - the arguments of the method, which can benull or empty if there are none Parameters: thread - the thread in which to invoke the method Parameters: typeSignature - the signature of the type in which the methodis defined or null if the method should be invoked normally usingpolymorphism the result of invoking the method exception: DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
- This object does not implement the specified method
- An exception occurs while invoking the specified method
- The given thread is already performing a message send,(status code
IJavaThread.ERR_NESTED_METHOD_INVOCATION ) - The given thread is not currently suspended(status code
IJavaThread.ERR_THREAD_NOT_SUSPENDED ) - The given thread was explicitly suspended(status code
IJavaThread.ERR_INCOMPATIBLE_THREAD_STATE )
since: 2.0.1 |
|
|