edu.buffalo.cse.jive.core
Class JiveDebugModel

java.lang.Object
  edu.buffalo.cse.jive.core.JiveDebugModel

public class JiveDebugModel
extends Object

Provides utility methods for creating debug targets for the JIVE debug model which makes use of the JDI debug model.

Method Summary

static IDebugTarget	newDebugTarget(ILaunch launch, com.sun.jdi.VirtualMachine vm, String name, IProcess process, boolean allowTerminate, boolean allowDisconnect) Creates and returns a debug target for the given VM, with the specified name, and associates the debug target with the given process for console I/O.
static IDebugTarget	newDebugTarget(ILaunch launch, com.sun.jdi.VirtualMachine vm, String name, IProcess process, boolean allowTerminate, boolean allowDisconnect, boolean resume) Creates and returns a debug target for the given VM, with the specified name, and associates the debug target with the given process for console I/O.

Methods inherited from class java.lang.Object

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

Method Detail

newDebugTarget

public static IDebugTarget newDebugTarget(ILaunch launch,
                                          com.sun.jdi.VirtualMachine vm,
                                          String name,
                                          IProcess process,
                                          boolean allowTerminate,
                                          boolean allowDisconnect)

Creates and returns a debug target for the given VM, with the specified name, and associates the debug target with the given process for console I/O. The allow terminate flag specifies whether the debug target will support termination (ITerminate). The allow disconnect flag specifies whether the debug target will support disconnection (IDisconnect). Launching the actual VM is a client responsibility. By default, the target VM will be resumed on startup. The debug target is added to the given launch.

The debug target is monitored by JIVE for JDI events.

Parameters:

launch - the launch the new debug target will be contained in

vm - the VM to create a debug target for

name - the name to associate with the VM, which will be returned from IDebugTarget.getName. If null the name will be retrieved from the underlying VM.

process - the process to associate with the debug target, which will be returned from IDebugTarget.getProcess

allowTerminate - whether the target will support termination

allowDisconnect - whether the target will support disconnection

Returns:

a debug target

See Also:

ITerminate, IDisconnect

newDebugTarget

public static IDebugTarget newDebugTarget(ILaunch launch,
                                          com.sun.jdi.VirtualMachine vm,
                                          String name,
                                          IProcess process,
                                          boolean allowTerminate,
                                          boolean allowDisconnect,
                                          boolean resume)

Creates and returns a debug target for the given VM, with the specified name, and associates the debug target with the given process for console I/O. The allow terminate flag specifies whether the debug target will support termination (ITerminate). The allow disconnect flag specifies whether the debug target will support disconnection (IDisconnect). The resume flag specifies if the target VM should be resumed on startup (has no effect if the VM was already running when the connection to the VM was established). Launching the actual VM is a client responsibility. The debug target is added to the given launch.

The debug target is monitored by JIVE for JDI events.

Parameters:

launch - the launch the new debug target will be contained in

vm - the VM to create a debug target for

name - the name to associate with the VM, which will be returned from IDebugTarget.getName. If null the name will be retrieved from the underlying VM.

process - the process to associate with the debug target, which will be returned from IDebugTarget.getProcess

allowTerminate - whether the target will support termination

allowDisconnect - whether the target will support disconnection

resume - whether the target is to be resumed on startup. Has no effect if the target was already running when the connection to the VM was established.

Returns:

a debug target

See Also:

ITerminate, IDisconnect