Class JavaLaunchShortcut
java.lang.Object
org.eclipse.jdt.debug.ui.launchConfigurations.JavaLaunchShortcut
- All Implemented Interfaces:
ILaunchShortcut
,ILaunchShortcut2
- Direct Known Subclasses:
JavaAppletLaunchShortcut
,JavaApplicationLaunchShortcut
Common behavior for Java launch shortcuts
This class may be sub-classed.
- Since:
- 3.3
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected ILaunchConfiguration
chooseConfiguration
(List<ILaunchConfiguration> configList) Returns a configuration from the given collection of configurations that should be launched, ornull
to cancel.protected IType
chooseType
(IType[] types, String title) Prompts the user to select a type from the given types.protected abstract ILaunchConfiguration
createConfiguration
(IType type) Creates and returns a new configuration based on the specified type.protected ILaunchConfiguration
findLaunchConfiguration
(IType type, ILaunchConfigurationType configType) Finds and returns an existing configuration to re-launch for the given type, ornull
if there is no existing configuration.protected abstract IType[]
findTypes
(Object[] elements, IRunnableContext context) Finds and returns the types in the given collection of elements that can be launched.protected abstract ILaunchConfigurationType
Returns the type of configuration this shortcut is applicable to.protected abstract String
Returns an error message to use when the editor does not contain a type that can be launched.getLaunchableResource
(ISelection selection) getLaunchableResource
(IEditorPart editorpart) getLaunchConfigurations
(ISelection selection) getLaunchConfigurations
(IEditorPart editorpart) protected abstract String
Returns an error message to use when the selection does not contain a type that can be launched.protected Shell
getShell()
Convenience method to return the active workbench window shell.protected abstract String
Returns a title for a type selection dialog used to prompt the user when there is more than one type that can be launched.protected void
Launches the given type in the specified mode.void
launch
(ISelection selection, String mode) void
launch
(IEditorPart editor, String mode)
-
Constructor Details
-
JavaLaunchShortcut
public JavaLaunchShortcut()
-
-
Method Details
-
getConfigurationType
Returns the type of configuration this shortcut is applicable to.- Returns:
- the type of configuration this shortcut is applicable to
-
createConfiguration
Creates and returns a new configuration based on the specified type.- Parameters:
type
- type to create a launch configuration for- Returns:
- launch configuration configured to launch the specified type
-
findTypes
protected abstract IType[] findTypes(Object[] elements, IRunnableContext context) throws InterruptedException, CoreException Finds and returns the types in the given collection of elements that can be launched.- Parameters:
elements
- scope to search for types that can be launchedcontext
- progress reporting context- Returns:
- collection of types that can be launched, possibly empty
- Throws:
InterruptedException
- if the search is canceledCoreException
- if the search fails
-
getTypeSelectionTitle
Returns a title for a type selection dialog used to prompt the user when there is more than one type that can be launched.- Returns:
- type selection dialog title
-
getEditorEmptyMessage
Returns an error message to use when the editor does not contain a type that can be launched.- Returns:
- error message when editor cannot be launched
-
getSelectionEmptyMessage
Returns an error message to use when the selection does not contain a type that can be launched.- Returns:
- error message when selection cannot be launched
-
chooseType
Prompts the user to select a type from the given types.- Parameters:
types
- the types to choose fromtitle
- the selection dialog title- Returns:
- the selected type or
null
if none.
-
launch
Launches the given type in the specified mode.- Parameters:
type
- type to launchmode
- launch mode- Since:
- 3.5
-
findLaunchConfiguration
protected ILaunchConfiguration findLaunchConfiguration(IType type, ILaunchConfigurationType configType) Finds and returns an existing configuration to re-launch for the given type, ornull
if there is no existing configuration.- Parameters:
type
- theIType
to try and find theILaunchConfiguration
forconfigType
- theILaunchConfigurationType
to try and narrow down the search- Returns:
- a configuration to use for launching the given type or
null
if none
-
chooseConfiguration
Returns a configuration from the given collection of configurations that should be launched, ornull
to cancel. Default implementation opens a selection dialog that allows the user to choose one of the specified launch configurations. Returns the chosen configuration, ornull
if the user cancels.- Parameters:
configList
- list of configurations to choose from- Returns:
- configuration to launch or
null
to cancel
-
getShell
Convenience method to return the active workbench window shell.- Returns:
- active workbench window shell
-
launch
- Specified by:
launch
in interfaceILaunchShortcut
-
launch
- Specified by:
launch
in interfaceILaunchShortcut
-
getLaunchableResource
- Specified by:
getLaunchableResource
in interfaceILaunchShortcut2
-
getLaunchableResource
- Specified by:
getLaunchableResource
in interfaceILaunchShortcut2
-
getLaunchConfigurations
- Specified by:
getLaunchConfigurations
in interfaceILaunchShortcut2
-
getLaunchConfigurations
- Specified by:
getLaunchConfigurations
in interfaceILaunchShortcut2
-