org.eclipse.jdt.internal.launching

Class RuntimeClasspathEntry

java.lang.Object

org.eclipse.jdt.internal.launching.RuntimeClasspathEntry

All Implemented Interfaces:

IRuntimeClasspathEntry

public class RuntimeClasspathEntry
extends java.lang.Object
implements IRuntimeClasspathEntry

An entry on the runtime classpath that the user can manipulate and share in a launch configuration.

Since:

2.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

Constructor Summary

Constructors

Constructor and Description
RuntimeClasspathEntry(IClasspathEntry entry) Constructs a new runtime classpath entry based on the (build) classpath entry.
RuntimeClasspathEntry(IClasspathEntry entry, int classpathProperty) Constructs a new container entry in the context of the given project

Method Summary

Modifier and Type	Method and Description
protected void	abort(java.lang.String message, java.lang.Throwable e) Throws an internal error exception
protected boolean	equal(java.lang.Object one, java.lang.Object two) Returns whether the given objects are equal, accounting for null
boolean	equals(java.lang.Object obj)
IClasspathEntry	getClasspathEntry() Returns a classpath entry equivalent to this runtime classpath entry, or null if none.
int	getClasspathProperty() Returns a constant indicating where this entry should appear on the runtime classpath by default.
IPath	getExternalAnnotationsPath() Returns the path to the external annotations file or directory, or null if no external annotations are associated with this classpath entry.
IJavaProject	getJavaProject() Returns the Java project associated with this runtime classpath entry or null if none.
java.lang.String	getLocation() Returns an absolute path in the local file system for this entry, or null if none, or if this entry is of type CONTAINER.
java.lang.String	getMemento() Returns a memento for this classpath entry.
IPath	getPath() Returns the path associated with this entry, or null if none.
protected IClasspathEntry	getResolvedClasspathEntry() Returns the resolved classpath entry associated with this runtime entry, resolving if required.
IResource	getResource() Returns the resource associated with this entry, or null if none.
protected IResource	getResource(IPath path) Returns the resource in the workspace associated with the given absolute path, or null if none.
java.lang.String	getSourceAttachmentLocation() Returns an absolute path in the local file system for the source attachment associated with this entry entry, or null if none.
IPath	getSourceAttachmentPath() Returns the path to the source archive associated with this entry, or null if this classpath entry has no source attachment.
java.lang.String	getSourceAttachmentRootLocation() Returns a path relative to this entry's source attachment path for the root location containing source, or null if none.
IPath	getSourceAttachmentRootPath() Returns the path within the source archive where package fragments are located.
int	getType() Returns this classpath entry's type.
java.lang.String	getVariableName() Returns the first segment of the path associated with this entry, or null if this entry is not of type VARIABLE or CONTAINER.
int	hashCode()
boolean	isAutomodule() Returns true if the java project associated is an AutoModule.
protected boolean	isEmpty(java.lang.String string)
protected java.lang.String	resolveToOSPath(IPath path) Returns the OS path for the given absolute or workspace relative path
void	setClasspathProperty(int location) Sets whether this entry should appear on the bootstrap classpath, the user classpath, or whether this entry is a standard bootstrap entry that does not need to appear on the classpath.
void	setExternalAnnotationsPath(IPath path) Sets the path to the external annotations file or directory.
void	setJavaProject(IJavaProject project) Sets the Java project associated with this classpath entry.
void	setSourceAttachmentPath(IPath path) Sets the path to the source archive associated with this entry, or null if this classpath entry has no source attachment.
void	setSourceAttachmentRootPath(IPath path) Sets the path within the source archive where package fragments are located.
java.lang.String	toString()
protected void	updateClasspathEntry(IPath path, IPath sourcePath, IPath rootPath, IPath annotationsPath) Creates a new underlying classpath entry for this runtime classpath entry with the given paths, due to a change in source attachment.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RuntimeClasspathEntry

public RuntimeClasspathEntry(IClasspathEntry entry)

