public abstract class AbstractPDELaunchConfiguration extends LaunchConfigurationDelegate
Clients may subclass this class.
This class originally existed in 3.2 as
org.eclipse.pde.ui.launcher.AbstractPDELaunchConfiguration
.
Modifier and Type | Field and Description |
---|---|
protected File |
fConfigDir |
complileErrorProjectPromptStatus, complileErrorPromptStatus, promptStatus, saveScopedDirtyEditors, switchToDebugPromptStatus
Constructor and Description |
---|
AbstractPDELaunchConfiguration() |
Modifier and Type | Method and Description |
---|---|
protected void |
clear(ILaunchConfiguration configuration,
IProgressMonitor monitor)
By default, this method does nothing.
|
protected IProject[] |
getBuildOrder(ILaunchConfiguration configuration,
String mode) |
String[] |
getClasspath(ILaunchConfiguration configuration)
Returns the entries that should appear on boot classpath.
|
protected File |
getConfigDir(ILaunchConfiguration configuration)
Returns the configuration area specified by the given launch
configuration.
|
String[] |
getEnvironment(ILaunchConfiguration configuration)
Returns an array of environment variables to be used when
launching the given configuration or
null if unspecified. |
String |
getMainClass()
Returns the fully-qualified name of the class to launch.
|
String[] |
getProgramArguments(ILaunchConfiguration configuration)
Returns the program arguments to launch with.
|
protected IProject[] |
getProjectsForProblemSearch(ILaunchConfiguration configuration,
String mode) |
String[] |
getVMArguments(ILaunchConfiguration configuration)
Returns the VM arguments specified by the given launch configuration, as
an array of strings.
|
IVMRunner |
getVMRunner(ILaunchConfiguration configuration,
String mode)
Returns the VM runner for the given launch mode to use when launching the
given configuration.
|
Map<String,Object> |
getVMSpecificAttributesMap(ILaunchConfiguration configuration)
Returns the Map of VM-specific attributes specified by the given launch
configuration, or
null if none. |
File |
getWorkingDirectory(ILaunchConfiguration configuration)
Returns the working directory path specified by the given launch
configuration, or
null if none. |
protected boolean |
isLaunchProblem(IMarker problemMarker) |
void |
launch(ILaunchConfiguration configuration,
String mode,
ILaunch launch,
IProgressMonitor monitor) |
protected void |
manageLaunch(ILaunch launch)
Adds a listener to the launch to be notified at interesting launch lifecycle
events such as when the launch terminates.
|
protected void |
preLaunchCheck(ILaunchConfiguration configuration,
ILaunch launch,
IProgressMonitor monitor)
Does sanity checking before launching.
|
protected void |
setDefaultSourceLocator(ILaunchConfiguration configuration)
Assigns a default source locator to the given launch if a source locator
has not yet been assigned to it, and the associated launch configuration
does not specify a source locator.
|
protected void |
synchronizeManifests(ILaunchConfiguration configuration,
IProgressMonitor monitor)
Checks for old-style plugin.xml files that have become stale since the last launch.
|
protected void |
validatePluginDependencies(ILaunchConfiguration configuration,
IProgressMonitor monitor)
Validates inter-bundle dependencies automatically prior to launching
if that option is turned on.
|
protected void |
validateProjectDependencies(ILaunchConfiguration configuration,
IProgressMonitor monitor)
Checks if the Automated Management of Dependencies option is turned on.
|
addReferencedProjects, buildForLaunch, buildProjects, computeBuildOrder, computeReferencedBuildOrder, existsProblems, finalLaunchCheck, getBreakpoints, getLaunch, preLaunchCheck, saveBeforeLaunch
protected File fConfigDir
protected boolean isLaunchProblem(IMarker problemMarker) throws CoreException
isLaunchProblem
in class LaunchConfigurationDelegate
CoreException
public void launch(ILaunchConfiguration configuration, String mode, ILaunch launch, IProgressMonitor monitor) throws CoreException
CoreException
public IVMRunner getVMRunner(ILaunchConfiguration configuration, String mode) throws CoreException
configuration
- launch configurationmode
- launch nodeCoreException
- if a VM runner cannot be determinedprotected void setDefaultSourceLocator(ILaunchConfiguration configuration) throws CoreException
configuration
- configuration being launchedCoreException
- if unable to set the source locatorpublic String[] getClasspath(ILaunchConfiguration configuration) throws CoreException
configuration
- launch configurationCoreException
- if unable to find startup.jarpublic String[] getEnvironment(ILaunchConfiguration configuration) throws CoreException
null
if unspecified.configuration
- launch configurationnull
CoreException
- if unable to access associated attribute or if
unable to resolve a variable in an environment variable's valuepublic File getWorkingDirectory(ILaunchConfiguration configuration) throws CoreException
null
if none.configuration
- launch configurationnull
if noneCoreException
- if unable to retrieve the attributepublic Map<String,Object> getVMSpecificAttributesMap(ILaunchConfiguration configuration) throws CoreException
null
if none.configuration
- launch configurationMap
of VM-specific attributesCoreException
- if unable to retrieve the attributepublic String[] getVMArguments(ILaunchConfiguration configuration) throws CoreException
configuration
- launch configurationCoreException
- if unable to retrieve the attributepublic String[] getProgramArguments(ILaunchConfiguration configuration) throws CoreException
configuration
- launch configurationCoreException
- if unable to retrieve the attribute or create the
necessary configuration filesprotected void preLaunchCheck(ILaunchConfiguration configuration, ILaunch launch, IProgressMonitor monitor) throws CoreException
configuration
- launch configurationlaunch
- the launch object to contribute processes and debug targets tomonitor
- a progress monitorCoreException
- exception thrown if launch fails or canceled or if unable to retrieve attributes
from the launch configurationprotected File getConfigDir(ILaunchConfiguration configuration)
configuration
- launch configurationprotected IProject[] getBuildOrder(ILaunchConfiguration configuration, String mode) throws CoreException
getBuildOrder
in class LaunchConfigurationDelegate
CoreException
protected IProject[] getProjectsForProblemSearch(ILaunchConfiguration configuration, String mode) throws CoreException
getProjectsForProblemSearch
in class LaunchConfigurationDelegate
CoreException
public String getMainClass()
null
.protected void manageLaunch(ILaunch launch)
launch
- the launchprotected void synchronizeManifests(ILaunchConfiguration configuration, IProgressMonitor monitor)
configuration
- the launch configurationmonitor
- a progress monitorprotected void validateProjectDependencies(ILaunchConfiguration configuration, IProgressMonitor monitor)
configuration
- the launch configurationmonitor
- a progress monitorprotected void clear(ILaunchConfiguration configuration, IProgressMonitor monitor) throws CoreException
configuration
- the launch configurationmonitor
- the progress monitorCoreException
- if unable to retrieve launch attribute values or the clear operation was cancelledprotected void validatePluginDependencies(ILaunchConfiguration configuration, IProgressMonitor monitor) throws CoreException
configuration
- the launch configurationmonitor
- a progress monitorCoreException
Copyright (c) 2000, 2015 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.