|
Eclipse PDE Release 3.6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.eclipse.debug.core.model.LaunchConfigurationDelegate
org.eclipse.pde.launching.AbstractPDELaunchConfiguration
public abstract class AbstractPDELaunchConfiguration
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
.
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(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 |
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. |
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 |
---|
protected File fConfigDir
Constructor Detail |
---|
public AbstractPDELaunchConfiguration()
Method Detail |
---|
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 node
CoreException
- if a VM runner cannot be determinedprotected void setDefaultSourceLocator(ILaunchConfiguration configuration) throws CoreException
configuration
- configuration being launched
CoreException
- if unable to set the source locatorpublic String[] getClasspath(ILaunchConfiguration configuration) throws CoreException
configuration
- launch configuration
CoreException
- if unable to find startup.jarpublic String[] getEnvironment(ILaunchConfiguration configuration) throws CoreException
null
if unspecified.
configuration
- launch configuration
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 configuration
null
if none
CoreException
- if unable to retrieve the attributepublic Map getVMSpecificAttributesMap(ILaunchConfiguration configuration) throws CoreException
null
if none.
configuration
- launch configuration
Map
of VM-specific attributes
CoreException
- if unable to retrieve the attributepublic String[] getVMArguments(ILaunchConfiguration configuration) throws CoreException
configuration
- launch configuration
CoreException
- if unable to retrieve the attributepublic String[] getProgramArguments(ILaunchConfiguration configuration) throws CoreException
configuration
- launch configuration
CoreException
- 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 monitor
CoreException
- exception thrown if launch fails or canceled or if unable to retrieve attributes
from the launch configurationprotected File getConfigDir(ILaunchConfiguration configuration)
configuration
- launch configuration
protected 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 monitor
CoreException
- if unable to retrieve launch attribute valuesprotected void validatePluginDependencies(ILaunchConfiguration configuration, IProgressMonitor monitor) throws CoreException
configuration
- the launch configurationmonitor
- a progress monitor
CoreException
|
Eclipse PDE Release 3.6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) 2000, 2010 IBM Corporation and others. All rights reserved.