Constructs a new runtime classpath entry based on the (build) classpath entry.

Parameters:

entry - the associated classpath entry

RuntimeClasspathEntry

public RuntimeClasspathEntry(IClasspathEntry entry,
                             int classpathProperty)

Constructs a new container entry in the context of the given project

Parameters:

entry - classpath entry

classpathProperty - this entry's classpath property

Method Detail

abort

protected void abort(java.lang.String message,
                     java.lang.Throwable e)
              throws CoreException

Throws an internal error exception

Parameters:

message - the message

e - the error

Throws:

CoreException - the new CoreException

getType

public int getType()

Description copied from interface: IRuntimeClasspathEntry

Returns this classpath entry's type. The type of a runtime classpath entry is identified by one of the following constants:

• PROJECT
• ARCHIVE
• VARIABLE
• CONTAINER
• OTHER

Since 3.0, a type of OTHER may be returned.

Specified by:

getType in interface IRuntimeClasspathEntry

Returns:

this classpath entry's type

See Also:

IRuntimeClasspathEntry.getType()

getClasspathEntry

public IClasspathEntry getClasspathEntry()

Description copied from interface: IRuntimeClasspathEntry

Returns a classpath entry equivalent to this runtime classpath entry, or null if none.

Since 3.0, this method may return null.

Specified by:

getClasspathEntry in interface IRuntimeClasspathEntry

Returns:

a classpath entry equivalent to this runtime classpath entry, or null

See Also:

IRuntimeClasspathEntry.getClasspathEntry()

getMemento

public java.lang.String getMemento()
                            throws CoreException

Description copied from interface: IRuntimeClasspathEntry

Returns a memento for this classpath entry.

Since 3.0, the memento for a contributed classpath entry (i.e. of type OTHER), must be in the form of an XML document, with the following element structure:

 <runtimeClasspathEntry id="exampleId">
    <memento
       key1="value1"
                 ...>
    </memento>
 </runtimeClasspathEntry>
 

The id attribute is the unique identifier of the extension that contributed this runtime classpath entry type, via the extension point org.eclipse.jdt.launching.runtimeClasspathEntries. The memento element will be used to initialize a restored runtime classpath entry, via the method IRuntimeClasspathEntry2.initializeFrom(Element memento). The attributes of the memento element are client defined.

Specified by:

getMemento in interface IRuntimeClasspathEntry

Returns:

a memento for this classpath entry

Throws:

CoreException - if an exception occurs generating a memento

See Also:

IRuntimeClasspathEntry.getMemento()

getPath

public IPath getPath()

Description copied from interface: IRuntimeClasspathEntry

Returns the path associated with this entry, or null if none. The format of the path returned depends on this entry's type:

• PROJECT - a workspace relative path to the associated project.
• ARCHIVE - the absolute path of the associated archive, which may or may not be in the workspace.
• VARIABLE - the path corresponding to the associated classpath variable entry.
• CONTAINER - the path corresponding to the associated classpath container variable entry.
• OTHER - the path returned is client defined.

Since 3.0, this method may return null.

Specified by:

getPath in interface IRuntimeClasspathEntry

Returns:

the path associated with this entry, or null

See Also:

IRuntimeClasspathEntry.getPath()

getResource

public IResource getResource()

Description copied from interface: IRuntimeClasspathEntry

Returns the resource associated with this entry, or null if none. A project, archive, or folder entry may be associated with a resource.

Specified by:

getResource in interface IRuntimeClasspathEntry

Returns:

the resource associated with this entry, or null

See Also:

IRuntimeClasspathEntry.getResource()

getResource

protected IResource getResource(IPath path)

Returns the resource in the workspace associated with the given absolute path, or null if none. The path may have a device.

Parameters:

path - absolute path, or null

Returns:

resource or null

getSourceAttachmentPath

public IPath getSourceAttachmentPath()

Description copied from interface: IRuntimeClasspathEntry

Returns the path to the source archive associated with this entry, or null if this classpath entry has no source attachment.

