ClasspathEntry

One entry of the classpath.

A ClasspathEntry must have a meaningful equals and hashCode, which must reflect the identity of the entry (not necessarily the reference identity). Its equality is notably used by Contexts.Context.findSymbolsByClasspathEntry.

Users of a ClasspathEntry and its components may consider them to be idempotent.

All the methods of ClasspathEntry and its components may throw java.io.IOExceptions to indicate I/O errors.

A ClasspathEntry is encouraged to be thread-safe, along with all its components, but it is not a strong requirement. Implementations that are thread-safe should be documented as such. Contexts.Contexts created only from thread-safe ClasspathEntrys are thread-safe themselves.

Implementations of this class are encouraged to define a toString() method that helps identifying the entry for debugging purposes.