Package org.eclipse.launchbar.core.target.launch

Interface ILaunchConfigurationTargetedDelegate

All Superinterfaces:

org.eclipse.debug.core.model.ILaunchConfigurationDelegate

All Known Implementing Classes:

LaunchConfigurationTargetedDelegate

public interface ILaunchConfigurationTargetedDelegate
extends org.eclipse.debug.core.model.ILaunchConfigurationDelegate

An ILaunchConfigurationDelegate2 converted to take ILaunchTarget as an additional parameter.

Method Summary

Modifier and Type	Method	Description
boolean	buildForLaunch(org.eclipse.debug.core.ILaunchConfiguration configuration, java.lang.String mode, ILaunchTarget target, org.eclipse.core.runtime.IProgressMonitor monitor)	Optionally performs any required building before launching the given configuration in the specified mode, and returns whether the debug platform should perform an incremental workspace build before the launch continues.
boolean	finalLaunchCheck(org.eclipse.debug.core.ILaunchConfiguration configuration, java.lang.String mode, ILaunchTarget target, org.eclipse.core.runtime.IProgressMonitor monitor)	Returns whether a launch should proceed.
ITargetedLaunch	getLaunch(org.eclipse.debug.core.ILaunchConfiguration configuration, java.lang.String mode, ILaunchTarget target)	Returns a launch object to use when launching the given launch configuration in the given mode, or null if a new default launch object should be created by the debug platform.
boolean	preLaunchCheck(org.eclipse.debug.core.ILaunchConfiguration configuration, java.lang.String mode, ILaunchTarget target, org.eclipse.core.runtime.IProgressMonitor monitor)	Returns whether a launch should proceed.

Methods inherited from interface org.eclipse.debug.core.model.ILaunchConfigurationDelegate

launch, showCommandLine

Method Detail

getLaunch

ITargetedLaunch getLaunch(org.eclipse.debug.core.ILaunchConfiguration configuration,
                          java.lang.String mode,
                          ILaunchTarget target)
                   throws org.eclipse.core.runtime.CoreException

Returns a launch object to use when launching the given launch configuration in the given mode, or null if a new default launch object should be created by the debug platform. If a launch object is returned, its launch mode must match that of the mode specified in this method call.

Parameters:

configuration - the configuration being launched

mode - the mode the configuration is being launched in

Returns:

a launch object or null

Throws:

org.eclipse.core.runtime.CoreException - if unable to launch

buildForLaunch

boolean buildForLaunch(org.eclipse.debug.core.ILaunchConfiguration configuration,
                       java.lang.String mode,
                       ILaunchTarget target,
                       org.eclipse.core.runtime.IProgressMonitor monitor)
                throws org.eclipse.core.runtime.CoreException

Optionally performs any required building before launching the given configuration in the specified mode, and returns whether the debug platform should perform an incremental workspace build before the launch continues. If false is returned the launch will proceed without further building, and if true is returned an incremental build will be performed on the workspace before launching.

This method is only called if the launch is invoked with flag indicating building should take place before the launch. This is done via the method ILaunchConfiguration.launch(String mode, IProgressMonitor monitor, boolean build) .

Parameters:

configuration - the configuration being launched

mode - the mode the configuration is being launched in

monitor - progress monitor, or null. A cancelable progress monitor is provided by the Job framework. It should be noted that the setCanceled(boolean) method should never be called on the provided monitor or the monitor passed to any delegates from this method; due to a limitation in the progress monitor framework using the setCanceled method can cause entire workspace batch jobs to be canceled, as the canceled flag is propagated up the top-level parent monitor. The provided monitor is not guaranteed to have been started.

Returns:

whether the debug platform should perform an incremental workspace build before the launch

Throws:

org.eclipse.core.runtime.CoreException - if an exception occurs while building

finalLaunchCheck

boolean finalLaunchCheck(org.eclipse.debug.core.ILaunchConfiguration configuration,
                         java.lang.String mode,
                         ILaunchTarget target,
                         org.eclipse.core.runtime.IProgressMonitor monitor)
                  throws org.eclipse.core.runtime.CoreException

Returns whether a launch should proceed. This method is called after preLaunchCheck() and buildForLaunch() providing a final chance for this launch delegate to abort a launch if required. For example, a delegate could cancel a launch if it discovered compilation errors that would prevent the launch from succeeding.

Parameters:

configuration - the configuration being launched

mode - launch mode

monitor - progress monitor, or null. A cancelable progress monitor is provided by the Job framework. It should be noted that the setCanceled(boolean) method should never be called on the provided monitor or the monitor passed to any delegates from this method; due to a limitation in the progress monitor framework using the setCanceled method can cause entire workspace batch jobs to be canceled, as the canceled flag is propagated up the top-level parent monitor. The provided monitor is not guaranteed to have been started.

Returns:

whether the launch should proceed

Throws:

org.eclipse.core.runtime.CoreException - if an exception occurs during final checks

preLaunchCheck

boolean preLaunchCheck(org.eclipse.debug.core.ILaunchConfiguration configuration,
                       java.lang.String mode,
                       ILaunchTarget target,
                       org.eclipse.core.runtime.IProgressMonitor monitor)
                throws org.eclipse.core.runtime.CoreException

Returns whether a launch should proceed. This method is called first in the launch sequence providing an opportunity for this launch delegate to abort the launch.

Parameters:

configuration - configuration being launched

mode - launch mode

monitor - progress monitor, or null. A cancelable progress monitor is provided by the Job framework. It should be noted that the setCanceled(boolean) method should never be called on the provided monitor or the monitor passed to any delegates from this method; due to a limitation in the progress monitor framework using the setCanceled method can cause entire workspace batch jobs to be canceled, as the canceled flag is propagated up the top-level parent monitor. The provided monitor is not guaranteed to have been started.

Returns:

whether the launch should proceed

Throws:

org.eclipse.core.runtime.CoreException - if an exception occurs while performing pre-launch checks