Only archive and variable entries may have source attachments. For archive entries, the path (if present) locates a source archive. For variable entries, the path (if present) has an analogous form and meaning as the variable path, namely the first segment is the name of a classpath variable.

Specified by:

getSourceAttachmentPath in interface IRuntimeClasspathEntry

Returns:

the path to the source archive, or null if none

See Also:

IRuntimeClasspathEntry.getSourceAttachmentPath()

setSourceAttachmentPath

public void setSourceAttachmentPath(IPath path)

Description copied from interface: IRuntimeClasspathEntry

Sets the path to the source archive associated with this entry, or null if this classpath entry has no source attachment.

Only archive and variable entries may have source attachments. For archive entries, the path refers to a source archive. For variable entries, the path has an analogous form and meaning as the variable path, namely the first segment is the name of a classpath variable.

Note that an empty path (Path.EMPTY) is considered null.

Specified by:

setSourceAttachmentPath in interface IRuntimeClasspathEntry

Parameters:

path - the path to the source archive, or null if none

See Also:

IRuntimeClasspathEntry.setSourceAttachmentPath(IPath)

getExternalAnnotationsPath

public IPath getExternalAnnotationsPath()

Description copied from interface: IRuntimeClasspathEntry

Returns the path to the external annotations file or directory, or null if no external annotations are associated with this classpath entry.

Specified by:

getExternalAnnotationsPath in interface IRuntimeClasspathEntry

Returns:

The path to the external annotations file or directory, or null if not present.

setExternalAnnotationsPath

public void setExternalAnnotationsPath(IPath path)

Description copied from interface: IRuntimeClasspathEntry

Sets the path to the external annotations file or directory. It should be set to null if no annotations are associated with this entry.

Specified by:

setExternalAnnotationsPath in interface IRuntimeClasspathEntry

Parameters:

path - The file or directory holding external annotations.

getSourceAttachmentRootPath

public IPath getSourceAttachmentRootPath()

Description copied from interface: IRuntimeClasspathEntry

Returns the path within the source archive where package fragments are located. An empty path indicates that packages are located at the root of the source archive. Returns a non-null value if and only if getSourceAttachmentPath returns a non-null value.

Specified by:

getSourceAttachmentRootPath in interface IRuntimeClasspathEntry

Returns:

root path within the source archive, or null if not applicable

See Also:

IRuntimeClasspathEntry.getSourceAttachmentRootPath()

setSourceAttachmentRootPath

public void setSourceAttachmentRootPath(IPath path)

Description copied from interface: IRuntimeClasspathEntry

Sets the path within the source archive where package fragments are located. A root path indicates that packages are located at the root of the source archive. Only valid if a source attachment path is also specified.

Note that an empty path (Path.EMPTY) is considered null.

Specified by:

setSourceAttachmentRootPath in interface IRuntimeClasspathEntry

Parameters:

path - root path within the source archive, or null

setClasspathProperty

public void setClasspathProperty(int location)

Description copied from interface: IRuntimeClasspathEntry

Sets whether this entry should appear on the bootstrap classpath, the user classpath, or whether this entry is a standard bootstrap entry that does not need to appear on the classpath. The location is one of:

• STANDARD_CLASSES - a standard entry does not need to appear on the runtime classpath
• BOOTSTRAP_CLASSES - a bootstrap entry should appear on the boot path
• USER_CLASSES - a user entry should appear on the path conatining user or application classes

Specified by:

setClasspathProperty in interface IRuntimeClasspathEntry

Parameters:

location - a classpat property constant

See Also:

IRuntimeClasspathEntry.setClasspathProperty(int)

getClasspathProperty

public int getClasspathProperty()

Description copied from interface: IRuntimeClasspathEntry

Returns a constant indicating where this entry should appear on the runtime classpath by default. The value returned is one of the following:

• STANDARD_CLASSES - a standard entry does not need to appear on the runtime classpath
• BOOTSTRAP_CLASSES - a bootstrap entry should appear on the boot path
• USER_CLASSES - a user entry should appear on the path containing user or application classes

