|
Eclipse JDT Release 3.3 |
|||||||||||
| 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 |
|---|
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(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(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 IBreakpoint[] |
getBreakpoints(ILaunchConfiguration configuration)
|
protected IProject[] |
getBuildOrder(ILaunchConfiguration configuration,
String mode)
|
String[] |
getClasspath(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(ILaunchConfiguration configuration)
Returns the default working directory for the given launch configuration, or null if none. |
String[] |
getEnvironment(ILaunchConfiguration configuration)
Returns an array of environment variables to be used when launching the given configuration or null if unspecified. |
String[] |
getJavaLibraryPath(ILaunchConfiguration configuration)
Returns an array of paths to be used for the java.library.path
system property, or null if unspecified. |
IJavaProject |
getJavaProject(ILaunchConfiguration configuration)
Returns the Java project specified by the given launch configuration, or null if none. |
String |
getJavaProjectName(ILaunchConfiguration configuration)
Returns the Java project name specified by the given launch configuration, or null if none. |
protected ILaunchManager |
getLaunchManager()
Convenience method to get the launch manager. |
String |
getMainTypeName(ILaunchConfiguration configuration)
Returns the main type name specified by the given launch configuration, or null if none. |
String |
getProgramArguments(ILaunchConfiguration configuration)
Returns the program arguments specified by the given launch configuration, as a string. |
protected IProject[] |
getProjectsForProblemSearch(ILaunchConfiguration configuration,
String mode)
|
String |
getVMArguments(ILaunchConfiguration configuration)
Returns the VM arguments specified by the given launch configuration, as a string. |
String |
getVMConnectorId(ILaunchConfiguration configuration)
Returns the VM connector identifier specified by the given launch configuration, or null if none. |
IVMInstall |
getVMInstall(ILaunchConfiguration configuration)
Returns the VM install specified by the given launch configuration, or null if none. |
String |
getVMInstallName(ILaunchConfiguration configuration)
Returns the VM install name specified by the given launch configuration, or null if none. |
IVMInstallType |
getVMInstallType(ILaunchConfiguration configuration)
Returns the VM install type specified by the given launch configuration, or null if none. |
String |
getVMInstallTypeId(ILaunchConfiguration configuration)
Returns the VM install type identifier specified by the given launch configuration, or null if none. |
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 specified by the given launch configuration, or null if none. |
IPath |
getWorkingDirectoryPath(ILaunchConfiguration configuration)
Returns the working directory path specified by the given launch configuration, or null if none. |
void |
handleDebugEvents(DebugEvent[] events)
Handles the "stop-in-main" option. |
boolean |
isAllowTerminate(ILaunchConfiguration configuration)
Returns whether the given launch configuration specifies that termination is allowed. |
protected boolean |
isLaunchProblem(IMarker problemMarker)
|
boolean |
isStopInMain(ILaunchConfiguration configuration)
Returns whether the given launch configuration specifies that execution should suspend on entry of the main method. |
boolean |
preLaunchCheck(ILaunchConfiguration configuration,
String mode,
IProgressMonitor monitor)
|
protected void |
prepareStopInMain(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(ILaunch launch,
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(ILaunchConfiguration configuration)
Verifies a Java project is specified by the given launch configuration, and returns the Java project. |
String |
verifyMainTypeName(ILaunchConfiguration configuration)
Verifies a main type name is specified by the given launch configuration, and returns the main type name. |
IVMInstall |
verifyVMInstall(ILaunchConfiguration configuration)
Verifies the VM install specified by the given launch configuration exists and returns the VM install. |
File |
verifyWorkingDirectory(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 ILaunchManager getLaunchManager()
protected void abort(String message,
Throwable exception,
int code)
throws CoreException
message - the status messageexception - lower level exception associated with the error, or
null if nonecode - error code
CoreException - the "abort" core exception
public IVMInstall getVMInstall(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public String getVMInstallName(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public IVMInstallType getVMInstallType(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public String getVMInstallTypeId(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public IVMInstall verifyVMInstall(ILaunchConfiguration configuration)
throws CoreException
configuration - launch configuration
CoreException - if unable to retrieve the attribute, the attribute is
unspecified, or if the home location is unspecified or
does not exist
public String getVMConnectorId(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public String[] getBootpath(ILaunchConfiguration configuration)
throws 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.
CoreException - if unable to retrieve the attribute
public String[][] getBootpathExt(ILaunchConfiguration configuration)
throws CoreException
null represents the default
bootclasspath. The third array represents the classpath that should be
appended to the boot classpath.
configuration - launch configuration
CoreException - if unable to retrieve the attribute
public String[] getClasspath(ILaunchConfiguration configuration)
throws CoreException
configuration - launch configuration
CoreException - if unable to retrieve the attribute
public IJavaProject getJavaProject(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public String getJavaProjectName(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public String getMainTypeName(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public String getProgramArguments(ILaunchConfiguration configuration)
throws CoreException
configuration - launch configuration
CoreException - if unable to retrieve the attribute
public String getVMArguments(ILaunchConfiguration configuration)
throws CoreException
configuration - launch configuration
CoreException - if unable to retrieve the attribute
public Map getVMSpecificAttributesMap(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
Map of VM-specific attributes
CoreException - if unable to retrieve the attribute
public File getWorkingDirectory(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public IPath getWorkingDirectoryPath(ILaunchConfiguration configuration)
throws CoreException
null if none.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public IJavaProject verifyJavaProject(ILaunchConfiguration configuration)
throws CoreException
configuration - launch configuration
CoreException - if unable to retrieve the attribute or the attribute is
unspecified
public String verifyMainTypeName(ILaunchConfiguration configuration)
throws CoreException
configuration - launch configuration
CoreException - if unable to retrieve the attribute or the attribute is
unspecified
public File verifyWorkingDirectory(ILaunchConfiguration configuration)
throws CoreException
null if none is specified.
configuration - launch configuration
null if none
CoreException - if unable to retrieve the attribute
public boolean isAllowTerminate(ILaunchConfiguration configuration)
throws CoreException
configuration - launch configuration
CoreException - if unable to retrieve the attribute
public boolean isStopInMain(ILaunchConfiguration configuration)
throws CoreException
configuration - launch configuration
CoreException - if unable to retrieve the attribute
protected void setDefaultSourceLocator(ILaunch launch,
ILaunchConfiguration configuration)
throws CoreException
launch - launch objectconfiguration - configuration being launched
CoreException - if unable to set the source locator
protected void prepareStopInMain(ILaunchConfiguration configuration)
throws CoreException
configuration - configuration being launched
CoreException - if unable to access the attributepublic void handleDebugEvents(DebugEvent[] events)
handleDebugEvents in interface IDebugEventSetListenerevents - the debug events.IDebugEventSetListener.handleDebugEvents(DebugEvent[])
protected IProject[] getBuildOrder(ILaunchConfiguration configuration,
String mode)
throws CoreException
CoreException
protected IProject[] getProjectsForProblemSearch(ILaunchConfiguration configuration,
String mode)
throws CoreException
CoreException
protected boolean isLaunchProblem(IMarker problemMarker)
throws CoreException
CoreException
public boolean preLaunchCheck(ILaunchConfiguration configuration,
String mode,
IProgressMonitor monitor)
throws CoreException
preLaunchCheck in interface ILaunchConfigurationDelegate2CoreExceptionprotected IBreakpoint[] getBreakpoints(ILaunchConfiguration configuration)
public IVMRunner getVMRunner(ILaunchConfiguration configuration,
String mode)
throws CoreException
configuration - launch configurationmode - launch node
CoreException - if a VM runner cannot be determined
public 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 value
public String[] getJavaLibraryPath(ILaunchConfiguration configuration)
throws CoreException
java.library.path
system property, or null if unspecified.
configuration -
java.library.path
system property, or null
CoreException - if unable to determine the attribute
protected File getDefaultWorkingDirectory(ILaunchConfiguration configuration)
throws CoreException
null if none. Subclasses may override as necessary.
configuration -
null if none
CoreException - if an exception occurs computing the default working
directory
|
Eclipse JDT Release 3.3 |
|||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||||