Class JavaLaunchShortcut
- java.lang.Object
-
- org.eclipse.jdt.debug.ui.launchConfigurations.JavaLaunchShortcut
-
- All Implemented Interfaces:
ILaunchShortcut
,ILaunchShortcut2
- Direct Known Subclasses:
JavaAppletLaunchShortcut
,JavaApplicationLaunchShortcut
public abstract class JavaLaunchShortcut extends Object implements ILaunchShortcut2
Common behavior for Java launch shortcutsThis class may be sub-classed.
- Since:
- 3.3
-
-
Constructor Summary
Constructors Constructor Description JavaLaunchShortcut()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description protected 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
getConfigurationType()
Returns the type of configuration this shortcut is applicable to.protected abstract String
getEditorEmptyMessage()
Returns an error message to use when the editor does not contain a type that can be launched.IResource
getLaunchableResource(ISelection selection)
IResource
getLaunchableResource(IEditorPart editorpart)
ILaunchConfiguration[]
getLaunchConfigurations(ISelection selection)
ILaunchConfiguration[]
getLaunchConfigurations(IEditorPart editorpart)
protected abstract String
getSelectionEmptyMessage()
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
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.protected void
launch(IType type, String mode)
Launches the given type in the specified mode.void
launch(ISelection selection, String mode)
void
launch(IEditorPart editor, String mode)
-
-
-
Method Detail
-
getConfigurationType
protected abstract ILaunchConfigurationType getConfigurationType()
Returns the type of configuration this shortcut is applicable to.- Returns:
- the type of configuration this shortcut is applicable to
-
createConfiguration
protected abstract ILaunchConfiguration createConfiguration(IType type)
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
protected abstract String 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
protected abstract String 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
protected abstract String 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
protected IType chooseType(IType[] types, String title)
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
protected void launch(IType type, String mode)
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
protected ILaunchConfiguration chooseConfiguration(List<ILaunchConfiguration> configList)
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
protected Shell getShell()
Convenience method to return the active workbench window shell.- Returns:
- active workbench window shell
-
launch
public void launch(IEditorPart editor, String mode)
- Specified by:
launch
in interfaceILaunchShortcut
-
launch
public void launch(ISelection selection, String mode)
- Specified by:
launch
in interfaceILaunchShortcut
-
getLaunchableResource
public IResource getLaunchableResource(IEditorPart editorpart)
- Specified by:
getLaunchableResource
in interfaceILaunchShortcut2
-
getLaunchableResource
public IResource getLaunchableResource(ISelection selection)
- Specified by:
getLaunchableResource
in interfaceILaunchShortcut2
-
getLaunchConfigurations
public ILaunchConfiguration[] getLaunchConfigurations(IEditorPart editorpart)
- Specified by:
getLaunchConfigurations
in interfaceILaunchShortcut2
-
getLaunchConfigurations
public ILaunchConfiguration[] getLaunchConfigurations(ISelection selection)
- Specified by:
getLaunchConfigurations
in interfaceILaunchShortcut2
-
-