Specified by:

getClasspathProperty in interface IRuntimeClasspathEntry

Returns:

where this entry should appear on the runtime classpath

getLocation

public java.lang.String getLocation()

Description copied from interface: IRuntimeClasspathEntry

Returns an absolute path in the local file system for this entry, or null if none, or if this entry is of type CONTAINER.

Specified by:

getLocation in interface IRuntimeClasspathEntry

Returns:

an absolute path in the local file system for this entry, or null if none

See Also:

IRuntimeClasspathEntry.getLocation()

resolveToOSPath

protected java.lang.String resolveToOSPath(IPath path)

Returns the OS path for the given absolute or workspace relative path

Parameters:

path - the path

Returns:

the OS path

getVariableName

public java.lang.String getVariableName()

Description copied from interface: IRuntimeClasspathEntry

Returns the first segment of the path associated with this entry, or null if this entry is not of type VARIABLE or CONTAINER.

Specified by:

getVariableName in interface IRuntimeClasspathEntry

Returns:

the first segment of the path associated with this entry, or null if this entry is not of type VARIABLE or CONTAINER

See Also:

IRuntimeClasspathEntry.getVariableName()

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

See Also:

Object.equals(Object)

equal

protected boolean equal(java.lang.Object one,
                        java.lang.Object two)

Returns whether the given objects are equal, accounting for null

Parameters:

one - the object to compare

two - the object to compare to

Returns:

the equality of the objects

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

See Also:

Object.hashCode()

getSourceAttachmentLocation

public java.lang.String getSourceAttachmentLocation()

Description copied from interface: IRuntimeClasspathEntry

Returns an absolute path in the local file system for the source attachment associated with this entry entry, or null if none.

Specified by:

getSourceAttachmentLocation in interface IRuntimeClasspathEntry

Returns:

an absolute path in the local file system for the source attachment associated with this entry entry, or null if none

See Also:

IRuntimeClasspathEntry.getSourceAttachmentLocation()

getSourceAttachmentRootLocation

public java.lang.String getSourceAttachmentRootLocation()

Description copied from interface: IRuntimeClasspathEntry

Returns a path relative to this entry's source attachment path for the root location containing source, or null if none.

Specified by:

getSourceAttachmentRootLocation in interface IRuntimeClasspathEntry

Returns:

a path relative to this entry's source attachment path for the root location containing source, or null if none

See Also:

IRuntimeClasspathEntry.getSourceAttachmentRootLocation()

updateClasspathEntry

protected void updateClasspathEntry(IPath path,
                                    IPath sourcePath,
                                    IPath rootPath,
                                    IPath annotationsPath)

Creates a new underlying classpath entry for this runtime classpath entry with the given paths, due to a change in source attachment.

Parameters:

path - the path

sourcePath - the source path

rootPath - the root path

getResolvedClasspathEntry

protected IClasspathEntry getResolvedClasspathEntry()

Returns the resolved classpath entry associated with this runtime entry, resolving if required.

Returns:

the resolved IClasspathEntry

isEmpty

protected boolean isEmpty(java.lang.String string)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getJavaProject

public IJavaProject getJavaProject()

Description copied from interface: IRuntimeClasspathEntry

Returns the Java project associated with this runtime classpath entry or null if none. Runtime classpath entries of type CONTAINER may be associated with a project for the purposes of resolving the entries in a container.

Specified by:

getJavaProject in interface IRuntimeClasspathEntry

Returns:

the Java project associated with this runtime classpath entry or null if none

setJavaProject

public void setJavaProject(IJavaProject project)

Sets the Java project associated with this classpath entry.

Parameters:

project - Java project

isAutomodule

public boolean isAutomodule()

Description copied from interface: IRuntimeClasspathEntry

Returns true if the java project associated is an AutoModule.

Specified by:

isAutomodule in interface IRuntimeClasspathEntry

Returns:

true if the Java project associated is an AutoModule or false if not