public final class PreferredResources
Internal data structure which holds preference information for a
preferred class loader. This utility is used only by the preferred
class loader provider and is not intended to be a public API.
A preferred resources object is created from an input stream which
is formatted according to the Preferred List Syntax which is
defined in the specification for
Preferred resources instances hold preferred list expression data
and the preferred state for the resources contained in a given
preferred class loader.
Constant value that indicates that the resource for a given
name is known to be not preferred. This state is applicable
when a preference expression declared that the name is not
preferred or when the resource for the name (preferred or not)
is known to not exist.
Constant value that indicates that a given name is preferred.
This state is applicable when a preference expression declares
the name to be preferred but it is uncertain whether the
resource for the name the exists.
public static final int NAME_PREFERRED_RESOURCE_EXISTS
Constant value that indicates that a given resource is
preferred. This state is applicable when a preference
expression declares the name to be preferred and the resource
for the name is known to exist.
Write the preferences to the specified OutputStream using the
preference list syntax. Preference expressions are written in
the following order:
Complete name expressions
out - the stream to which formatted preference information
will be written
IOException - if an error occurs while writing to the stream
Returns the preference setting that will be applied to names
which have no explicit preference setting in contained
preference settings. The default preference is set by the
first preference setting with no associated name in a
preferences list file.
default boolean preference value for these preferences
Enable MarshalInputStream to optimize preference information:
permits complete name expressions to be added for names that
only match wild-card expressions. These added expressions hold
data that tells if a resource has been loaded.
This method makes this object mutable. Synchronization must be
used to ensure consistent preference state when this method is
name - the name for which preferred state will be set
prefState - the preferred state for the given name
Searches the preference maps to determine the preference state
of the named resource. The preference state for the given
resource name is returned. The preference state is an integer
that is equal to one of the preference state values defined
above. This state integer tells the preference value of name
and whether its resource is known to exist.
isClass - whether the given name refers to a
the state for the given name which will be set to one
of the following values: NAME_NO_PREFERENCE,
IOException - if an error occurs getting the state for
the supplied name