01: /*******************************************************************************
02: * Copyright (c) 2000, 2005 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 line breakpoint installed in types associated with a specific source file
16: * (based on source file name debug attribute) and whose fully
17: * qualified name matches a specified pattern per target.
18: * The {target, type name pattern} pairs are not persisted with this breakpoint, as
19: * targets are transient. Clients that use this type of breakpoint are intended
20: * to be breakpoint listeners that set a pattern per target as each breakpoint
21: * is added to a target.
22: * <p>
23: * This interface is not intended to be implemented.
24: * </p>
25: * @see org.eclipse.jdt.debug.core.IJavaBreakpointListener
26: * @since 2.0
27: */
28: public interface IJavaTargetPatternBreakpoint extends
29: IJavaLineBreakpoint {
30:
31: /**
32: * Returns the type name pattern this breakpoint uses to identify types
33: * in which to install itself in the given target
34: *
35: * @param target debug target
36: * @return the type name pattern this breakpoint uses to identify types
37: * in which to install itself in the given target
38: */
39: public String getPattern(IJavaDebugTarget target);
40:
41: /**
42: * Sets the type name pattern this breakpoint uses to identify types
43: * in which to install itself in the given target
44: *
45: * @param target debug target
46: * @param pattern type name pattern
47: * @exception CoreException if changing the pattern for this breakpoint fails
48: */
49: public void setPattern(IJavaDebugTarget target, String pattern)
50: throws CoreException;
51:
52: /**
53: * Returns the source file name in which this breakpoint is set.
54: * When this breakpoint specifies a source file name, this breakpoint is
55: * only installed in types whose source file name debug attribute
56: * match this value.
57: *
58: * @return the source file name in which this breakpoint is set
59: * @exception CoreException if unable to access the property from
60: * this breakpoint's underlying marker
61: */
62: public String getSourceName() throws CoreException;
63: }
|