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
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 net.jini.loader.pref.PreferredClassProvider
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 called.
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 class resource
the state for the given name which will be set to one of the following values:
NAME_NO_PREFERENCE, NAME_NOT_PREFERRED, NAME_PREFERRED, NAME_PREFERRED_RESOURCE_EXISTS
IOException - if an error occurs getting the state for the supplied name