| org.eclipse.pde.ui.launcher.AbstractPDELaunchConfiguration
All known Subclasses: org.eclipse.pde.ui.launcher.EclipseApplicationLaunchConfiguration, org.eclipse.pde.ui.launcher.EquinoxLaunchConfiguration,
| AbstractPDELaunchConfiguration | | abstract public class AbstractPDELaunchConfiguration extends LaunchConfigurationDelegate (Code) | | An abstract launch delegate for PDE-based launch configurations
Clients may subclass this class.
since:
3.2 |
| Method Summary | |
| protected void | clear(ILaunchConfiguration configuration, IProgressMonitor monitor)
By default, this method does nothing. | | protected IProject[] | getBuildOrder(ILaunchConfiguration configuration, String mode)
| | public 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. | | public String[] | getEnvironment(ILaunchConfiguration configuration)
Returns an array of environment variables to be used when
launching the given configuration or null if unspecified. | | public String | getMainClass()
Returns the fully-qualified name of the class to launch. | | public String[] | getProgramArguments(ILaunchConfiguration configuration)
Returns the program arguments to launch with. | | protected IProject[] | getProjectsForProblemSearch(ILaunchConfiguration configuration, String mode)
| | public String[] | getVMArguments(ILaunchConfiguration configuration)
Returns the VM arguments specified by the given launch configuration, as
an array of strings. | | public IVMRunner | getVMRunner(ILaunchConfiguration configuration, String mode)
Returns the VM runner for the given launch mode to use when launching the
given configuration. | | public Map | getVMSpecificAttributesMap(ILaunchConfiguration configuration)
Returns the Map of VM-specific attributes specified by the given launch
configuration, or null if none. | | public File | getWorkingDirectory(ILaunchConfiguration configuration)
Returns the working directory path specified by the given launch
configuration, or null if none. | | public 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. |
| clear | | protected void clear(ILaunchConfiguration configuration, IProgressMonitor monitor) throws CoreException(Code) | | By default, this method does nothing. Clients should override, if appropriate.
Parameters:
configuration - the launch configuration
Parameters:
monitor - the progress monitor
throws:
CoreException - if unable to retrieve launch attribute values
since:
3.3 |
| getBuildOrder | | protected IProject[] getBuildOrder(ILaunchConfiguration configuration, String mode) throws CoreException(Code) | | |
| getClasspath | | public String[] getClasspath(ILaunchConfiguration configuration) throws CoreException(Code) | | Returns the entries that should appear on boot classpath.
Parameters:
configuration - launch configuration the location of startup.jar and the bootstrap classpath specified by the given launch configuration
exception:
CoreException - if unable to find startup.jar |
| getConfigDir | | protected File getConfigDir(ILaunchConfiguration configuration)(Code) | | Returns the configuration area specified by the given launch
configuration.
Parameters:
configuration - launch configuration the directory path specified by the given launchconfiguration |
| getEnvironment | | public String[] getEnvironment(ILaunchConfiguration configuration) throws CoreException(Code) | | Returns an array of environment variables to be used when
launching the given configuration or null if unspecified.
Parameters:
configuration - launch configuration
throws:
CoreException - if unable to access associated attribute or ifunable to resolve a variable in an environment variable's value |
| getMainClass | | public String getMainClass()(Code) | | Returns the fully-qualified name of the class to launch.
the fully-qualified name of the class to launch. Must not return null.
since:
3.3 |
| getProgramArguments | | public String[] getProgramArguments(ILaunchConfiguration configuration) throws CoreException(Code) | | 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 the program arguments necessary for launching
exception:
CoreException - if unable to retrieve the attribute or create thenecessary configuration files |
| getProjectsForProblemSearch | | protected IProject[] getProjectsForProblemSearch(ILaunchConfiguration configuration, String mode) throws CoreException(Code) | | |
| getVMArguments | | public String[] getVMArguments(ILaunchConfiguration configuration) throws CoreException(Code) | | Returns the VM arguments specified by the given launch configuration, as
an array of strings.
Parameters:
configuration - launch configuration the VM arguments specified by the given launch configuration,possibly an empty array
exception:
CoreException - if unable to retrieve the attribute |
| getVMRunner | | public IVMRunner getVMRunner(ILaunchConfiguration configuration, String mode) throws CoreException(Code) | | Returns the VM runner for the given launch mode to use when launching the
given configuration.
Parameters:
configuration - launch configuration
Parameters:
mode - launch node VM runner to use when launching the given configuration in the given mode
throws:
CoreException - if a VM runner cannot be determined |
| getVMSpecificAttributesMap | | public Map getVMSpecificAttributesMap(ILaunchConfiguration configuration) throws CoreException(Code) | | Returns the Map of VM-specific attributes specified by the given launch
configuration, or null if none.
Parameters:
configuration - launch configuration the Map of VM-specific attributes
exception:
CoreException - if unable to retrieve the attribute |
| getWorkingDirectory | | public File getWorkingDirectory(ILaunchConfiguration configuration) throws CoreException(Code) | | Returns the working directory path specified by the given launch
configuration, or null if none.
Parameters:
configuration - launch configuration the working directory path specified by the given launchconfiguration, or null if none
exception:
CoreException - if unable to retrieve the attribute |
| launch | | public void launch(ILaunchConfiguration configuration, String mode, ILaunch launch, IProgressMonitor monitor) throws CoreException(Code) | | |
| manageLaunch | | protected void manageLaunch(ILaunch launch)(Code) | | 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 |
| preLaunchCheck | | protected void preLaunchCheck(ILaunchConfiguration configuration, ILaunch launch, IProgressMonitor monitor) throws CoreException(Code) | | 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
Parameters:
launch - the launch object to contribute processes and debug targets to
Parameters:
monitor - a progress monitor
throws:
CoreException - exception thrown if launch fails or canceled or if unable to retrieve attributesfrom the launch configuration |
| setDefaultSourceLocator | | protected void setDefaultSourceLocator(ILaunchConfiguration configuration) throws CoreException(Code) | | 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
exception:
CoreException - if unable to set the source locator |
| synchronizeManifests | | protected void synchronizeManifests(ILaunchConfiguration configuration, IProgressMonitor monitor)(Code) | | 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
Parameters:
monitor - a progress monitor
since:
3.3 |
| validatePluginDependencies | | protected void validatePluginDependencies(ILaunchConfiguration configuration, IProgressMonitor monitor) throws CoreException(Code) | | Validates inter-bundle dependencies automatically prior to launching
if that option is turned on.
Parameters:
configuration - the launch configuration
Parameters:
monitor - a progress monitor
since:
3.3 |
| validateProjectDependencies | | protected void validateProjectDependencies(ILaunchConfiguration configuration, IProgressMonitor monitor)(Code) | | 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
Parameters:
monitor - a progress monitor
since:
3.3 |
|
|