|
Eclipse JDT 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.jdt.launching.AbstractJavaLaunchConfigurationDelegate
public abstract class AbstractJavaLaunchConfigurationDelegate
Abstract implementation of a Java launch configuration delegate. Provides convenience methods for accessing and verifying launch configuration attributes.
Clients implementing Java launch configuration delegates should subclass this class.
Field Summary |
---|
Fields inherited from class org.eclipse.debug.core.model.LaunchConfigurationDelegate |
---|
complileErrorProjectPromptStatus, complileErrorPromptStatus, promptStatus, saveScopedDirtyEditors, switchToDebugPromptStatus |
Constructor Summary | |
---|---|
AbstractJavaLaunchConfigurationDelegate()
|
Method Summary | |
---|---|
protected void |
abort(String message,
Throwable exception,
int code)
Throws a core exception with an error status object built from the given message, lower level exception, and error code. |
String[] |
getBootpath(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns entries that should appear on the bootstrap portion of the classpath as specified by the given launch configuration, as an array of resolved strings. |
String[][] |
getBootpathExt(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns three sets of entries which represent the boot classpath specified in the launch configuration, as an array of three arrays of resolved strings. |
protected org.eclipse.debug.core.model.IBreakpoint[] |
getBreakpoints(org.eclipse.debug.core.ILaunchConfiguration configuration)
|
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 the user portion of the classpath as specified by the given launch configuration, as an array of resolved strings. |
protected File |
getDefaultWorkingDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the default working directory for the given launch configuration, or null if none. |
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[] |
getJavaLibraryPath(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns an array of paths to be used for the java.library.path
system property, or null if unspecified. |
IJavaProject |
getJavaProject(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the Java project specified by the given launch configuration, or null if none. |
String |
getJavaProjectName(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the Java project name specified by the given launch configuration, or null if none. |
protected org.eclipse.debug.core.ILaunchManager |
getLaunchManager()
Convenience method to get the launch manager. |
String |
getMainTypeName(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the main type name specified by the given launch configuration, or null if none. |
String |
getProgramArguments(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the program arguments specified by the given launch configuration, as a string. |
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 a string. |
String |
getVMConnectorId(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the VM connector identifier specified by the given launch configuration, or null if none. |
IVMInstall |
getVMInstall(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the VM install specified by the given launch configuration, or null if none. |
String |
getVMInstallName(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the VM install name specified by the given launch configuration, or null if none. |
IVMInstallType |
getVMInstallType(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the VM install type specified by the given launch configuration, or null if none. |
String |
getVMInstallTypeId(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the VM install type identifier specified by the given launch configuration, or null if none. |
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 specified by the given launch configuration, or null if none. |
org.eclipse.core.runtime.IPath |
getWorkingDirectoryPath(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns the working directory path specified by the given launch configuration, or null if none. |
void |
handleDebugEvents(org.eclipse.debug.core.DebugEvent[] events)
Handles the "stop-in-main" option. |
boolean |
isAllowTerminate(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns whether the given launch configuration specifies that termination is allowed. |
protected boolean |
isLaunchProblem(org.eclipse.core.resources.IMarker problemMarker)
|
boolean |
isStopInMain(org.eclipse.debug.core.ILaunchConfiguration configuration)
Returns whether the given launch configuration specifies that execution should suspend on entry of the main method. |
boolean |
preLaunchCheck(org.eclipse.debug.core.ILaunchConfiguration configuration,
String mode,
org.eclipse.core.runtime.IProgressMonitor monitor)
|
protected void |
prepareStopInMain(org.eclipse.debug.core.ILaunchConfiguration configuration)
Determines if the given launch configuration specifies the "stop-in-main" attribute, and sets up an event listener to handle the option if required. |
protected void |
setDefaultSourceLocator(org.eclipse.debug.core.ILaunch launch,
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. |
IJavaProject |
verifyJavaProject(org.eclipse.debug.core.ILaunchConfiguration configuration)
Verifies a Java project is specified by the given launch configuration, and returns the Java project. |
String |
verifyMainTypeName(org.eclipse.debug.core.ILaunchConfiguration configuration)
Verifies a main type name is specified by the given launch configuration, and returns the main type name. |
IVMInstall |
verifyVMInstall(org.eclipse.debug.core.ILaunchConfiguration configuration)
Verifies the VM install specified by the given launch configuration exists and returns the VM install. |
File |
verifyWorkingDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration)
Verifies the working directory specified by the given launch configuration exists, and returns the working directory, or null if none is specified. |
Methods inherited from class org.eclipse.debug.core.model.LaunchConfigurationDelegate |
---|
addReferencedProjects, buildForLaunch, buildProjects, computeBuildOrder, computeReferencedBuildOrder, existsProblems, finalLaunchCheck, getLaunch, saveBeforeLaunch |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface org.eclipse.debug.core.model.ILaunchConfigurationDelegate |
---|
launch |
Constructor Detail |
---|
public AbstractJavaLaunchConfigurationDelegate()
Method Detail |
---|
protected org.eclipse.debug.core.ILaunchManager getLaunchManager()
protected void abort(String message, Throwable exception, int code) throws org.eclipse.core.runtime.CoreException
message
- the status messageexception
- lower level exception associated with the error, or
null
if nonecode
- error code
org.eclipse.core.runtime.CoreException
- the "abort" core exceptionpublic IVMInstall getVMInstall(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic String getVMInstallName(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic IVMInstallType getVMInstallType(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic String getVMInstallTypeId(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic IVMInstall verifyVMInstall(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
configuration
- launch configuration
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attribute, the attribute is
unspecified, or if the home location is unspecified or
does not existpublic String getVMConnectorId(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic String[] getBootpath(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if all
entries are standard (i.e. appear by default), or empty to represent an
empty bootpath.
configuration
- launch configuration
null
represents a default bootpath.
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic String[][] getBootpathExt(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
represents the default
bootclasspath. The third array represents the classpath that should be
appended to the boot classpath.
configuration
- launch configuration
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic String[] getClasspath(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
configuration
- launch configuration
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic IJavaProject getJavaProject(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic String getJavaProjectName(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic String getMainTypeName(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic String getProgramArguments(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
configuration
- launch configuration
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic String getVMArguments(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
configuration
- launch configuration
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic Map getVMSpecificAttributesMap(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
Map
of VM-specific attributes
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic File getWorkingDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic org.eclipse.core.runtime.IPath getWorkingDirectoryPath(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic IJavaProject verifyJavaProject(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
configuration
- launch configuration
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attribute or the attribute is
unspecifiedpublic String verifyMainTypeName(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
configuration
- launch configuration
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attribute or the attribute is
unspecifiedpublic File verifyWorkingDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none is specified.
configuration
- launch configuration
null
if none
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic boolean isAllowTerminate(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
configuration
- launch configuration
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributepublic boolean isStopInMain(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
configuration
- launch configuration
org.eclipse.core.runtime.CoreException
- if unable to retrieve the attributeprotected void setDefaultSourceLocator(org.eclipse.debug.core.ILaunch launch, org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
launch
- launch objectconfiguration
- configuration being launched
org.eclipse.core.runtime.CoreException
- if unable to set the source locatorprotected void prepareStopInMain(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
configuration
- configuration being launched
org.eclipse.core.runtime.CoreException
- if unable to access the attributepublic void handleDebugEvents(org.eclipse.debug.core.DebugEvent[] events)
handleDebugEvents
in interface org.eclipse.debug.core.IDebugEventSetListener
events
- the debug events.IDebugEventSetListener.handleDebugEvents(DebugEvent[])
protected org.eclipse.core.resources.IProject[] getBuildOrder(org.eclipse.debug.core.ILaunchConfiguration configuration, String mode) throws org.eclipse.core.runtime.CoreException
getBuildOrder
in class org.eclipse.debug.core.model.LaunchConfigurationDelegate
org.eclipse.core.runtime.CoreException
protected org.eclipse.core.resources.IProject[] getProjectsForProblemSearch(org.eclipse.debug.core.ILaunchConfiguration configuration, String mode) throws org.eclipse.core.runtime.CoreException
getProjectsForProblemSearch
in class org.eclipse.debug.core.model.LaunchConfigurationDelegate
org.eclipse.core.runtime.CoreException
protected boolean isLaunchProblem(org.eclipse.core.resources.IMarker problemMarker) throws org.eclipse.core.runtime.CoreException
isLaunchProblem
in class org.eclipse.debug.core.model.LaunchConfigurationDelegate
org.eclipse.core.runtime.CoreException
public boolean preLaunchCheck(org.eclipse.debug.core.ILaunchConfiguration configuration, String mode, org.eclipse.core.runtime.IProgressMonitor monitor) throws org.eclipse.core.runtime.CoreException
preLaunchCheck
in interface org.eclipse.debug.core.model.ILaunchConfigurationDelegate2
preLaunchCheck
in class org.eclipse.debug.core.model.LaunchConfigurationDelegate
org.eclipse.core.runtime.CoreException
protected org.eclipse.debug.core.model.IBreakpoint[] getBreakpoints(org.eclipse.debug.core.ILaunchConfiguration configuration)
getBreakpoints
in class org.eclipse.debug.core.model.LaunchConfigurationDelegate
public IVMRunner getVMRunner(org.eclipse.debug.core.ILaunchConfiguration configuration, String mode) throws org.eclipse.core.runtime.CoreException
configuration
- launch configurationmode
- launch node
org.eclipse.core.runtime.CoreException
- if a VM runner cannot be determinedpublic String[] getEnvironment(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if unspecified.
configuration
- launch configuration
org.eclipse.core.runtime.CoreException
- if unable to access associated attribute or if
unable to resolve a variable in an environment variable's valuepublic String[] getJavaLibraryPath(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
java.library.path
system property, or null
if unspecified.
configuration
-
java.library.path
system property, or null
org.eclipse.core.runtime.CoreException
- if unable to determine the attributeprotected File getDefaultWorkingDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.CoreException
null
if none. Subclasses may override as necessary.
configuration
-
null
if none
org.eclipse.core.runtime.CoreException
- if an exception occurs computing the default working
directory
|
Eclipse JDT Release 3.6 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |