Package org.eclipse.debug.core.sourcelookup

package org.eclipse.debug.core.sourcelookup

Provides support for source lookup.

Package Specification

This package provides classes and interfaces to support source lookup. A source lookup director is a persistable source locator that directs source lookup among a collection of source lookup participants and a collection of source containers. Each source lookup participant is a source locator itself, which allows more than one source locator to participate in source lookup for a launch. Each source lookup participant searches for source in the source containers managed by its director, and each participant is notified of changes in the set of source containers being searched.

A source lookup participant participates in source lookup by searching an ordered list of source containers for source elements corresponding to a debug artifact. For example, a participant may be asked to find source corresponding to a stack frame or breakpoint. An implementation of a source lookup participant is debug model specific, since it must convert the debug model artifact (stack frame, breakpoint, etc.), into a source name that can be recognized by a source container, to search for source elements. Source containers are generally debug model independent, whereas source lookup participants are debug model specific.

Related Packages

Package	Description
org.eclipse.debug.core	Provides support for launching programs, breakpoint management, expression management, and debug events.
org.eclipse.debug.core.sourcelookup.containers	Provides implementations of common source containers supporting source lookup.
org.eclipse.debug.core.commands	Provides a set of interfaces for common debug commands.
org.eclipse.debug.core.model	Defines interfaces for debug model elements, source lookup, and launching.

Class	Description
AbstractSourceLookupDirector	Directs source lookup among a collection of source lookup participants, and a common collection of source containers.
AbstractSourceLookupParticipant	Common super class for implementations of source lookup participants.
IPersistableSourceLocator2	Extensions to the IPersistableSourceLocator interface.
ISourceContainer	A source container is a container of source code.
ISourceContainerType	A source container type represents a kind of container of source code.
ISourceContainerTypeDelegate	A source container type delegate represents a kind of container of source code.
ISourceLookupDirector	A source lookup director directs the source lookup process among a set of participants and source containers.
ISourceLookupParticipant	A source lookup participant participates in source lookup by searching an ordered list of source containers for source elements corresponding to a debug artifact.
ISourcePathComputer	A source path computer computes the default source lookup path (set of source containers that should be considered) for a launch configuration.
ISourcePathComputerDelegate	A source path computer delegate computes the default source lookup path (set of source containers that should be considered) for a launch configuration.