diff options
Diffstat (limited to 'org.eclipse.jdt.debug/model/org/eclipse/jdt/internal/debug/core/IJDIEventListener.java')
-rw-r--r-- | org.eclipse.jdt.debug/model/org/eclipse/jdt/internal/debug/core/IJDIEventListener.java | 60 |
1 files changed, 35 insertions, 25 deletions
diff --git a/org.eclipse.jdt.debug/model/org/eclipse/jdt/internal/debug/core/IJDIEventListener.java b/org.eclipse.jdt.debug/model/org/eclipse/jdt/internal/debug/core/IJDIEventListener.java index 23fe17316..8e3f5b822 100644 --- a/org.eclipse.jdt.debug/model/org/eclipse/jdt/internal/debug/core/IJDIEventListener.java +++ b/org.eclipse.jdt.debug/model/org/eclipse/jdt/internal/debug/core/IJDIEventListener.java @@ -10,16 +10,16 @@ *******************************************************************************/ package org.eclipse.jdt.internal.debug.core; - import org.eclipse.jdt.internal.debug.core.model.JDIDebugTarget; import com.sun.jdi.event.Event; import com.sun.jdi.event.EventSet; +import com.sun.jdi.request.EventRequest; /** - * A jdi event listener is notified of events associated with - * a specific jdi event request. A listener registers/deregisters - * event requests with a debug target. + * A jdi event listener is notified of events associated with a specific jdi + * event request. A listener registers/deregisters event requests with a debug + * target. * * @see JDIDebugTarget#addJDIEventListener(IJDIEventListener, EventRequest) * @see JDIDebugTarget#removeJDIEventListener(IJDIEventListener, EventRequest) @@ -27,36 +27,46 @@ import com.sun.jdi.event.EventSet; public interface IJDIEventListener { /** - * Handles the given event that this listener has registered for and - * returns whether the thread in which the event occurred should - * be resumed. All event handlers for the events in an event set - * are given a chance to vote on whether the thread should be - * resumed. If all agree, the thread is resumed by the event dispatcher. - * If any event handler returns <code>false</code> the thread in which - * the event originated is left in a suspended state. + * Handles the given event that this listener has registered for and returns + * whether the thread in which the event occurred should be resumed. All + * event handlers for the events in an event set are given a chance to vote + * on whether the thread should be resumed. If all agree, the thread is + * resumed by the event dispatcher. If any event handler returns + * <code>false</code> the thread in which the event originated is left in a + * suspended state. * <p> * Event listeners are provided with the current state of the suspend vote. * For example, this could allow a conditional breakpoint to not bother - * running its evaluation since the vote is already to suspend (if it coincides - * with a step end). + * running its evaluation since the vote is already to suspend (if it + * coincides with a step end). * </p> - * @param event the event to handle - * @param target the debug target in which the event occurred - * @param suspendVote whether the current vote among event listeners is to suspend - * @param eventSet the event set the event is contained in + * + * @param event + * the event to handle + * @param target + * the debug target in which the event occurred + * @param suspendVote + * whether the current vote among event listeners is to suspend + * @param eventSet + * the event set the event is contained in * @return whether the thread in which the event occurred should be resumed */ - public boolean handleEvent(Event event, JDIDebugTarget target, boolean suspendVote, EventSet eventSet); - + public boolean handleEvent(Event event, JDIDebugTarget target, + boolean suspendVote, EventSet eventSet); + /** * Notification that all event handlers for an event set have handled their * associated events and whether the event set will suspend. * - * @param event event the listener was registered for/handled - * @param target target in which the event occurred - * @param suspend whether the event will cause the event thread to suspend - * @param eventSet the event set the event is contained in + * @param event + * event the listener was registered for/handled + * @param target + * target in which the event occurred + * @param suspend + * whether the event will cause the event thread to suspend + * @param eventSet + * the event set the event is contained in */ - public void eventSetComplete(Event event, JDIDebugTarget target, boolean suspend, EventSet eventSet); + public void eventSetComplete(Event event, JDIDebugTarget target, + boolean suspend, EventSet eventSet); } - |