gnu.classpath.jdwp

Class VMVirtualMachine


public class VMVirtualMachine
extends Object

A virtual machine according to JDWP.

Method Summary

static void
clearEvents(byte kind)
Clear all events of the given kind
static MethodResult
executeMethod(Object obj, Thread thread, Class clazz, Method method, Object[] values, boolean nonVirtual)
Executes a method in the virtual machine
static VMMethod[]
getAllClassMethods(Class klass)
Returns all of the methods defined in the given class.
static Iterator
getAllLoadedClasses()
Returns an iterator over all the loaded classes in the VM
static int
getAllLoadedClassesCount()
Returns a count of the number of loaded classes in the VM
static VMMethod
getClassMethod(Class klass, long id)
A factory method for getting valid virtual machine methods which may be passed to/from the debugger.
static int
getClassStatus(Class clazz)
Returns the status of the given class
static VMFrame
getFrame(Thread thread, ByteBuffer bb)
Returns the frame for a given thread with the frame ID in the buffer I don't like this.
static int
getFrameCount(Thread thread)
Returns the number of frames in the thread's stack
static ArrayList
getFrames(Thread thread, int start, int length)
Returns the thread's call stack
static ArrayList
getLoadRequests(ClassLoader cl)
Returns a list of all classes which this class loader has been requested to load
static String
getSourceFile(Class clazz)
"Returns the name of source file in which a reference type was declared"
static int
getSuspendCount(Thread thread)
Get the suspend count for a give thread
static int
getThreadStatus(Thread thread)
Returns the status of a thread
static void
registerEvent(EventRequest request)
Register a request from the debugger Virtual machines have two options.
static void
resumeAllThreads()
Resume all threads.
static void
resumeThread(Thread thread)
Resume a thread.
static void
suspendAllThreads()
Suspend all threads
static void
suspendThread(Thread thread)
Suspend a thread
static void
unregisterEvent(EventRequest request)
Unregisters the given request

Methods inherited from class java.lang.Object

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

Method Details

clearEvents

public static void clearEvents(byte kind)
            throws JdwpException
Clear all events of the given kind
Parameters:
kind - the type of events to clear

executeMethod

public static MethodResult executeMethod(Object obj,
                                         Thread thread,
                                         Class clazz,
                                         Method method,
                                         Object[] values,
                                         boolean nonVirtual)
            throws JdwpException
Executes a method in the virtual machine
Parameters:
obj - instance in which to invoke method (null for static)
thread - the thread in which to invoke the method
clazz - the class in which the method is defined
method - the method to invoke
values - arguments to pass to method
nonVirtual - "otherwise, normal virtual invoke (instance methods only) "
Returns:
a result object containing the results of the invocation

getAllClassMethods

public static VMMethod[] getAllClassMethods(Class klass)
            throws JdwpException
Returns all of the methods defined in the given class. This includes all methods, constructors, and class initializers.
Parameters:
klass - the class whose methods are desired
Returns:
an array of virtual machine methods

getAllLoadedClasses

public static Iterator getAllLoadedClasses()
            throws JdwpException
Returns an iterator over all the loaded classes in the VM

getAllLoadedClassesCount

public static int getAllLoadedClassesCount()
            throws JdwpException
Returns a count of the number of loaded classes in the VM

getClassMethod

public static VMMethod getClassMethod(Class klass,
                                      long id)
            throws JdwpException
A factory method for getting valid virtual machine methods which may be passed to/from the debugger.
Parameters:
klass - the class in which the method is defined
id - the ID of the desired method
Returns:
the desired internal representation of the method
Throws:
JdwpException - for any other error

getClassStatus

public static int getClassStatus(Class clazz)
            throws JdwpException
Returns the status of the given class
Parameters:
clazz - the class whose status is desired
Returns:
a flag containing the class's status

getFrame

public static VMFrame getFrame(Thread thread,
                               ByteBuffer bb)
            throws JdwpException
Returns the frame for a given thread with the frame ID in the buffer I don't like this.
Parameters:
thread - the frame's thread
bb - buffer containing the frame's ID
Returns:
the desired frame

getFrameCount

public static int getFrameCount(Thread thread)
            throws JdwpException
Returns the number of frames in the thread's stack
Parameters:
thread - the thread for which to get a frame count
Returns:
the number of frames in the thread's stack

getFrames

public static ArrayList getFrames(Thread thread,
                                  int start,
                                  int length)
            throws JdwpException
Returns the thread's call stack
Parameters:
thread - thread for which to get call stack
start - index of first frame to return
length - number of frames to return (-1 for all frames)
Returns:
a list of frames

getLoadRequests

public static ArrayList getLoadRequests(ClassLoader cl)
            throws JdwpException
Returns a list of all classes which this class loader has been requested to load
Parameters:
cl - the class loader
Returns:
a list of all visible classes

getSourceFile

public static String getSourceFile(Class clazz)
            throws JdwpException
"Returns the name of source file in which a reference type was declared"
Parameters:
clazz - the class for which to return a source file
Returns:
a string containing the source file name; "no path information for the file is included"

getSuspendCount

public static int getSuspendCount(Thread thread)
            throws JdwpException
Get the suspend count for a give thread
Parameters:
thread - the thread whose suspend count is desired
Returns:
the number of times the thread has been suspended

getThreadStatus

public static int getThreadStatus(Thread thread)
            throws JdwpException
Returns the status of a thread
Parameters:
thread - the thread for which to get status
Returns:
integer status of the thread

registerEvent

public static void registerEvent(EventRequest request)
            throws JdwpException
Register a request from the debugger Virtual machines have two options. Either do nothing and allow the event manager to take care of the request (useful for broadcast-type events like class prepare/load/unload, thread start/end, etc.) or do some internal work to set up the event notification (useful for execution-related events like breakpoints, single-stepping, etc.).

resumeAllThreads

public static void resumeAllThreads()
            throws JdwpException
Resume all threads. This simply decrements the thread's suspend count. It can not be used to force the application to run.

resumeThread

public static void resumeThread(Thread thread)
            throws JdwpException
Resume a thread. A thread must be resumed as many times as it has been suspended.
Parameters:
thread - the thread to resume

suspendAllThreads

public static void suspendAllThreads()
            throws JdwpException
Suspend all threads

suspendThread

public static void suspendThread(Thread thread)
            throws JdwpException
Suspend a thread
Parameters:
thread - the thread to suspend

unregisterEvent

public static void unregisterEvent(EventRequest request)
            throws JdwpException
Unregisters the given request
Parameters:
request - the request to unregister

VMVirtualMachine.java -- A reference implementation of a JDWP virtual machine Copyright (C) 2005, 2006 Free Software Foundation This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.