JIVE Platform
Release 0.3.1

edu.buffalo.cse.jive.core
Class JiveDebugModel

java.lang.Object
  extended by 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

JIVE Platform
Release 0.3.1