Package org.eclipse.debug.core.model
Interface IPersistableSourceLocator
- All Superinterfaces:
ISourceLocator
- All Known Subinterfaces:
IPersistableSourceLocator2,ISourceLookupDirector
- All Known Implementing Classes:
AbstractSourceLookupDirector
A source locator that can be persisted and restored, to be used with a
specific launch configuration. The debug plug-in defines a source locator
extension point for persistable source locators.
A source locator extension is defined in plugin.xml. Following
is an example definition of a source locator extension.
<extension point="org.eclipse.debug.core.sourceLocators">
<sourceLocator
id="com.example.ExampleIdentifier"
class="com.example.ExampleSourceLocator"
name="Example Source Locator">
</sourceLocator>
</extension>
The attributes are specified as follows:
idspecifies a unique identifier for this source locator.classspecifies the fully qualified name of the Java class that implementsIPersistableSourceLocator.namea human readable name, describing the type of this source locator.
Clients may implement this interface.
- Since:
- 2.0
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionReturns a memento that can be used to reconstruct this source locatorvoidinitializeDefaults(ILaunchConfiguration configuration) Initializes this source locator to perform default source lookup for the given launch configuration.voidinitializeFromMemento(String memento) Initializes this source locator based on the given memento.Methods inherited from interface org.eclipse.debug.core.model.ISourceLocator
getSourceElement
-
Method Details
-
getMemento
Returns a memento that can be used to reconstruct this source locator- Returns:
- a memento that can be used to reconstruct this source locator
- Throws:
CoreException- if unable to construct a memento
-
initializeFromMemento
Initializes this source locator based on the given memento.- Parameters:
memento- a memento to initialize this source locator- Throws:
CoreException- on failure to initialize
-
initializeDefaults
Initializes this source locator to perform default source lookup for the given launch configuration.- Parameters:
configuration- launch configuration this source locator will be performing source lookup for- Throws:
CoreException- on failure to initialize
-