|
Eclipse Platform 2.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Describes and creates instances of a specific type of launch configuration. Launch configuration types are defined by extensions.
A launch configuration type extension is defined in plugin.xml
.
Following is an example definition of a launch configuration
type extension.
<extension point="org.eclipse.debug.core.launchConfigurationTypes"> <launchConfigurationType id="com.example.ExampleIdentifier" delegate="com.example.ExampleLaunchConfigurationDelegate" modes="run, debug" name="Example Application"> </launchConfigurationType> </extension>The attributes are specified as follows:
id
specifies a unique identifier for this launch configuration
type.delegate
specifies the fully qualified name of the java class
that implements ILaunchConfigurationDelegate
. Launch configuration
instances of this type will delegate to instances of this class
to perform launching.modes
specifies a comma separated list of the modes this
type of launch configuration suports - "run"
and/or "debug"
.name
specifies a human readable name for this type
of launch configuration.category
is an optional attribute that specifies a category
for this launch configuration type. Categories are client defined. This
attribute was added in the 2.1 release.
The category
attribute has been added in release 2.1, such that other
tools may re-use the launch configuration framework for purposes other than
the standard running and debugging of programs under developement. Such that
clients may access arbitrary attribtes specified in launch configuration type
extension definitions, the method getAttribute
has also been
added. Launch configurations that are to be recognized as standard run/debug
launch configurations should not specify the category
attribute.
This interface is not intended to be implemented by clients. Clients
that define a launch configuration delegate extension implement the
ILaunchConfigurationDelegate
interface.
ILaunchConfiguration
Method Summary | |
String |
getAttribute(String attributeName)
Returns the attribute with the given name, as specified by this launch configuration type's extension definition, or null if
unspecified. |
String |
getCategory()
Returns this launch configuration type's category, or null
if unspecified. |
ILaunchConfigurationDelegate |
getDelegate()
Returns the launch configuration delegate for launch configurations of this type. |
String |
getIdentifier()
Returns the unique identifier for this type of launch configuration |
String |
getName()
Returns the name of this type of launch configuration. |
boolean |
isPublic()
Returns whether this launch configuration type is public. |
ILaunchConfigurationWorkingCopy |
newInstance(IContainer container,
String name)
Returns a new launch configuration working copy of this type, that resides in the specified container, with the given name. |
boolean |
supportsMode(String mode)
Returns whether this type of launch configuration supports the specified mode. |
Methods inherited from interface org.eclipse.core.runtime.IAdaptable |
getAdapter |
Method Detail |
public boolean supportsMode(String mode)
mode
- a mode in which a configuration can be launched, one of
the mode constants defined by ILaunchManager
- RUN_MODE
or
DEBUG_MODE
.public String getName()
public String getIdentifier()
public boolean isPublic()
ILaunchManager
.public ILaunchConfigurationWorkingCopy newInstance(IContainer container, String name) throws CoreException
container
is null, the configuration
will reside locally in the metadata area.
Note: a launch configuration is not actually created until the working copy is saved.container
- the container in which the new configuration will
reside, or null
if the configuration should reside
locally with the metadata.name
- name for the launch configurationCoreException
- if an instance of this type
of launch configuration could not be created for any
reasonpublic ILaunchConfigurationDelegate getDelegate() throws CoreException
CoreException
- if unable to instantiate the
delegatepublic String getCategory()
null
if unspecified. This corresponds to the category attribute specified in
the extension definition.null
public String getAttribute(String attributeName)
null
if
unspecified.attributeName
- attribute namenull
|
Eclipse Platform 2.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |