org.eclipse.pde.launching
Class AbstractPDELaunchConfiguration

java.lang.Object
  org.eclipse.debug.core.model.LaunchConfigurationDelegate
      org.eclipse.pde.launching.AbstractPDELaunchConfiguration

All Implemented Interfaces:

org.eclipse.debug.core.model.ILaunchConfigurationDelegate, org.eclipse.debug.core.model.ILaunchConfigurationDelegate2

Direct Known Subclasses:

AbstractPDELaunchConfiguration, EclipseApplicationLaunchConfiguration, EquinoxLaunchConfiguration

public abstract class AbstractPDELaunchConfiguration
extends org.eclipse.debug.core.model.LaunchConfigurationDelegate

An abstract launch delegate for PDE-based launch configurations

Clients may subclass this class.

This class originally existed in 3.2 as org.eclipse.pde.ui.launcher.AbstractPDELaunchConfiguration.

Since:

3.6

Field Summary

protected File

fConfigDir

Fields inherited from class org.eclipse.debug.core.model.LaunchConfigurationDelegate

complileErrorProjectPromptStatus, complileErrorPromptStatus, promptStatus, saveScopedDirtyEditors, switchToDebugPromptStatus

Constructor Summary

AbstractPDELaunchConfiguration()

Method Summary

protected void	clear(org.eclipse.debug.core.ILaunchConfiguration configuration, org.eclipse.core.runtime.IProgressMonitor monitor) By default, this method does nothing.
protected org.eclipse.core.resources.IProject[]	getBuildOrder(org.eclipse.debug.core.ILaunchConfiguration configuration, String mode)
String[]	getClasspath(org.eclipse.debug.core.ILaunchConfiguration configuration) Returns the entries that should appear on boot classpath.
protected File	getConfigDir(org.eclipse.debug.core.ILaunchConfiguration configuration) Returns the configuration area specified by the given launch configuration.
String[]	getEnvironment(org.eclipse.debug.core.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(org.eclipse.debug.core.ILaunchConfiguration configuration) Returns the program arguments to launch with.
protected org.eclipse.core.resources.IProject[]	getProjectsForProblemSearch(org.eclipse.debug.core.ILaunchConfiguration configuration, String mode)
String[]	getVMArguments(org.eclipse.debug.core.ILaunchConfiguration configuration) Returns the VM arguments specified by the given launch configuration, as an array of strings.
IVMRunner	getVMRunner(org.eclipse.debug.core.ILaunchConfiguration configuration, String mode) Returns the VM runner for the given launch mode to use when launching the given configuration.
Map	getVMSpecificAttributesMap(org.eclipse.debug.core.ILaunchConfiguration configuration) Returns the Map of VM-specific attributes specified by the given launch configuration, or null if none.
File	getWorkingDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration) Returns the working directory path specified by the given launch configuration, or null if none.
protected boolean	isLaunchProblem(org.eclipse.core.resources.IMarker problemMarker)
void	launch(org.eclipse.debug.core.ILaunchConfiguration configuration, String mode, org.eclipse.debug.core.ILaunch launch, org.eclipse.core.runtime.IProgressMonitor monitor)
protected void	manageLaunch(org.eclipse.debug.core.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(org.eclipse.debug.core.ILaunchConfiguration configuration, org.eclipse.debug.core.ILaunch launch, org.eclipse.core.runtime.IProgressMonitor monitor) Does sanity checking before launching.
protected void	setDefaultSourceLocator(org.eclipse.debug.core.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(org.eclipse.debug.core.ILaunchConfiguration configuration, org.eclipse.core.runtime.IProgressMonitor monitor) Checks for old-style plugin.xml files that have become stale since the last launch.
protected void	validatePluginDependencies(org.eclipse.debug.core.ILaunchConfiguration configuration, org.eclipse.core.runtime.IProgressMonitor monitor) Validates inter-bundle dependencies automatically prior to launching if that option is turned on.
protected void	validateProjectDependencies(org.eclipse.debug.core.ILaunchConfiguration configuration, org.eclipse.core.runtime.IProgressMonitor monitor) Checks if the Automated Management of Dependencies option is turned on.

Methods inherited from class org.eclipse.debug.core.model.LaunchConfigurationDelegate

addReferencedProjects, buildForLaunch, buildProjects, computeBuildOrder, computeReferencedBuildOrder, existsProblems, finalLaunchCheck, getBreakpoints, getLaunch, preLaunchCheck, saveBeforeLaunch

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

fConfigDir

protected File fConfigDir

Constructor Detail

AbstractPDELaunchConfiguration

public AbstractPDELaunchConfiguration()

Method Detail

isLaunchProblem

protected boolean isLaunchProblem(org.eclipse.core.resources.IMarker problemMarker)
                           throws org.eclipse.core.runtime.CoreException

Overrides:

isLaunchProblem in class org.eclipse.debug.core.model.LaunchConfigurationDelegate

Throws:

org.eclipse.core.runtime.CoreException

launch

public void launch(org.eclipse.debug.core.ILaunchConfiguration configuration,
                   String mode,
                   org.eclipse.debug.core.ILaunch launch,
                   org.eclipse.core.runtime.IProgressMonitor monitor)
            throws org.eclipse.core.runtime.CoreException

Throws:

org.eclipse.core.runtime.CoreException

getVMRunner

public IVMRunner getVMRunner(org.eclipse.debug.core.ILaunchConfiguration configuration,
                             String mode)
                      throws org.eclipse.core.runtime.CoreException

Returns the VM runner for the given launch mode to use when launching the given configuration.

Parameters:

configuration - launch configuration

mode - launch node

Returns:

VM runner to use when launching the given configuration in the given mode

Throws:

org.eclipse.core.runtime.CoreException - if a VM runner cannot be determined

setDefaultSourceLocator

protected void setDefaultSourceLocator(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                throws org.eclipse.core.runtime.CoreException

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.

Parameters:

configuration - configuration being launched

Throws:

org.eclipse.core.runtime.CoreException - if unable to set the source locator

getClasspath

public String[] getClasspath(org.eclipse.debug.core.ILaunchConfiguration configuration)
                      throws org.eclipse.core.runtime.CoreException

Returns the entries that should appear on boot classpath.

Parameters:

configuration - launch configuration

Returns:

the location of startup.jar and the bootstrap classpath specified by the given launch configuration

Throws:

org.eclipse.core.runtime.CoreException - if unable to find startup.jar

getEnvironment

public String[] getEnvironment(org.eclipse.debug.core.ILaunchConfiguration configuration)
                        throws org.eclipse.core.runtime.CoreException

Returns an array of environment variables to be used when launching the given configuration or null if unspecified.

Parameters:

configuration - launch configuration

Throws:

org.eclipse.core.runtime.CoreException - if unable to access associated attribute or if unable to resolve a variable in an environment variable's value

getWorkingDirectory

public File getWorkingDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration)
                         throws org.eclipse.core.runtime.CoreException

Returns the working directory path specified by the given launch configuration, or null if none.

Parameters:

configuration - launch configuration

Returns:

the working directory path specified by the given launch configuration, or null if none

Throws:

org.eclipse.core.runtime.CoreException - if unable to retrieve the attribute

getVMSpecificAttributesMap

public Map getVMSpecificAttributesMap(org.eclipse.debug.core.ILaunchConfiguration configuration)
                               throws org.eclipse.core.runtime.CoreException

Returns the Map of VM-specific attributes specified by the given launch configuration, or null if none.

Parameters:

configuration - launch configuration

Returns:

the Map of VM-specific attributes

Throws:

org.eclipse.core.runtime.CoreException - if unable to retrieve the attribute

getVMArguments

public String[] getVMArguments(org.eclipse.debug.core.ILaunchConfiguration configuration)
                        throws org.eclipse.core.runtime.CoreException

Returns the VM arguments specified by the given launch configuration, as an array of strings.

Parameters:

configuration - launch configuration

Returns:

the VM arguments specified by the given launch configuration, possibly an empty array

Throws:

org.eclipse.core.runtime.CoreException - if unable to retrieve the attribute

getProgramArguments

public String[] getProgramArguments(org.eclipse.debug.core.ILaunchConfiguration configuration)
                             throws org.eclipse.core.runtime.CoreException

Returns the program arguments to launch with. This list is a combination of arguments computed by PDE based on attributes specified in the given launch configuration, followed by the program arguments that the entered directly into the launch configuration.

Parameters:

configuration - launch configuration

Returns:

the program arguments necessary for launching

Throws:

org.eclipse.core.runtime.CoreException - if unable to retrieve the attribute or create the necessary configuration files

preLaunchCheck

protected void preLaunchCheck(org.eclipse.debug.core.ILaunchConfiguration configuration,
                              org.eclipse.debug.core.ILaunch launch,
                              org.eclipse.core.runtime.IProgressMonitor monitor)
                       throws org.eclipse.core.runtime.CoreException

Does sanity checking before launching. The criteria whether the launch should proceed or not is specific to the launch configuration type.

Parameters:

configuration - launch configuration

launch - the launch object to contribute processes and debug targets to

monitor - a progress monitor

Throws:

org.eclipse.core.runtime.CoreException - exception thrown if launch fails or canceled or if unable to retrieve attributes from the launch configuration

getConfigDir

protected File getConfigDir(org.eclipse.debug.core.ILaunchConfiguration configuration)

Returns the configuration area specified by the given launch configuration.

Parameters:

configuration - launch configuration

Returns:

the directory path specified by the given launch configuration

getBuildOrder

protected org.eclipse.core.resources.IProject[] getBuildOrder(org.eclipse.debug.core.ILaunchConfiguration configuration,
                                                              String mode)
                                                       throws org.eclipse.core.runtime.CoreException

Overrides:

getBuildOrder in class org.eclipse.debug.core.model.LaunchConfigurationDelegate

Throws:

org.eclipse.core.runtime.CoreException

getProjectsForProblemSearch

protected org.eclipse.core.resources.IProject[] getProjectsForProblemSearch(org.eclipse.debug.core.ILaunchConfiguration configuration,
                                                                            String mode)
                                                                     throws org.eclipse.core.runtime.CoreException

Overrides:

getProjectsForProblemSearch in class org.eclipse.debug.core.model.LaunchConfigurationDelegate

Throws:

org.eclipse.core.runtime.CoreException

getMainClass

public String getMainClass()

Returns the fully-qualified name of the class to launch.

Returns:

the fully-qualified name of the class to launch. Must not return null.

Since:

3.3

manageLaunch

protected void manageLaunch(org.eclipse.debug.core.ILaunch launch)

Adds a listener to the launch to be notified at interesting launch lifecycle events such as when the launch terminates.

Parameters:

launch - the launch

Since:

3.3

synchronizeManifests

protected void synchronizeManifests(org.eclipse.debug.core.ILaunchConfiguration configuration,
                                    org.eclipse.core.runtime.IProgressMonitor monitor)

Checks for old-style plugin.xml files that have become stale since the last launch. For any stale plugin.xml files found, the corresponding MANIFEST.MF is deleted from the runtime configuration area so that it gets regenerated upon startup.

Parameters:

configuration - the launch configuration

monitor - a progress monitor

Since:

3.3

validateProjectDependencies

protected void validateProjectDependencies(org.eclipse.debug.core.ILaunchConfiguration configuration,
                                           org.eclipse.core.runtime.IProgressMonitor monitor)

Checks if the Automated Management of Dependencies option is turned on. If so, it makes aure all manifests are updated with the correct dependencies.

Parameters:

configuration - the launch configuration

monitor - a progress monitor

Since:

3.3

clear

protected void clear(org.eclipse.debug.core.ILaunchConfiguration configuration,
                     org.eclipse.core.runtime.IProgressMonitor monitor)
              throws org.eclipse.core.runtime.CoreException

By default, this method does nothing. Clients should override, if appropriate.

Parameters:

configuration - the launch configuration

monitor - the progress monitor

Throws:

org.eclipse.core.runtime.CoreException - if unable to retrieve launch attribute values

Since:

3.3

validatePluginDependencies

protected void validatePluginDependencies(org.eclipse.debug.core.ILaunchConfiguration configuration,
                                          org.eclipse.core.runtime.IProgressMonitor monitor)
                                   throws org.eclipse.core.runtime.CoreException

Validates inter-bundle dependencies automatically prior to launching if that option is turned on.

Parameters:

configuration - the launch configuration

monitor - a progress monitor

Throws:

org.eclipse.core.runtime.CoreException

Since:

3.3