|
Eclipse Platform 2.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | 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 |
DEBUG_MODE
A launch in a special debug mode (value "debug" ). |
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. |
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. |
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. |
IProcess[] |
getProcesses()
Returns the collection of processes currently registered with this launch manager. |
boolean |
isExistingLaunchConfigurationName(String name)
Return true if there is a launch configuration with the specified name,
false otherwise. |
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"
).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 typeCoreException
- if an error occurs while retreiving
a launch configurationpublic ILaunchConfiguration getLaunchConfiguration(IFile file)
file
- launch configuration filepublic 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 extensionnull
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 checkedCoreException
- 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 extensionCoreException
- 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 broadcastnull
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 broadcastnull
if the add notification is not the
result of a move
|
Eclipse Platform 2.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |