KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > eclipse > jdt > debug > core > IJavaTargetPatternBreakpoint


1 /*******************************************************************************
2  * Copyright (c) 2000, 2005 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 line breakpoint installed in types associated with a specific source file
18  * (based on source file name debug attribute) and whose fully
19  * qualified name matches a specified pattern per target.
20  * The {target, type name pattern} pairs are not persisted with this breakpoint, as
21  * targets are transient. Clients that use this type of breakpoint are intended
22  * to be breakpoint listeners that set a pattern per target as each breakpoint
23  * is added to a target.
24  * <p>
25  * This interface is not intended to be implemented.
26  * </p>
27  * @see org.eclipse.jdt.debug.core.IJavaBreakpointListener
28  * @since 2.0
29  */
30 public interface IJavaTargetPatternBreakpoint extends IJavaLineBreakpoint {
31
32     /**
33      * Returns the type name pattern this breakpoint uses to identify types
34      * in which to install itself in the given target
35      *
36      * @param target debug target
37      * @return the type name pattern this breakpoint uses to identify types
38      * in which to install itself in the given target
39      */
40     public String JavaDoc getPattern(IJavaDebugTarget target);
41     
42     /**
43      * Sets the type name pattern this breakpoint uses to identify types
44      * in which to install itself in the given target
45      *
46      * @param target debug target
47      * @param pattern type name pattern
48      * @exception CoreException if changing the pattern for this breakpoint fails
49      */
50     public void setPattern(IJavaDebugTarget target, String JavaDoc pattern) 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 JavaDoc getSourceName() throws CoreException;
63 }
64
65
Popular Tags