28 * <p> 29 * The Java™ Debug Interface (JDI) is a high level Java API providing 30 * information useful for debuggers and similar systems needing access to the 31 * running state of a (usually remote) virtual machine. 32 * <p> 33 * JDI provides introspective access to a running virtual machine's state, 34 * Class, Array, Interface, and primitive types, and instances of those types. 35 * <p> 36 * JDI also provides explicit control over a virtual machine's execution. 37 * The ability to suspend and resume threads, and to set breakpoints, 38 * watchpoints, etc. Notification of exceptions, class loading, thread 39 * creation, etc. The ability to inspect a suspended thread's state, local 40 * variables, stack backtrace, etc. 41 * <p> 42 * JDI is the highest-layer of the Java Platform Debugger Architecture (JPDA). 43 * For more information on the Java Platform Debugger Architecture, see the <a 44 * href="{@docRoot}/../../../../technotes/guides/jpda/index.html"> Java 45 * Platform Debugger Architecture documentation</a> for this release and the <a 46 * href="http://java.sun.com/products/jpda">Java Platform Debugger Architecture 47 * website</a>. 48 * <p> 49 * <font size="+1"><b>Global Exceptions:</b></font> 50 * <p> 51 * This section documents exceptions which apply to the entire API and are thus 52 * not documented on individual methods. 53 * <blockquote> 54 * <p> 55 * <b>{@link com.sun.jdi.VMMismatchException}</b> 56 * <p> 57 * Any method on a {@link com.sun.jdi.Mirror} that takes a 58 * {@code Mirror} as an parameter directly or indirectly (e.g., as a 59 * element in a {@code List}) will throw {@link 60 * com.sun.jdi.VMMismatchException} if the mirrors are from different virtual 61 * machines. 62 * <p> 63 * <b>{@link java.lang.NullPointerException}</b> 64 * <p> 65 * Any method which takes a {@link java.lang.Object} as an parameter will 66 * throw {@link java.lang.NullPointerException} if null is passed directly or 67 * indirectly -- unless null is explicitly mentioned as a valid parameter. 68 * </blockquote> 69 * NOTE: The exceptions below may be thrown whenever the specified conditions 70 * are met but a guarantee that they are thrown only exists when a valid result | 28 * <p> 29 * The Java™ Debug Interface (JDI) is a high level Java API providing 30 * information useful for debuggers and similar systems needing access to the 31 * running state of a (usually remote) virtual machine. 32 * <p> 33 * JDI provides introspective access to a running virtual machine's state, 34 * Class, Array, Interface, and primitive types, and instances of those types. 35 * <p> 36 * JDI also provides explicit control over a virtual machine's execution. 37 * The ability to suspend and resume threads, and to set breakpoints, 38 * watchpoints, etc. Notification of exceptions, class loading, thread 39 * creation, etc. The ability to inspect a suspended thread's state, local 40 * variables, stack backtrace, etc. 41 * <p> 42 * JDI is the highest-layer of the Java Platform Debugger Architecture (JPDA). 43 * For more information on the Java Platform Debugger Architecture, see the <a 44 * href="{@docRoot}/../../../../technotes/guides/jpda/index.html"> Java 45 * Platform Debugger Architecture documentation</a> for this release and the <a 46 * href="http://java.sun.com/products/jpda">Java Platform Debugger Architecture 47 * website</a>. 48 * <p style="font-size:larger"> 49 * <b>Global Exceptions:</b> 50 * <p> 51 * This section documents exceptions which apply to the entire API and are thus 52 * not documented on individual methods. 53 * <blockquote> 54 * <p> 55 * <b>{@link com.sun.jdi.VMMismatchException}</b> 56 * <p> 57 * Any method on a {@link com.sun.jdi.Mirror} that takes a 58 * {@code Mirror} as an parameter directly or indirectly (e.g., as a 59 * element in a {@code List}) will throw {@link 60 * com.sun.jdi.VMMismatchException} if the mirrors are from different virtual 61 * machines. 62 * <p> 63 * <b>{@link java.lang.NullPointerException}</b> 64 * <p> 65 * Any method which takes a {@link java.lang.Object} as an parameter will 66 * throw {@link java.lang.NullPointerException} if null is passed directly or 67 * indirectly -- unless null is explicitly mentioned as a valid parameter. 68 * </blockquote> 69 * NOTE: The exceptions below may be thrown whenever the specified conditions 70 * are met but a guarantee that they are thrown only exists when a valid result |