01: /*******************************************************************************
02: * Copyright (c) 2000, 2006 IBM Corporation and others.
03: * All rights reserved. This program and the accompanying materials
04: * are made available under the terms of the Eclipse Public License v1.0
05: * which accompanies this distribution, and is available at
06: * http://www.eclipse.org/legal/epl-v10.html
07: *
08: * Contributors:
09: * IBM Corporation - initial API and implementation
10: *******************************************************************************/package org.eclipse.jdt.debug.core;
11:
12: import org.eclipse.core.runtime.CoreException;
13:
14: /**
15: * A method entry breakpoint suspends execution on the first
16: * executable line of a method when entered. Entry breakpoints
17: * can only be installed in methods that have executable code (i.e.
18: * do not work in native methods).
19: * <p>
20: * This breakpoint provides a subset of the function provided by
21: * <code>IJavaMethodBreakpoint</code> - i.e. break on enter. The
22: * implementation of this breakpoint is more efficient than the
23: * general method breakpoint, as the implementation is based on line
24: * breakpoints and does not require method enter/exit tracing in the
25: * target VM.
26: * </p>
27: * <p>
28: * Clients are not intended to implement this interface.
29: * </p>
30: * @since 2.0
31: */
32: public interface IJavaMethodEntryBreakpoint extends IJavaLineBreakpoint {
33:
34: /**
35: * Returns the name of the method this breakpoint suspends
36: * execution in.
37: *
38: * @return the name of the method this breakpoint suspends
39: * execution in
40: * @exception CoreException if unable to access the property from
41: * this breakpoint's underlying marker
42: */
43: public String getMethodName() throws CoreException;
44:
45: /**
46: * Returns the signature of the method this breakpoint suspends
47: * execution in.
48: *
49: * @return the signature of the method this breakpoint suspends
50: * execution in
51: * @exception CoreException if unable to access the property from
52: * this breakpoint's underlying marker
53: */
54: public String getMethodSignature() throws CoreException;
55:
56: }
|