KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > netbeans > spi > debugger > jpda > SmartSteppingCallback


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 NetBeans. The Initial Developer of the Original
16  * Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
17  * Microsystems, Inc. All Rights Reserved.
18  */
19
20 package org.netbeans.spi.debugger.jpda;
21
22 import org.netbeans.api.debugger.jpda.JPDAThread;
23 import org.netbeans.api.debugger.jpda.SmartSteppingFilter;
24 import org.netbeans.api.debugger.DebuggerEngine;
25 import org.netbeans.spi.debugger.ContextProvider;
26
27 /**
28  * Listens on stepping engine and defines classes / places the debugger can
29  * stop in.
30  *
31  * @author Jan Jancura
32  */
33 public abstract class SmartSteppingCallback {
34
35
36     /**
37      * Defines default set of smart stepping filters. Method is called when
38      * a new JPDA debugger session is created.
39      *
40      * @param f a filter to be initialized
41      */
42     public abstract void initFilter (SmartSteppingFilter f);
43     
44     /**
45      * This method is called during stepping through debugged application.
46      * The execution is stopped when all registerred <code>SmartSteppingCallback</code>s
47      * returns true.
48      *
49      * @param thread contains all available information about current position
50      * in debugged application
51      * @param f a filter
52      * @return true if execution should be stopped on the current position
53      */
54     public abstract boolean stopHere (ContextProvider lookupProvider, JPDAThread thread, SmartSteppingFilter f);
55 }
56
57
Popular Tags