org.eclipse.jdt.launching

Interface IRuntimeClasspathEntry2

All Superinterfaces:

IRuntimeClasspathEntry

All Known Implementing Classes:

AbstractRuntimeClasspathEntry, DefaultProjectClasspathEntry, VariableClasspathEntry

public interface IRuntimeClasspathEntry2
extends IRuntimeClasspathEntry

Enhancements to IRuntimeClasspathEntry to support extensible runtime classpath entries. Contributed runtime classpath entries have a type of OTHER, and are contributed to the runtimeClasspathEntries extension point.

New types of runtime classpath entries are only intended to be contributed by the Java debugger.

Since:

3.0

See Also:

IRuntimeClasspathEntry

Field Summary

Fields inherited from interface org.eclipse.jdt.launching.IRuntimeClasspathEntry

ARCHIVE, BOOTSTRAP_CLASSES, CLASS_PATH, CONTAINER, MODULE_PATH, OTHER, PATCH_MODULE, PROJECT, STANDARD_CLASSES, USER_CLASSES, VARIABLE

Method Summary

Modifier and Type	Method and Description
java.lang.String	getName() Returns a human readable name for this classpath entry.
IRuntimeClasspathEntry[]	getRuntimeClasspathEntries(ILaunchConfiguration configuration) Returns the classpath entries this entry is composed of, or an empty collection if this entry is not a composite entry.
java.lang.String	getTypeId() Returns the unique identifier of the extension that contributed this classpath entry type, or null if this classpath entry type was not contributed.
void	initializeFrom(org.w3c.dom.Element memento) Initializes this runtime classpath entry from the given memento.
boolean	isComposite() Returns whether this classpath entry is composed of other entries.

Methods inherited from interface org.eclipse.jdt.launching.IRuntimeClasspathEntry

getClasspathEntry, getClasspathProperty, getExternalAnnotationsPath, getJavaProject, getLocation, getMemento, getPath, getResource, getSourceAttachmentLocation, getSourceAttachmentPath, getSourceAttachmentRootLocation, getSourceAttachmentRootPath, getType, getVariableName, isAutomodule, setClasspathProperty, setExternalAnnotationsPath, setSourceAttachmentPath, setSourceAttachmentRootPath

Method Detail

initializeFrom

void initializeFrom(org.w3c.dom.Element memento)
             throws CoreException

Initializes this runtime classpath entry from the given memento.

Parameters:

memento - memento created by a classpath entry of the same type

Throws:

CoreException - if unable to initialize from the given memento

getTypeId

java.lang.String getTypeId()

Returns the unique identifier of the extension that contributed this classpath entry type, or null if this classpath entry type was not contributed.

Returns:

the unique identifier of the extension that contributed this classpath entry type, or null if this classpath entry type was not contributed

isComposite

boolean isComposite()

Returns whether this classpath entry is composed of other entries.

Returns:

whether this classpath entry is composed of other entries

getRuntimeClasspathEntries

IRuntimeClasspathEntry[] getRuntimeClasspathEntries(ILaunchConfiguration configuration)
                                             throws CoreException

Returns the classpath entries this entry is composed of, or an empty collection if this entry is not a composite entry.

Parameters:

configuration - the context (launch configuration) in which this runtime classpath entry is being queried for contained entries, possibly null

Returns:

the classpath entries this entry is composed of, or an empty collection if this entry is not a composite entry

Throws:

CoreException - if unable to retrieve contained entries

getName

java.lang.String getName()

Returns a human readable name for this classpath entry.

Returns:

a human readable name for this classpath entry