http://www.eclipse.org/platform: Debug Core (Eclipse Foundation) 
Copyright (c) 2003, 2005 IBM Corporation and others.
This program and the accompanying materials
are made available under the terms of the Eclipse Public License 2.0
which accompanies this distribution, and is available at
https://www.eclipse.org/legal/epl-2.0/
SPDX-License-Identifier: EPL-2.0
Contributors:
    IBM Corporation - initial API and implementation

/*******************************************************************************
 * Copyright (c) 2003, 2005 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.debug.core.sourcelookup;

import org.eclipse.core.runtime.CoreException;
import org.eclipse.core.runtime.IProgressMonitor;
import org.eclipse.debug.core.ILaunchConfiguration;


A source path computer delegate computes the default source lookup path
(set of source containers that should be considered) for a launch
configuration.


A source path computer is contributed in plug-in XML via the
sourcePathComputers extension point, providing a delegate
to compute the default source lookup path specific to a launch
configuration.




Clients may implement this interface.



See Also:
  • ISourcePathComputer
Since:3.0
/**
 * A source path computer delegate computes the default source lookup path
 * (set of source containers that should be considered) for a launch
 * configuration.
 * <p>
 * A source path computer is contributed in plug-in XML via the
 * <code>sourcePathComputers</code> extension point, providing a delegate
 * to compute the default source lookup path specific to a launch
 * configuration.
 * </p>
 * <p>
 * Clients may implement this interface.
 * </p>
 * @see org.eclipse.debug.core.sourcelookup.ISourcePathComputer
 * @since 3.0
 */
public interface ISourcePathComputerDelegate {

	
Returns a default collection source containers to be considered for the
given launch configuration. The collection returned represents the default
source lookup path for the given configuration.

Params:
  • configuration – the launch configuration for which a default source lookup path
 is to be computed
  • monitor – a progress monitor to be used in case of long operations
Throws:
  • CoreException – if unable to compute a default source lookup path
Returns:a default collection source containers to be considered for the
 given launch configuration
/**
	 * Returns a default collection source containers to be considered for the
	 * given launch configuration. The collection returned represents the default
	 * source lookup path for the given configuration.
	 *
	 * @param configuration the launch configuration for which a default source lookup path
	 *  is to be computed
	 * @param monitor a progress monitor to be used in case of long operations
	 * @return a default collection source containers to be considered for the
	 *  given launch configuration
	 * @exception CoreException if unable to compute a default source lookup path
	 */
	ISourceContainer[] computeSourceContainers(ILaunchConfiguration configuration, IProgressMonitor monitor) throws CoreException;

}