org.eclipse.jdt.debug.ui.launchConfigurations
Class JavaLaunchShortcut

java.lang.Object
  org.eclipse.jdt.debug.ui.launchConfigurations.JavaLaunchShortcut

All Implemented Interfaces:

org.eclipse.debug.ui.ILaunchShortcut, org.eclipse.debug.ui.ILaunchShortcut2

Direct Known Subclasses:

JavaAppletLaunchShortcut, JavaApplicationLaunchShortcut

public abstract class JavaLaunchShortcut
extends Object
implements org.eclipse.debug.ui.ILaunchShortcut2

Common behavior for Java launch shortcuts

This class may be subclassed.

Since:

3.3

Constructor Summary

JavaLaunchShortcut()

Method Summary

protected org.eclipse.debug.core.ILaunchConfiguration	chooseConfiguration(List configList) Returns a configuration from the given collection of configurations that should be launched, or null to cancel.
protected IType	chooseType(IType[] types, String title) Prompts the user to select a type from the given types.
protected abstract org.eclipse.debug.core.ILaunchConfiguration	createConfiguration(IType type) Creates and returns a new configuration based on the specified type.
protected org.eclipse.debug.core.ILaunchConfiguration	findLaunchConfiguration(IType type, org.eclipse.debug.core.ILaunchConfigurationType configType) Finds and returns an existing configuration to re-launch for the given type, or null if there is no existing configuration.
protected abstract IType[]	findTypes(Object[] elements, org.eclipse.jface.operation.IRunnableContext context) Finds and returns the types in the given collection of elements that can be launched.
protected abstract org.eclipse.debug.core.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.
org.eclipse.core.resources.IResource	getLaunchableResource(org.eclipse.ui.IEditorPart editorpart)
org.eclipse.core.resources.IResource	getLaunchableResource(org.eclipse.jface.viewers.ISelection selection)
org.eclipse.debug.core.ILaunchConfiguration[]	getLaunchConfigurations(org.eclipse.ui.IEditorPart editorpart)
org.eclipse.debug.core.ILaunchConfiguration[]	getLaunchConfigurations(org.eclipse.jface.viewers.ISelection selection)
protected abstract String	getSelectionEmptyMessage() Returns an error message to use when the selection does not contain a type that can be launched.
protected org.eclipse.swt.widgets.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.
void	launch(org.eclipse.ui.IEditorPart editor, String mode)
void	launch(org.eclipse.jface.viewers.ISelection selection, String mode)
protected void	launch(IType type, String mode) Launches the given type in the specified mode.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JavaLaunchShortcut

public JavaLaunchShortcut()

Method Detail

getConfigurationType

protected abstract org.eclipse.debug.core.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 org.eclipse.debug.core.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,
                                     org.eclipse.jface.operation.IRunnableContext context)
                              throws InterruptedException,
                                     org.eclipse.core.runtime.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 launched

context - progress reporting context

Returns:

collection of types that can be launched, possibly empty

Throws:

InterruptedException - if the search is canceled

org.eclipse.core.runtime.CoreException - 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 from

title - 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 launch

mode - launch mode

Since:

3.5

findLaunchConfiguration

protected org.eclipse.debug.core.ILaunchConfiguration findLaunchConfiguration(IType type,
                                                                              org.eclipse.debug.core.ILaunchConfigurationType configType)

Finds and returns an existing configuration to re-launch for the given type, or null if there is no existing configuration.

Returns:

a configuration to use for launching the given type or null if none

chooseConfiguration

protected org.eclipse.debug.core.ILaunchConfiguration chooseConfiguration(List configList)

Returns a configuration from the given collection of configurations that should be launched, or null to cancel. Default implementation opens a selection dialog that allows the user to choose one of the specified launch configurations. Returns the chosen configuration, or null if the user cancels.

Parameters:

configList - list of configurations to choose from

Returns:

configuration to launch or null to cancel

getShell

protected org.eclipse.swt.widgets.Shell getShell()

Convenience method to return the active workbench window shell.

Returns:

active workbench window shell

launch

public void launch(org.eclipse.ui.IEditorPart editor,
                   String mode)

Specified by:

launch in interface org.eclipse.debug.ui.ILaunchShortcut

launch

public void launch(org.eclipse.jface.viewers.ISelection selection,
                   String mode)

Specified by:

launch in interface org.eclipse.debug.ui.ILaunchShortcut

getLaunchableResource

public org.eclipse.core.resources.IResource getLaunchableResource(org.eclipse.ui.IEditorPart editorpart)

Specified by:

getLaunchableResource in interface org.eclipse.debug.ui.ILaunchShortcut2

getLaunchableResource

public org.eclipse.core.resources.IResource getLaunchableResource(org.eclipse.jface.viewers.ISelection selection)

Specified by:

getLaunchableResource in interface org.eclipse.debug.ui.ILaunchShortcut2

getLaunchConfigurations

public org.eclipse.debug.core.ILaunchConfiguration[] getLaunchConfigurations(org.eclipse.ui.IEditorPart editorpart)

Specified by:

getLaunchConfigurations in interface org.eclipse.debug.ui.ILaunchShortcut2

getLaunchConfigurations

public org.eclipse.debug.core.ILaunchConfiguration[] getLaunchConfigurations(org.eclipse.jface.viewers.ISelection selection)

Specified by:

getLaunchConfigurations in interface org.eclipse.debug.ui.ILaunchShortcut2