/core/src/com/bluemarsh/jswat/core/event/DispatcherListener.java

 1/*
 2 * The contents of this file are subject to the terms of the Common Development
 3 * and Distribution License (the License). You may not use this file except in
 4 * compliance with the License.
 5 *
 6 * You can obtain a copy of the License at http://www.netbeans.org/cddl.html
 7 * or http://www.netbeans.org/cddl.txt.
 8 *
 9 * When distributing Covered Code, include this CDDL Header Notice in each file
10 * and include the License file at http://www.netbeans.org/cddl.txt.
11 * If applicable, add the following below the CDDL Header, with the fields
12 * enclosed by brackets [] replaced by your own identifying information:
13 * "Portions Copyrighted [year] [name of copyright owner]"
14 *
15 * The Original Software is JSwat. The Initial Developer of the Original
16 * Software is Nathan L. Fiedler. Portions created by Nathan L. Fiedler
17 * are Copyright (C) 1999-2007. All Rights Reserved.
18 *
19 * Contributor(s): Nathan L. Fiedler.
20 *
21 * $Id: DispatcherListener.java 40 2009-01-09 07:35:28Z nathanfiedler $
22 */
23
24package com.bluemarsh.jswat.core.event;
25
26import com.sun.jdi.event.Event;
27import java.util.EventListener;
28
29/**
30 * Listener interface for events sent from the debugger back-end.
31 *
32 * @author  Nathan Fiedler
33 */
34public interface DispatcherListener extends EventListener {
35
36    /**
37     * Invoked when a debugging event has occurred. This method is called
38     * on the thread that is processing the JDI events, so care should be
39     * taken to perform whatever work is necessary as quickly as possible
40     * (e.g. do not block the thread waiting for user input).
41     *
42     * @param  event  JDI event.
43     * @return  true if debuggee VM should be resumed, false otherwise.
44     */
45    boolean eventOccurred(Event event);
46}