26 package com.sun.jdi; |
26 package com.sun.jdi; |
27 |
27 |
28 import java.util.List; |
28 import java.util.List; |
29 import java.util.Map; |
29 import java.util.Map; |
30 |
30 |
|
31 import com.sun.jdi.event.EventQueue; |
|
32 import com.sun.jdi.event.VMDisconnectEvent; |
|
33 |
31 /** |
34 /** |
32 * An object that currently exists in the target VM. An ObjectReference |
35 * An object that currently exists in the target VM. An ObjectReference |
33 * mirrors only the object itself and is not specific to any |
36 * mirrors only the object itself and is not specific to any |
34 * {@link Field} or {@link LocalVariable} to which it is currently |
37 * {@link Field} or {@link LocalVariable} to which it is currently |
35 * assigned. An ObjectReference can |
38 * assigned. An ObjectReference can have 0 or more references from |
36 * have 0 or more references from field(s) and/or variable(s). |
39 * field(s) and/or variable(s). |
37 * <p> |
40 * <p> |
38 * Any method on <code>ObjectReference</code> which directly or |
41 * Any method on <code>ObjectReference</code> which directly or indirectly |
39 * indirectly takes <code>ObjectReference</code> as an parameter may throw |
42 * takes <code>ObjectReference</code> as a parameter may throw |
40 * {@link com.sun.jdi.VMDisconnectedException} if the target VM is |
43 * {@link VMDisconnectedException} if the target VM is disconnected and the |
41 * disconnected and the {@link com.sun.jdi.event.VMDisconnectEvent} has been or is |
44 * {@link VMDisconnectEvent} has been or is available to be read from the |
42 * available to be read from the {@link com.sun.jdi.event.EventQueue}. |
45 * {@link EventQueue}. |
43 * <p> |
46 * <p> |
44 * Any method on <code>ObjectReference</code> which directly or |
47 * Any method on <code>ObjectReference</code> which directly or indirectly |
45 * indirectly takes <code>ObjectReference</code> as an parameter may throw |
48 * takes <code>ObjectReference</code> as a parameter may throw |
46 * {@link com.sun.jdi.VMOutOfMemoryException} if the target VM has run out of memory. |
49 * {@link VMOutOfMemoryException} if the target VM has run out of memory. |
47 * <p> |
50 * <p> |
48 * Any method on <code>ObjectReference</code> or which directly or indirectly takes |
51 * Any method on <code>ObjectReference</code> or which directly or indirectly |
49 * <code>ObjectReference</code> as parameter may throw |
52 * takes <code>ObjectReference</code> as parameter may throw |
50 * {@link com.sun.jdi.ObjectCollectedException} if the mirrored object has been |
53 * {@link ObjectCollectedException} if the mirrored object has been |
51 * garbage collected. |
54 * garbage collected. |
52 * |
55 * |
53 * @author Robert Field |
56 * @author Robert Field |
54 * @author Gordon Hirsch |
57 * @author Gordon Hirsch |
55 * @author James McIlree |
58 * @author James McIlree |
420 * than zero. |
423 * than zero. |
421 * @since 1.6 |
424 * @since 1.6 |
422 */ |
425 */ |
423 List<ObjectReference> referringObjects(long maxReferrers); |
426 List<ObjectReference> referringObjects(long maxReferrers); |
424 |
427 |
425 |
|
426 /** |
428 /** |
427 * Compares the specified Object with this ObjectReference for equality. |
429 * Compares the specified Object with this ObjectReference for equality. |
428 * |
430 * |
429 * @return true if the Object is an ObjectReference, if the |
431 * @return true if the Object is an ObjectReference, if the |
430 * ObjectReferences belong to the same VM, and if applying the |
432 * ObjectReferences belong to the same VM, and if applying the |