|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
An editable copy of a launch configuration. Attributes of a launch configuration are modified by modifying the attributes of a working copy, and then saving the working copy.
This interface is not intended to be implemented by clients. Clients
that define a launch configuration delegate extension implement the
ILaunchConfigurationDelegate
interface.
ILaunchConfiguration
,
ILaunchConfigurationType
,
ILaunchConfigurationDelegate
Field Summary |
Fields inherited from interface org.eclipse.debug.core.ILaunchConfiguration |
ATTR_SOURCE_LOCATOR_ID, ATTR_SOURCE_LOCATOR_MEMENTO, LAUNCH_CONFIGURATION_FILE_EXTENSION |
Method Summary | |
ILaunchConfiguration |
doSave()
Saves this working copy to its underlying file and returns a handle to the resulting launch configuration. |
ILaunchConfiguration |
getOriginal()
Returns the original launch configuration this working copy was created from, or null if this is a new
working copy created from a launch configuration type. |
boolean |
isDirty()
Returns whether this configuration has been modified since it was last saved or created. |
void |
rename(String name)
Renames this launch configuration to the specified name. |
void |
setAttribute(String attributeName,
boolean value)
Sets the boolean-valued attribute with the given name. |
void |
setAttribute(String attributeName,
int value)
Sets the integer-valued attribute with the given name. |
void |
setAttribute(String attributeName,
List value)
Sets the java.util.List -valued attribute with the given name. |
void |
setAttribute(String attributeName,
Map value)
Sets the java.util.Map -valued attribute with the given name. |
void |
setAttribute(String attributeName,
String value)
Sets the String-valued attribute with the given name. |
void |
setContainer(IContainer container)
Sets the container this launch configuration will be stored in when saved. |
Methods inherited from interface org.eclipse.debug.core.ILaunchConfiguration |
contentsEqual, copy, delete, exists, getAttribute, getAttribute, getAttribute, getAttribute, getAttribute, getFile, getLocation, getMemento, getName, getType, getWorkingCopy, isLocal, isWorkingCopy, launch, supportsMode |
Methods inherited from interface org.eclipse.core.runtime.IAdaptable |
getAdapter |
Method Detail |
public boolean isDirty()
public ILaunchConfiguration doSave() throws CoreException
CoreException
- if an exception occurs while
writing this configuration to its underlying file.public void setAttribute(String attributeName, int value)
attributeName
- the name of the attributevalue
- the valuepublic void setAttribute(String attributeName, String value)
null
, the attribute is removed from
this launch configuration.
attributeName
- the name of the attributevalue
- the value, or null
if the attribute is to be undefinedpublic void setAttribute(String attributeName, List value)
java.util.List
-valued attribute with the given name.
The specified List must contain only String-valued entries.
If the value is null
, the attribute is removed from
this launch configuration.
attributeName
- the name of the attributevalue
- the value, or null
if the attribute is to be undefinedpublic void setAttribute(String attributeName, Map value)
java.util.Map
-valued attribute with the given name.
The specified Map must contain only String keys and String values.
If the value is null
, the attribute is removed from
this launch configuration.
attributeName
- the name of the attributevalue
- the value, or null
if the attribute is to be undefinedpublic void setAttribute(String attributeName, boolean value)
attributeName
- the name of the attributevalue
- the valuepublic ILaunchConfiguration getOriginal()
null
if this is a new
working copy created from a launch configuration type.
null
public void rename(String name)
null
. Has no effect if the name
is the same as the current name. If this working copy is based
on an existing launch configuration, this will cause
the underlying launch configuration file to be renamed when
this working copy is saved.
name
- the new name for this configurationpublic void setContainer(IContainer container)
null
, this configuration
will be stored locally with the workspace. The specified
container must exist, if specified.
If this configuration is changed from local to non-local, a file will be created in the specified container when saved. The local file associated with this configuration will be deleted.
If this configuration is changed from non-local to local, a file will be created locally when saved. The original file associated with this configuration in the workspace will be deleted.
container
- the container in which to store this
launch configuration, or null
if this
configuration is to be stored locally
|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |