Overview Package Class Use Source Tree Index Deprecated About
Prev Class | Next ClassFrames | No Frames
Summary: Nested | Field | Method | ConstrDetail: Nested | Field | Method | Constr

gnu.classpath.jdwp.event

Class EventManager

public class EventManager
extends Object
Manages event requests and filters event notifications. The purpose of this class is actually two-fold: 1) Maintain a list of event requests from the debugger 2) Filter event notifications from the VM If an event request arrives from the debugger, the back-end will call requestEvent(EventRequest), which will first check for a valid event. If it is valid, EventManager will record the request internally and register the event with the virtual machine, which may choose to handle the request itself (as is likely the case with breakpoints and other execution-related events), or it may decide to allow the EventManager to handle notifications and all filtering (which is convenient for other events such as class (un)loading).

Method Summary

void
clearRequests(byte kind)
Clears all the requests for a given event
void
deleteRequest(byte kind, int id)
Deletes the given request from the management table
static EventManager
getDefault()
Returns an instance of the event manager
EventRequest[]
getEventRequests(Event event)
Returns all requests for the given event.
EventRequest
getRequest(byte kind, int id)
Returns a given event request for an event
Collection<E>
getRequests(byte kind)
Returns all requests of the given event kind
void
requestEvent(EventRequest request)
Requests monitoring of an event.

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

clearRequests

public void clearRequests(byte kind)
            throws JdwpException
Clears all the requests for a given event
Parameters:
kind - the event kind
Throws:
IllegalArgumentException - for invalid event kind
JdwpException - for error clearing events

deleteRequest

public void deleteRequest(byte kind,
                          int id)
            throws JdwpException
Deletes the given request from the management table
Parameters:
kind - the event kind
id - the ID of the request to delete
Throws:
IllegalArgumentException - for invalid event kind
JdwpException - for other errors deleting request

getDefault

public static EventManager getDefault()
Returns an instance of the event manager
Returns:
the event manager

getEventRequests

public EventRequest[] getEventRequests(Event event)
Returns all requests for the given event. This method will only be used if the EventManager is handling event filtering.
Parameters:
event - the event
Returns:
requests that are interested in this event or null if none (and event should not be sent)
Throws:
IllegalArgumentException - for invalid event kind

getRequest

public EventRequest getRequest(byte kind,
                               int id)
Returns a given event request for an event
Parameters:
kind - the kind of event for the request
id - the integer request id to return
Returns:
the request for the given event kind with the given id (or null if not found)
Throws:
IllegalArgumentException - for invalid event kind

getRequests

public Collection<E> getRequests(byte kind)
Returns all requests of the given event kind
Parameters:
kind - the event kind
Throws:
IllegalArgumentException - for invalid event kind

requestEvent

public void requestEvent(EventRequest request)
            throws JdwpException
Requests monitoring of an event. The debugger registers for event notification through an event filter. If no event filter is specified for an event in the VM, it is assumed that the debugger is not interested in receiving notifications of this event. The virtual machine will be notified of the request.
Parameters:
request - the request to monitor
Throws:
JdwpException - for other errors involving request
EventManager.java -- event management and notification infrastructure Copyright (C) 2005, 2006, 2007 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.

Overview Package Class Use Source Tree Index Deprecated About