KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > eclipse > jdt > internal > debug > core > IJDIEventListener


1 /*******************************************************************************
2  * Copyright (c) 2000, 2005 IBM Corporation and others.
3  * All rights reserved. This program and the accompanying materials
4  * are made available under the terms of the Eclipse Public License v1.0
5  * which accompanies this distribution, and is available at
6  * http://www.eclipse.org/legal/epl-v10.html
7  *
8  * Contributors:
9  * IBM Corporation - initial API and implementation
10  *******************************************************************************/
11 package org.eclipse.jdt.internal.debug.core;
12
13  
14 import org.eclipse.jdt.internal.debug.core.model.JDIDebugTarget;
15
16 import com.sun.jdi.event.Event;
17
18 /**
19  * A jdi event listener is notified of events associated with
20  * a specific jdi event request. A listener registers/deregisters
21  * event requests with a debug target.
22  *
23  * @see JDIDebugTarget#addJDIEventListener(IJDIEventListener, EventRequest)
24  * @see JDIDebugTarget#removeJDIEventListener(IJDIEventListener, EventRequest)
25  */
26
27 public interface IJDIEventListener {
28     /**
29      * Handles the given event that this listener has registered for and
30      * returns whether the thread in which the event occurred should
31      * be resumed. All event handlers for the events in an event set
32      * are given a chance to vote on whether the thread should be
33      * resumed. If all agree, the thread is resumed by the event dispatcher.
34      * If any event handler returns <code>false</code> the thread in which
35      * the event originated is left in a suspended state.
36      *
37      * @param event the event to handle
38      * @param target the debug target in which the event occurred
39      * @return whether the thread in which the event occurred should be resumed
40      */
41     public boolean handleEvent(Event event, JDIDebugTarget target);
42     
43     /**
44      * Notifies this event handler that event that a vote to resume took place,
45      * and that this handler voted to suspend and won that vote.
46      * <p>
47      * This is a fix for bug 78764.
48      * </p>
49      * @param event the event that was handled
50      * @param target the target in which the event occurred
51      * @since 3.1
52      */
53     public void wonSuspendVote(Event event, JDIDebugTarget target);
54 }
55
56
Popular Tags