Interface IRuntimeClasspathEntry2

All Superinterfaces:
IRuntimeClasspathEntry

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:
Restriction:
This interface is not intended to be implemented by clients.
Restriction:
This interface is not intended to be extended by clients.
  • Method Details

    • initializeFrom

      void initializeFrom(Element memento) throws org.eclipse.core.runtime.CoreException
      Initializes this runtime classpath entry from the given memento.
      Parameters:
      memento - memento created by a classpath entry of the same type
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to initialize from the given memento
    • getTypeId

      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(org.eclipse.debug.core.ILaunchConfiguration configuration) throws org.eclipse.core.runtime.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:
      org.eclipse.core.runtime.CoreException - if unable to retrieve contained entries
    • getRuntimeClasspathEntries

      default IRuntimeClasspathEntry[] getRuntimeClasspathEntries(boolean excludeTestCode) throws org.eclipse.core.runtime.CoreException
      Returns the classpath entries this entry is composed of, or an empty collection if this entry is not a composite entry.
      Parameters:
      excludeTestCode - true, if test code should be excluded
      Returns:
      the classpath entries this entry is composed of, or an empty collection if this entry is not a composite entry
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to retrieve contained entries
      Since:
      3.10
    • getName

      String getName()
      Returns a human readable name for this classpath entry.
      Returns:
      a human readable name for this classpath entry