|
Eclipse Platform Release 3.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Optional enhancements to the launch configuration delegate interface. Allows launch delegates to abort a launch, build relevant projects in the workspace before a launch, and create the launch object to be used in a launch.
Clients implementing ILaunchConfigurationDelegate
may also
implement this interface.
Method Summary | |
boolean |
buildForLaunch(ILaunchConfiguration configuration,
String mode,
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(ILaunchConfiguration configuration,
String mode,
IProgressMonitor monitor)
Returns whether a launch should proceed. |
ILaunch |
getLaunch(ILaunchConfiguration configuration,
String mode)
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(ILaunchConfiguration configuration,
String mode,
IProgressMonitor monitor)
Returns whether a launch should proceed. |
Methods inherited from interface org.eclipse.debug.core.model.ILaunchConfigurationDelegate |
launch |
Method Detail |
public ILaunch getLaunch(ILaunchConfiguration configuration, String mode) throws CoreException
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.
configuration
- the configuration being launchedmode
- the mode the configuration is being launched in
null
CoreException
- if unable to launchpublic boolean buildForLaunch(ILaunchConfiguration configuration, String mode, IProgressMonitor monitor) throws CoreException
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)
.
configuration
- the configuration being launchedmode
- the mode the configuration is being launched inmonitor
- progress monitor
CoreException
- if an exception occurrs while buildingpublic boolean finalLaunchCheck(ILaunchConfiguration configuration, String mode, IProgressMonitor monitor) throws CoreException
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.
configuration
- the configuration being launchedmode
- launch modemonitor
- progress monitor
CoreException
- if an exception occurs during final checkspublic boolean preLaunchCheck(ILaunchConfiguration configuration, String mode, IProgressMonitor monitor) throws CoreException
configuration
- configuration being lanuchedmode
- launch modemonitor
- progress monitor
CoreException
- if an exception occurs while performing pre launch checks
|
Eclipse Platform Release 3.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) IBM Corp. and others 2000, 2004. All rights reserved.