1 /******************************************************************************* 2 * Copyright (c) 2000, 2006 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.debug.core; 12 13 14 import org.eclipse.core.runtime.CoreException; 15 16 /** 17 * A method entry breakpoint suspends execution on the first 18 * executable line of a method when entered. Entry breakpoints 19 * can only be installed in methods that have executable code (i.e. 20 * do not work in native methods). 21 * <p> 22 * This breakpoint provides a subset of the function provided by 23 * <code>IJavaMethodBreakpoint</code> - i.e. break on enter. The 24 * implementation of this breakpoint is more efficient than the 25 * general method breakpoint, as the implementation is based on line 26 * breakpoints and does not require method enter/exit tracing in the 27 * target VM. 28 * </p> 29 * <p> 30 * Clients are not intended to implement this interface. 31 * </p> 32 * @since 2.0 33 */ 34 public interface IJavaMethodEntryBreakpoint extends IJavaLineBreakpoint { 35 36 /** 37 * Returns the name of the method this breakpoint suspends 38 * execution in. 39 * 40 * @return the name of the method this breakpoint suspends 41 * execution in 42 * @exception CoreException if unable to access the property from 43 * this breakpoint's underlying marker 44 */ 45 public String getMethodName() throws CoreException; 46 47 /** 48 * Returns the signature of the method this breakpoint suspends 49 * execution in. 50 * 51 * @return the signature of the method this breakpoint suspends 52 * execution in 53 * @exception CoreException if unable to access the property from 54 * this breakpoint's underlying marker 55 */ 56 public String getMethodSignature() throws CoreException; 57 58 } 59 60