|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
The launch manager manages the set of registered launches, maintaining a collection of active processes and debug targets. Clients interested in launch notification may register with the launch manager.
Clients are not intended to implement this interface.
ILaunch
,
ILaunchListener
Field Summary | |
---|---|
static String |
ATTR_APPEND_ENVIRONMENT_VARIABLES
Launch configuration attribute name. |
static String |
ATTR_ENVIRONMENT_VARIABLES
Launch configuration attribute name. |
static String |
DEBUG_MODE
A launch in a special debug mode (value "debug" ). |
static String |
PROFILE_MODE
A launch in a special profile mode (value "profile" ). |
static String |
RUN_MODE
A launch in a normal, non-debug mode(value "run" ). |
Method Summary | |
---|---|
void |
addLaunch(ILaunch launch)
Adds the specified launch and notifies listeners. |
void |
addLaunchConfigurationListener(ILaunchConfigurationListener listener)
Adds the given launch configuration listener to the list of listeners notified when a launch configuration is added, removed, or changed. |
void |
addLaunches(ILaunch[] launches)
Adds the specified launch objects and notifies listeners. |
void |
addLaunchListener(ILaunchesListener listener)
Adds the given listener to the collection of registered launch listeners. |
void |
addLaunchListener(ILaunchListener listener)
Adds the given listener to the collection of registered launch listeners. |
String |
generateUniqueLaunchConfigurationNameFrom(String namePrefix)
Return a String that can be used as the name of a launch configuration. |
IDebugTarget[] |
getDebugTargets()
Returns the collection of debug targets currently registered with this launch manager. |
String[] |
getEnvironment(ILaunchConfiguration configuration)
Returns an array of environment variables to be used when launching the given configuration or null if unspecified. |
ILaunchConfiguration |
getLaunchConfiguration(IFile file)
Returns a handle to the launch configuration contained in the specified file. |
ILaunchConfiguration |
getLaunchConfiguration(String memento)
Returns a handle to the launch configuration specified by the given memento. |
ILaunchConfiguration[] |
getLaunchConfigurations()
Returns all launch configurations defined in the workspace. |
ILaunchConfiguration[] |
getLaunchConfigurations(ILaunchConfigurationType type)
Returns all launch configurations of the specified type defined in the workspace |
ILaunchConfigurationType |
getLaunchConfigurationType(String id)
Returns the launch configuration type extension with the specified id, or null if it does not exist. |
ILaunchConfigurationType[] |
getLaunchConfigurationTypes()
Returns all defined launch configuration type extensions |
ILaunch[] |
getLaunches()
Returns the collection of launches currently registered with this launch manager. |
ILaunchMode |
getLaunchMode(String mode)
Returns the launch mode registered with the given mode identifier, or null if none. |
ILaunchMode[] |
getLaunchModes()
Returns all registered launch modes. |
ILaunchConfiguration |
getMovedFrom(ILaunchConfiguration addedConfiguration)
When a launch configuration is created or moved, registered launch configuration listeners (see ILaunchConfigurationListener )
are notified of an add notification for the new configuration. |
ILaunchConfiguration |
getMovedTo(ILaunchConfiguration removedConfiguration)
When a launch configuration is deleted or moved, registered launch configuration listeners (see ILaunchConfigurationListener )
are notified of a remove notification for launch configuration that has
been deleted. |
Map |
getNativeEnvironment()
Returns the native system environment variables as a map of variable names and values (Strings). |
Map |
getNativeEnvironmentCasePreserved()
Returns the native system environment variables as a map of variable names and values (Strings). |
IProcess[] |
getProcesses()
Returns the collection of processes currently registered with this launch manager. |
ISourceContainerType |
getSourceContainerType(String id)
Returns the source container type extension registered with the given unique identifier, or null if none. |
ISourceContainerType[] |
getSourceContainerTypes()
Returns all registered source container type extensions. |
ISourcePathComputer |
getSourcePathComputer(ILaunchConfiguration configuration)
Returns a source path computer to compute a default source lookup path for the given launch configuration, or null if a source path
computer has not been registered for the associated launch configuration
type. |
ISourcePathComputer |
getSourcePathComputer(String id)
Returns the source path computer extension registered with the given unique identifier, or null if none. |
boolean |
isExistingLaunchConfigurationName(String name)
Return true if there is a launch configuration with the specified name,
false otherwise. |
boolean |
isRegistered(ILaunch launch)
Returns whether the given launch is currently registered. |
IPersistableSourceLocator |
newSourceLocator(String identifier)
Creates and returns a new source locator of the specified type. |
void |
removeLaunch(ILaunch launch)
Removes the specified launch and notifies listeners. |
void |
removeLaunchConfigurationListener(ILaunchConfigurationListener listener)
Removes the given launch configuration listener from the list of listeners notified when a launch configuration is added, removed, or changed. |
void |
removeLaunches(ILaunch[] launches)
Removes the specified launch objects and notifies listeners. |
void |
removeLaunchListener(ILaunchesListener listener)
Removes the given listener from the collection of registered launch listeners. |
void |
removeLaunchListener(ILaunchListener listener)
Removes the given listener from the collection of registered launch listeners. |
Field Detail |
public static final String RUN_MODE
"run"
).
public static final String DEBUG_MODE
"debug"
).
public static final String PROFILE_MODE
"profile"
).
public static final String ATTR_ENVIRONMENT_VARIABLES
null
which indicates the default environment
should be used.
public static final String ATTR_APPEND_ENVIRONMENT_VARIABLES
true
),
or if they should replace the environment (i.e. false
). The
default value is true
.
Method Detail |
public void addLaunchListener(ILaunchListener listener)
listener
- the listener to registerpublic void addLaunchListener(ILaunchesListener listener)
listener
- the listener to registerpublic void removeLaunch(ILaunch launch)
launch
- the launch to removepublic void removeLaunches(ILaunch[] launches)
launches
- the launch objects to removepublic IDebugTarget[] getDebugTargets()
public ILaunch[] getLaunches()
public IProcess[] getProcesses()
public void addLaunch(ILaunch launch)
launch
- the launch to addpublic void addLaunches(ILaunch[] launches)
launches
- the launch objects to addpublic void removeLaunchListener(ILaunchListener listener)
listener
- the listener to deregisterpublic void removeLaunchListener(ILaunchesListener listener)
listener
- the listener to deregisterpublic ILaunchConfiguration[] getLaunchConfigurations() throws CoreException
CoreException
- if an exception occurs retrieving configurationspublic ILaunchConfiguration[] getLaunchConfigurations(ILaunchConfigurationType type) throws CoreException
type
- a launch configuration type
CoreException
- if an error occurs while retreiving
a launch configurationpublic ILaunchConfiguration getLaunchConfiguration(IFile file)
file
- launch configuration file
public ILaunchConfiguration getLaunchConfiguration(String memento) throws CoreException
CoreException
- if the given memento is invalid or
an exception occurs parsing the mementoILaunchConfiguration.getMemento()
public ILaunchConfigurationType[] getLaunchConfigurationTypes()
public ILaunchConfigurationType getLaunchConfigurationType(String id)
null
if it does not exist.
id
- unique identifier for a launch configuration type extension
null
if it does not existpublic void addLaunchConfigurationListener(ILaunchConfigurationListener listener)
listener
- launch configuration listenerpublic void removeLaunchConfigurationListener(ILaunchConfigurationListener listener)
listener
- launch configuration listenerpublic boolean isExistingLaunchConfigurationName(String name) throws CoreException
true
if there is a launch configuration with the specified name,
false
otherwise.
name
- the name of the launch configuration whose existence is being checked
CoreException
- if unable to retrieve existing launch configuration namespublic String generateUniqueLaunchConfigurationNameFrom(String namePrefix)
namePrefix
as a starting point. If
there is no existing launch configuration with this name, then namePrefix
is returned. Otherwise, the value returned consists of the specified prefix plus
some suffix that guarantees uniqueness.
namePrefix
- the String that the returned name must begin withpublic IPersistableSourceLocator newSourceLocator(String identifier) throws CoreException
identifier
- the identifier associated with a
persistable source locator extension
CoreException
- if an exception occurs creating
the source locatorpublic ILaunchConfiguration getMovedFrom(ILaunchConfiguration addedConfiguration)
ILaunchConfigurationListener
)
are notified of an add notification for the new configuration. If the
notification is the result of a move this method will return a handle to
the launch configuration that the added launch configuration was moved
from. This method returns null
if the added launch
configuration was not the result of a rename or move. This information is
only available during the add notification call back
launchConfigurationAdded
.
Renaming a configuration is considered the same as moving a configuration.
addedConfiguration
- a launch configuration for which an add
notification is being broadcast
null
if the add notification is not the
result of a movepublic ILaunchConfiguration getMovedTo(ILaunchConfiguration removedConfiguration)
ILaunchConfigurationListener
)
are notified of a remove notification for launch configuration that has
been deleted. If the notification is the result of a move this method
will return a handle to the launch configuration that the removed launch
configuration was moved to. This method returns null
if the
removed launch configuration was not the result of a rename or move. This
information is only available during the add notification call back
launchConfigurationRemoved
.
Renaming a configuration is considered the same as moving a configuration.
removedConfiguration
- a launch configuration for which a
remove notification is being broadcast
null
if the add notification is not the
result of a movepublic ILaunchMode[] getLaunchModes()
public ILaunchMode getLaunchMode(String mode)
null
if none.
mode
- mode identifier
null
public String[] getEnvironment(ILaunchConfiguration configuration) throws CoreException
null
if unspecified.
configuration
- launch configuration
CoreException
- if unable to access associated attribute or if
unable to resolve a variable in an environment variable's valuepublic ISourcePathComputer getSourcePathComputer(ILaunchConfiguration configuration) throws CoreException
null
if a source path
computer has not been registered for the associated launch configuration
type.
configuration
- a launch configuration
null
if unspecified
CoreException
- if an exception occurs while instantiating a source
path computerpublic ISourcePathComputer getSourcePathComputer(String id)
null
if none.
id
- source path computer identifier
null
if nonepublic Map getNativeEnvironmentCasePreserved()
Note that WIN32 system environment preserves
the case of variable names but is otherwise case insensitive.
Depending on what you intend to do with the environment, the
lack of normalization may or may not be create problems. This
method returns mixed-case keys using the variable names
recorded by the OS.
Use getNativeEnvironment()
instead to get a WIN32 system
environment where all keys have been normalized to uppercase.
String
; value type: String
)public Map getNativeEnvironment()
Note that WIN32 system environment preserves
the case of variable names but is otherwise case insensitive.
Depending on what you intend to do with the environment, the
lack of normalization may or may not be create problems. On
WIN32, this method normalizes mixed-case keys variable names
to uppercase. Use getNativeEnvironmentCasePreserved()
instead to get a WIN32 system environment where the keys are
the mixed-case variable names recorded by the OS.
String
; value type: String
)public ISourceContainerType[] getSourceContainerTypes()
public ISourceContainerType getSourceContainerType(String id)
null
if none.
id
- unique identifier of a source container type extension
null
if nonepublic boolean isRegistered(ILaunch launch)
launch
- a launch
|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) IBM Corp. and others 2000, 2005. All rights reserved.