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 ILaunchConfigurationchooseConfiguration(List<ILaunchConfiguration> configList)Returns a configuration from the given collection of configurations that should be launched, ornullto cancel.protected ITypechooseType(IType[] types, String title)Prompts the user to select a type from the given types.protected abstract ILaunchConfigurationcreateConfiguration(IType type)Creates and returns a new configuration based on the specified type.protected ILaunchConfigurationfindLaunchConfiguration(IType type, ILaunchConfigurationType configType)Finds and returns an existing configuration to re-launch for the given type, ornullif 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 ILaunchConfigurationTypegetConfigurationType()Returns the type of configuration this shortcut is applicable to.protected abstract StringgetEditorEmptyMessage()Returns an error message to use when the editor does not contain a type that can be launched.IResourcegetLaunchableResource(ISelection selection)IResourcegetLaunchableResource(IEditorPart editorpart)ILaunchConfiguration[]getLaunchConfigurations(ISelection selection)ILaunchConfiguration[]getLaunchConfigurations(IEditorPart editorpart)protected abstract StringgetSelectionEmptyMessage()Returns an error message to use when the selection does not contain a type that can be launched.protected ShellgetShell()Convenience method to return the active workbench window shell.protected abstract StringgetTypeSelectionTitle()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 voidlaunch(IType type, String mode)Launches the given type in the specified mode.voidlaunch(ISelection selection, String mode)voidlaunch(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
nullif 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, ornullif there is no existing configuration.- Parameters:
type- theITypeto try and find theILaunchConfigurationforconfigType- theILaunchConfigurationTypeto try and narrow down the search- Returns:
- a configuration to use for launching the given type or
nullif none
-
chooseConfiguration
protected ILaunchConfiguration chooseConfiguration(List<ILaunchConfiguration> configList)
Returns a configuration from the given collection of configurations that should be launched, ornullto cancel. Default implementation opens a selection dialog that allows the user to choose one of the specified launch configurations. Returns the chosen configuration, ornullif the user cancels.- Parameters:
configList- list of configurations to choose from- Returns:
- configuration to launch or
nullto 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:
launchin interfaceILaunchShortcut
-
launch
public void launch(ISelection selection, String mode)
- Specified by:
launchin interfaceILaunchShortcut
-
getLaunchableResource
public IResource getLaunchableResource(IEditorPart editorpart)
- Specified by:
getLaunchableResourcein interfaceILaunchShortcut2
-
getLaunchableResource
public IResource getLaunchableResource(ISelection selection)
- Specified by:
getLaunchableResourcein interfaceILaunchShortcut2
-
getLaunchConfigurations
public ILaunchConfiguration[] getLaunchConfigurations(IEditorPart editorpart)
- Specified by:
getLaunchConfigurationsin interfaceILaunchShortcut2
-
getLaunchConfigurations
public ILaunchConfiguration[] getLaunchConfigurations(ISelection selection)
- Specified by:
getLaunchConfigurationsin interfaceILaunchShortcut2
-
-