|
Eclipse JDT Release 3.0 |
||||||||||
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
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 |
complileErrorPromptStatus, promptStatus, 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.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. |
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. |
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 |
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 boothpath.
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
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
org.eclipse.core.runtime.CoreException
protected boolean isLaunchProblem(org.eclipse.core.resources.IMarker problemMarker) throws org.eclipse.core.runtime.CoreException
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
org.eclipse.core.runtime.CoreException
|
Eclipse JDT Release 3.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |