/*******************************************************************************
 * Copyright (c) 2000, 2005 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 * 
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.jdt.debug.core;


import org.eclipse.core.runtime.CoreException;

/**
 * A line breakpoint installed in types associated with a specific source file
 * (based on source file name debug attribute) and whose fully
 * qualified name matches a specified pattern per target.
 * The {target, type name pattern} pairs are not persisted with this breakpoint, as 
 * targets are transient. Clients that use this type of breakpoint are intended
 * to be breakpoint listeners that set a pattern per target as each breakpoint
 * is added to a target.
 * <p>
 * This interface is not intended to be implemented.
 * </p>
 * @see org.eclipse.jdt.debug.core.IJavaBreakpointListener
 * @since 2.0
 */
public interface IJavaTargetPatternBreakpoint extends IJavaLineBreakpoint {

	/**
	 * Returns the type name pattern this breakpoint uses to identify types
	 * in which to install itself in the given target
	 * 
	 * @param target debug target
	 * @return the type name pattern this breakpoint uses to identify types
	 *  in which to install itself in the given target
	 */
	public String getPattern(IJavaDebugTarget target);
	
	/** 
	 * Sets the type name pattern this breakpoint uses to identify types
	 * in which to install itself in the given target
	 * 
	 * @param target debug target
	 * @param pattern type name pattern
	 * @exception CoreException if changing the pattern for this breakpoint fails
	 */
	public void setPattern(IJavaDebugTarget target, String pattern) throws CoreException;

	/**
	 * Returns the source file name in which this breakpoint is set.
	 * When this breakpoint specifies a source file name, this breakpoint is
	 * only installed in types whose source file name debug attribute
	 * match this value.
	 * 
	 * @return the source file name in which this breakpoint is set
	 * @exception CoreException if unable to access the property from
	 *  this breakpoint's underlying marker
	 */
	public String getSourceName() throws CoreException;	
}