You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by si...@apache.org on 2010/12/24 22:12:53 UTC
svn commit: r1052649 [1/3] - in
/incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref: ./
class-use/
Author: sijskes
Date: Fri Dec 24 21:12:52 2010
New Revision: 1052649
URL: http://svn.apache.org/viewvc?rev=1052649&view=rev
Log:
doc integration
Added:
incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/PreferredClassLoader.html
incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/PreferredClassProvider.html
incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/RequireDlPermProvider.html
incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/class-use/
incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/package-frame.html
incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/package-summary.html
incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/package-tree.html
incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/package-use.html
Added: incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/PreferredClassLoader.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/PreferredClassLoader.html?rev=1052649&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/PreferredClassLoader.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/loader/pref/PreferredClassLoader.html Fri Dec 24 21:12:52 2010
@@ -0,0 +1,913 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:22 EST 2010 -->
+<TITLE>
+PreferredClassLoader (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.loader.pref.PreferredClassLoader class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="PreferredClassLoader (Apache River v2.1.2-SNAPSHOT API Documentation)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/PreferredClassLoader.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV CLASS
+ <A HREF="../../../../net/jini/loader/pref/PreferredClassProvider.html" title="class in net.jini.loader.pref"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/loader/pref/PreferredClassLoader.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="PreferredClassLoader.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+net.jini.loader.pref</FONT>
+<BR>
+Class PreferredClassLoader</H2>
+<PRE>
+<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">java.lang.ClassLoader</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/SecureClassLoader.html" title="class or interface in java.security">java.security.SecureClassLoader</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html" title="class or interface in java.net">java.net.URLClassLoader</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>net.jini.loader.pref.PreferredClassLoader</B>
+</PRE>
+<DL>
+<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../net/jini/loader/ClassAnnotation.html" title="interface in net.jini.loader">ClassAnnotation</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public class <B>PreferredClassLoader</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html" title="class or interface in java.net">URLClassLoader</A><DT>implements <A HREF="../../../../net/jini/loader/ClassAnnotation.html" title="interface in net.jini.loader">ClassAnnotation</A></DL>
+</PRE>
+
+<P>
+A class loader that supports preferred classes.
+
+ <p>A preferred class is a class that is to be loaded by a class
+ loader without the loader delegating to its parent class loader
+ first. Resources may also be preferred.
+
+ <p>Like <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html" title="class or interface in java.net"><CODE>URLClassLoader</CODE></A>,
+ <code>PreferredClassLoader</code> loads classes and resources from
+ a search path of URLs. If a URL in the path ends with a
+ <code>'/'</code>, it is assumed to refer to a directory; otherwise,
+ the URL is assumed to refer to a JAR file.
+
+ <p>The location of the first URL in the path can contain a
+ <i>preferred list</i> for the entire path. A preferred list
+ declares names of certain classes and other resources throughout
+ the path as being <i>preferred</i> or not. When a
+ <code>PreferredClassLoader</code> is asked to load a class or
+ resource that is preferred (according to the preferred list) and
+ the class or resource exists in the loader's path of URLs, the
+ loader will not delegate first to its parent class loader as it
+ otherwise would do; instead, it will attempt to load the class or
+ resource from its own path of URLs only.
+
+ <p>The preferred list for a path of URLs, if one exists, is located
+ relative to the first URL in the path. If the first URL refers to
+ a JAR file, then the preferred list is the contents of the file
+ named <code>"META-INF/PREFERRED.LIST"</code> within that JAR file.
+ If the first URL refers to a directory, then the preferred list is
+ the contents of the file at the location
+ <code>"META-INF/PREFERRED.LIST"</code> relative to that directory
+ URL. If there is no preferred list at the required location, then
+ no classes or resources are preferred for the path of URLs. A
+ preferred list at any other location (such as relative to one of
+ the other URLs in the path) is ignored.
+
+ <p>Note that a class or resource is only considered to be preferred
+ if the preferred list declares the name of the class or resource as
+ being preferred and the class or resource actually exists in the
+ path of URLs.
+
+ <h3>Preferred List Syntax</h3>
+
+ A preferred list is a UTF-8 encoded text file, with lines separated
+ by CR LF, LF, or CR (not followed by an LF). Multiple
+ whitespace characters in a line are equivalent to a single
+ whitespace character, and whitespace characters at the beginning or
+ end of a line are ignored. If the first non-whitespace character
+ of a line is <code>'#'</code>, the line is a comment and is
+ equivalent to a blank line.
+
+ <p>The first line of a preferred list must contain a version
+ number in the following format:
+
+ <pre>
+ PreferredResources-Version: 1.<i>x</i>
+ </pre>
+
+ This specification defines only version 1.0, but
+ <code>PreferredClassLoader</code> will parse any version
+ 1.<i>x</i>, <i>x</i>>=0 with the format and semantics specified
+ here.
+
+ <p>After the version number line, a preferred list comprises an
+ optional default preferred entry followed by zero or more named
+ preferred entries. A preferred list must contain either a default
+ preferred entry or at least one named preferred entry. Blank lines
+ are allowed before and after preferred entries, as well as between
+ the lines of a named preferred entry.
+
+ <p>A default preferred entry is a single line in the following
+ format:
+
+ <pre>
+ Preferred: <i>preferred-setting</i>
+ </pre>
+
+ where <i>preferred-setting</i> is a non-empty sequence of
+ characters. If <i>preferred-setting</i> equals <code>"true"</code>
+ (case insensitive), then resource names not matched by any of the
+ named preferred entries are by default preferred; otherwise,
+ resource names not matched by any of the named preferred entries
+ are by default not preferred. If there is no default preferred
+ entry, then resource names are by default not preferred.
+
+ <p>A named preferred entry is two lines in the following format:
+
+ <pre>
+ Name: <i>name-expression</i>
+ Preferred: <i>preferred-setting</i>
+ </pre>
+
+ where <i>name-expression</i> and <i>preferred-setting</i> are
+ non-empty sequences of characters. If <i>preferred-setting</i>
+ equals <code>"true"</code> (case insensitive), then resource names
+ that are matched by <i>name-expression</i> (and not any more
+ specific named preferred entries) are preferred; otherwise,
+ resource names that are matched by <i>name-expression</i> (and not
+ any more specific named preferred entries) are not preferred.
+
+ <p>If <i>name-expression</i> ends with <code>".class"</code>, it
+ matches a class whose binary name is <i>name-expression</i> without
+ the <code>".class"</code> suffix and with each <code>'/'</code>
+ character replaced with a <code>'.'</code>. It also matches any
+ class whose binary name starts with that same value followed by a
+ <code>'$'</code>; this rule is intended to match nested classes
+ that have an enclosing class of that name, so that the preferred
+ settings of a class and all of its nested classes are the same by
+ default. It is possible, but strongly discouraged, to override the
+ preferred setting of a nested class with a named preferred entry
+ that explicitly matches the nested class's binary name.
+
+ <p><i>name-expression</i> may match arbitrary resource names as
+ well as class names, with path elements separated by
+ <code>'/'</code> characters.
+
+ <p>If <i>name-expression</i> ends with <code>"/"</code> or
+ <code>"/*"</code>, then the entry is a directory wildcard entry
+ that matches all resources (including classes) in the named
+ directory. If <i>name-expression</i> ends with <code>"/-"</code>,
+ then the entry is a namespace wildcard entry that matches all
+ resources (including classes) in the named directory and all of its
+ subdirectories.
+
+ <p>When more than one named preferred entry matches a class or
+ resource name, then the most specific entry takes precedence. A
+ non-wildcard entry is more specific than a wildcard entry. A
+ directory wildcard entry is more specific than a namespace wildcard
+ entry. A namespace wildcard entry with more path elements is more
+ specific than a namespace wildcard entry with fewer path elements.
+ Given two non-wildcard entries, the entry with the longer
+ <i>name-expression</i> is more specific (this rule is only
+ significant when matching a class). The order of named preferred
+ entries is insignificant.
+
+ <h3>Example Preferred List</h3>
+
+ <p>Following is an example preferred list:
+
+ <pre>
+ PreferredResources-Version: 1.0
+ Preferred: false
+
+ Name: com/foo/FooBar.class
+ Preferred: true
+
+ Name: com/foo/*
+ Preferred: false
+
+ Name: com/foo/-
+ Preferred: true
+
+ Name: image-files/*
+ Preferred: mumble
+ </pre>
+
+ <p>The class <code>com.foo.FooBar</code> is preferred, as well as
+ any nested classes that have it as an enclosing class. All other
+ classes in the <code>com.foo</code> package are not preferred
+ because of the directory wildcard entry. Classes in subpackages of
+ <code>com.foo</code> are preferred because of the namespace
+ wildcard entry. Resources in the directory <code>"com/foo/"</code>
+ are not preferred, and resources in subdirectories of
+ <code>"com/foo/"</code> are preferred. Resources in the directory
+ <code>"image-files/"</code> are not preferred because preferred
+ settings other than <code>"true"</code> are interpreted as false.
+ Classes that are in a package named <code>com.bar</code> are not
+ preferred because of the default preferred entry.
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>2.0</DD>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+</DL>
+<HR>
+
+<P>
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+<A NAME="constructor_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Constructor Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#PreferredClassLoader(java.net.URL[], java.lang.ClassLoader, java.lang.String, boolean)">PreferredClassLoader</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URL.html" title="class or interface in java.net">URL</A>[] urls,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">ClassLoader</A> parent,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportAnnotation,
+ boolean requireDlPerm)</CODE>
+
+<BR>
+ Creates a new <code>PreferredClassLoader</code> that loads
+ classes and resources from the specified path of URLs and
+ delegates to the specified parent class loader.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#PreferredClassLoader(java.net.URL[], java.lang.ClassLoader, java.lang.String, boolean, java.net.URLStreamHandlerFactory)">PreferredClassLoader</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URL.html" title="class or interface in java.net">URL</A>[] urls,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">ClassLoader</A> parent,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportAnnotation,
+ boolean requireDlPerm,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLStreamHandlerFactory.html" title="class or interface in java.net">URLStreamHandlerFactory</A> factory)</CODE>
+
+<BR>
+ Creates a new <code>PreferredClassLoader</code> that loads
+ classes and resources from the specified path of URLs,
+ delegates to the specified parent class loader, and uses the
+ specified <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLStreamHandlerFactory.html" title="class or interface in java.net"><CODE>URLStreamHandlerFactory</CODE></A> when creating new URL
+ objects.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Package.html" title="class or interface in java.lang">Package</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#definePackage(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.net.URL)">definePackage</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> name,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> specTitle,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> specVersion,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> specVendor,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implTitle,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implVersion,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implVendor,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URL.html" title="class or interface in java.net">URL</A> sealBase)</CODE>
+
+<BR>
+ </TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#getClassAnnotation()">getClassAnnotation</A></B>()</CODE>
+
+<BR>
+ Returns the class annotation string for classes defined by this
+ class loader.
+
+ <code>PreferredClassLoader</code> implements this method as
+ follows:
+
+ If this <code>PreferredClassLoader</code> was constructed
+ with a non-<code>null</code> export class annotation string,
+ then this method returns that string.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/PermissionCollection.html" title="class or interface in java.security">PermissionCollection</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#getPermissions(java.security.CodeSource)">getPermissions</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/CodeSource.html" title="class or interface in java.security">CodeSource</A> codeSource)</CODE>
+
+<BR>
+ Returns the static permissions to be automatically granted to
+ classes loaded from the specified <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/CodeSource.html" title="class or interface in java.security"><CODE>CodeSource</CODE></A> and
+ defined by this class loader.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URL.html" title="class or interface in java.net">URL</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#getResource(java.lang.String)">getResource</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> name)</CODE>
+
+<BR>
+ Gets a resource with the specified name.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#isPreferredResource(java.lang.String, boolean)">isPreferredResource</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> name,
+ boolean isClass)</CODE>
+
+<BR>
+ Returns <code>true</code> if a class or resource with the
+ specified name is preferred for this class loader, and
+ <code>false</code> if a class or resource with the specified
+ name is not preferred for this loader.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Class.html" title="class or interface in java.lang">Class</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#loadClass(java.lang.String, boolean)">loadClass</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> name,
+ boolean resolve)</CODE>
+
+<BR>
+ Loads a class with the specified name.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html" title="class in net.jini.loader.pref">PreferredClassLoader</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#newInstance(java.net.URL[], java.lang.ClassLoader, java.lang.String, boolean)">newInstance</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URL.html" title="class or interface in java.net">URL</A>[] urls,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">ClassLoader</A> parent,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportAnnotation,
+ boolean requireDlPerm)</CODE>
+
+<BR>
+ Creates a new instance of <code>PreferredClassLoader</code>
+ that loads classes and resources from the specified path of
+ URLs and delegates to the specified parent class loader.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#toString()">toString</A></B>()</CODE>
+
+<BR>
+ Returns a string representation of this class loader.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.net.URLClassLoader"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.net.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html" title="class or interface in java.net">URLClassLoader</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#addURL(java.net.URL)" title="class or interface in java.net">addURL</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#definePackage(java.lang.String, java.util.jar.Manifest, java.net.URL)" title="class or interface in java.net">definePackage</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#findClass(java.lang.String)" title="class or interface in java.net">findClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#findResource(java.lang.String)" title="class or interface in java.net">findResource</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#findResources(java.lang.String)" title="class or interface in java.net">findResources</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#getURLs()" title="class or interface in java.n
et">getURLs</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#newInstance(java.net.URL[])" title="class or interface in java.net">newInstance</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#newInstance(java.net.URL[], java.lang.ClassLoader)" title="class or interface in java.net">newInstance</A></CODE></TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.security.SecureClassLoader"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.security.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/SecureClassLoader.html" title="class or interface in java.security">SecureClassLoader</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/SecureClassLoader.html#defineClass(java.lang.String, byte[], int, int, java.security.CodeSource)" title="class or interface in java.security">defineClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/SecureClassLoader.html#defineClass(java.lang.String, java.nio.ByteBuffer, java.security.CodeSource)" title="class or interface in java.security">defineClass</A></CODE></TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.ClassLoader"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">ClassLoader</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#clearAssertionStatus()" title="class or interface in java.lang">clearAssertionStatus</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#defineClass(byte[], int, int)" title="class or interface in java.lang">defineClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#defineClass(java.lang.String, byte[], int, int)" title="class or interface in java.lang">defineClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#defineClass(java.lang.String, byte[], int, int, java.security.ProtectionDomain)" title="class or interface in java.lang">defineClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#defineClass(java.lang.String, java.nio.ByteBuffer, java.security.ProtectionDomain)" title="class or interface in java.lang">defineClass</A>, <A HREF="http://java.sun.com/j2se/1.
4.2/docs/api/java/lang/ClassLoader.html#findLibrary(java.lang.String)" title="class or interface in java.lang">findLibrary</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#findLoadedClass(java.lang.String)" title="class or interface in java.lang">findLoadedClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#findSystemClass(java.lang.String)" title="class or interface in java.lang">findSystemClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#getPackage(java.lang.String)" title="class or interface in java.lang">getPackage</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#getPackages()" title="class or interface in java.lang">getPackages</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#getParent()" title="class or interface in java.lang">getParent</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Clas
sLoader.html#getResourceAsStream(java.lang.String)" title="class or interface in java.lang">getResourceAsStream</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#getResources(java.lang.String)" title="class or interface in java.lang">getResources</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#getSystemClassLoader()" title="class or interface in java.lang">getSystemClassLoader</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#getSystemResource(java.lang.String)" title="class or interface in java.lang">getSystemResource</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#getSystemResourceAsStream(java.lang.String)" title="class or interface in java.lang">getSystemResourceAsStream</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#getSystemResources(java.lang.String)" title="class or interface in java.lang">getSystemResources
</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#loadClass(java.lang.String)" title="class or interface in java.lang">loadClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#resolveClass(java.lang.Class)" title="class or interface in java.lang">resolveClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#setClassAssertionStatus(java.lang.String, boolean)" title="class or interface in java.lang">setClassAssertionStatus</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#setDefaultAssertionStatus(boolean)" title="class or interface in java.lang">setDefaultAssertionStatus</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#setPackageAssertionStatus(java.lang.String, boolean)" title="class or interface in java.lang">setPackageAssertionStatus</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#s
etSigners(java.lang.Class, java.lang.Object[])" title="class or interface in java.lang">setSigners</A></CODE></TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://
java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+<A NAME="constructor_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Constructor Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="PreferredClassLoader(java.net.URL[], java.lang.ClassLoader, java.lang.String, boolean)"><!-- --></A><H3>
+PreferredClassLoader</H3>
+<PRE>
+public <B>PreferredClassLoader</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URL.html" title="class or interface in java.net">URL</A>[] urls,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">ClassLoader</A> parent,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportAnnotation,
+ boolean requireDlPerm)</PRE>
+<DL>
+<DD>Creates a new <code>PreferredClassLoader</code> that loads
+ classes and resources from the specified path of URLs and
+ delegates to the specified parent class loader.
+
+ <p>If <code>exportAnnotation</code> is not <code>null</code>,
+ then it will be used as the return value of the loader's <A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#getClassAnnotation()"><CODE>getClassAnnotation</CODE></A> method. If
+ <code>exportAnnotation</code> is <code>null</code>, the
+ loader's <code>getClassAnnotation</code> method will return a
+ space-separated list of the URLs in the specified path. The
+ <code>exportAnnotation</code> parameter can be used to specify
+ so-called "export" URLs, from which other parties should load
+ classes defined by the loader and which are different from the
+ "import" URLs that the classes are actually loaded from.
+
+ <p>If <code>requireDlPerm</code> is <code>true</code>, the
+ loader's <A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#getPermissions(java.security.CodeSource)"><CODE>getPermissions</CODE></A> method will
+ require that the <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/CodeSource.html" title="class or interface in java.security"><CODE>CodeSource</CODE></A> of any class defined by the
+ loader is granted <A HREF="../../../../net/jini/loader/DownloadPermission.html" title="class in net.jini.loader"><CODE>DownloadPermission</CODE></A>.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>urls</CODE> - the path of URLs to load classes and resources from<DD><CODE>parent</CODE> - the parent class loader for delegation<DD><CODE>exportAnnotation</CODE> - the export class annotation string to
+ use for classes defined by this loader, or <code>null</code><DD><CODE>requireDlPerm</CODE> - if <code>true</code>, the loader will only
+ define classes with a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/CodeSource.html" title="class or interface in java.security"><CODE>CodeSource</CODE></A> that is granted <A HREF="../../../../net/jini/loader/DownloadPermission.html" title="class in net.jini.loader"><CODE>DownloadPermission</CODE></A>
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if there is a security manager and an
+ invocation of its <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityManager.html#checkCreateClassLoader()" title="class or interface in java.lang"><CODE>checkCreateClassLoader</CODE></A> method fails</DL>
+</DL>
+<HR>
+
+<A NAME="PreferredClassLoader(java.net.URL[], java.lang.ClassLoader, java.lang.String, boolean, java.net.URLStreamHandlerFactory)"><!-- --></A><H3>
+PreferredClassLoader</H3>
+<PRE>
+public <B>PreferredClassLoader</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URL.html" title="class or interface in java.net">URL</A>[] urls,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">ClassLoader</A> parent,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportAnnotation,
+ boolean requireDlPerm,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLStreamHandlerFactory.html" title="class or interface in java.net">URLStreamHandlerFactory</A> factory)</PRE>
+<DL>
+<DD>Creates a new <code>PreferredClassLoader</code> that loads
+ classes and resources from the specified path of URLs,
+ delegates to the specified parent class loader, and uses the
+ specified <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLStreamHandlerFactory.html" title="class or interface in java.net"><CODE>URLStreamHandlerFactory</CODE></A> when creating new URL
+ objects. This constructor passes <code>factory</code> to the
+ superclass constructor that has a
+ <code>URLStreamHandlerFactory</code> parameter.
+
+ <p>If <code>exportAnnotation</code> is not <code>null</code>,
+ then it will be used as the return value of the loader's <A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#getClassAnnotation()"><CODE>getClassAnnotation</CODE></A> method. If
+ <code>exportAnnotation</code> is <code>null</code>, the
+ loader's <code>getClassAnnotation</code> method will return a
+ space-separated list of the URLs in the specified path. The
+ <code>exportAnnotation</code> parameter can be used to specify
+ so-called "export" URLs, from which other parties should load
+ classes defined by the loader and which are different from the
+ "import" URLs that the classes are actually loaded from.
+
+ <p>If <code>requireDlPerm</code> is <code>true</code>, the
+ loader's <A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#getPermissions(java.security.CodeSource)"><CODE>getPermissions</CODE></A> method will
+ require that the <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/CodeSource.html" title="class or interface in java.security"><CODE>CodeSource</CODE></A> of any class defined by the
+ loader is granted <A HREF="../../../../net/jini/loader/DownloadPermission.html" title="class in net.jini.loader"><CODE>DownloadPermission</CODE></A>.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>urls</CODE> - the path of URLs to load classes and resources from<DD><CODE>parent</CODE> - the parent class loader for delegation<DD><CODE>exportAnnotation</CODE> - the export class annotation string to
+ use for classes defined by this loader, or <code>null</code><DD><CODE>requireDlPerm</CODE> - if <code>true</code>, the loader will only
+ define classes with a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/CodeSource.html" title="class or interface in java.security"><CODE>CodeSource</CODE></A> that is granted <A HREF="../../../../net/jini/loader/DownloadPermission.html" title="class in net.jini.loader"><CODE>DownloadPermission</CODE></A><DD><CODE>factory</CODE> - the <code>URLStreamHandlerFactory</code> to use
+ when creating new URL objects, or <code>null</code>
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if there is a security manager and an
+ invocation of its <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityManager.html#checkCreateClassLoader()" title="class or interface in java.lang"><CODE>checkCreateClassLoader</CODE></A> method fails<DT><B>Since:</B></DT>
+ <DD>2.1</DD>
+</DL>
+</DL>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="newInstance(java.net.URL[], java.lang.ClassLoader, java.lang.String, boolean)"><!-- --></A><H3>
+newInstance</H3>
+<PRE>
+public static <A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html" title="class in net.jini.loader.pref">PreferredClassLoader</A> <B>newInstance</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URL.html" title="class or interface in java.net">URL</A>[] urls,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">ClassLoader</A> parent,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportAnnotation,
+ boolean requireDlPerm)</PRE>
+<DL>
+<DD>Creates a new instance of <code>PreferredClassLoader</code>
+ that loads classes and resources from the specified path of
+ URLs and delegates to the specified parent class loader.
+
+ <p>The <code>exportAnnotation</code> and
+ <code>requireDlPerm</code> parameters have the same semantics
+ as they do for the constructors.
+
+ <p>The <A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#loadClass(java.lang.String, boolean)"><CODE>loadClass</CODE></A> method of the returned
+ <code>PreferredClassLoader</code> will, if there is a security
+ manager, invoke its <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityManager.html#checkPackageAccess(java.lang.String)" title="class or interface in java.lang"><CODE>checkPackageAccess</CODE></A> method with the package name of the class
+ to load before attempting to load the class; this could result
+ in a <code>SecurityException</code> being thrown from
+ <code>loadClass</code>.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>urls</CODE> - the path of URLs to load classes and resources from<DD><CODE>parent</CODE> - the parent class loader for delegation<DD><CODE>exportAnnotation</CODE> - the export class annotation string to
+ use for classes defined by this loader, or <code>null</code><DD><CODE>requireDlPerm</CODE> - if <code>true</code>, the loader will only
+ define classes with a <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/CodeSource.html" title="class or interface in java.security"><CODE>CodeSource</CODE></A> that is granted <A HREF="../../../../net/jini/loader/DownloadPermission.html" title="class in net.jini.loader"><CODE>DownloadPermission</CODE></A>
+<DT><B>Returns:</B><DD>the new <code>PreferredClassLoader</code> instance
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if the current security context does
+ not have the permissions necessary to connect to all of the
+ URLs in <code>urls</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="isPreferredResource(java.lang.String, boolean)"><!-- --></A><H3>
+isPreferredResource</H3>
+<PRE>
+protected boolean <B>isPreferredResource</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> name,
+ boolean isClass)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
+<DL>
+<DD>Returns <code>true</code> if a class or resource with the
+ specified name is preferred for this class loader, and
+ <code>false</code> if a class or resource with the specified
+ name is not preferred for this loader.
+
+ <p>If <code>isClass</code> is <code>true</code>, then
+ <code>name</code> is interpreted as the binary name of a class;
+ otherwise, <code>name</code> is interpreted as the full path of
+ a resource.
+
+ <p>This method only returns <code>true</code> if a class or
+ resource with the specified name exists in the this loader's
+ path of URLs and the name is preferred in the preferred list.
+ This method returns <code>false</code> if the name is not
+ preferred in the preferred list or if the name is preferred
+ with the default preferred entry or a wildcard preferred entry
+ and the class or resource does not exist in the path of URLs.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the class or resource<DD><CODE>isClass</CODE> - <code>true</code> if <code>name</code> is a
+ binary class name, and <code>false</code> if <code>name</code>
+ is the full path of a resource
+<DT><B>Returns:</B><DD><code>true</code> if a class or resource named
+ <code>name</code> is preferred for this loader, and
+ <code>false</code> if a class or resource named
+ <code>name</code> is not preferred for this loader
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - if the preferred list cannot definitely be
+ determined to exist or not exist, or if the preferred list
+ contains a syntax error, or if the name is preferred with the
+ default preferred entry or a wildcard preferred entry and the
+ class or resource cannot definitely be determined to exist or
+ not exist in the path of URLs, or if the name is preferred with
+ a non-wildcard entry and the class or resource does not exist
+ or cannot definitely be determined to exist in the path of URLs</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="loadClass(java.lang.String, boolean)"><!-- --></A><H3>
+loadClass</H3>
+<PRE>
+protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Class.html" title="class or interface in java.lang">Class</A> <B>loadClass</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> name,
+ boolean resolve)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassNotFoundException.html" title="class or interface in java.lang">ClassNotFoundException</A></PRE>
+<DL>
+<DD>Loads a class with the specified name.
+
+ <p><code>PreferredClassLoader</code> implements this method as
+ follows:
+
+ <p>This method first invokes <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#findLoadedClass(java.lang.String)" title="class or interface in java.lang"><CODE>findLoadedClass</CODE></A> with <code>name</code>; if
+ <code>findLoadedClass</code> returns a non-<code>null</code>
+ <code>Class</code>, then this method returns that
+ <code>Class</code>.
+
+ <p>Otherwise, this method invokes <A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#isPreferredResource(java.lang.String, boolean)"><CODE>isPreferredResource</CODE></A> with <code>name</code> as the first
+ argument and <code>true</code> as the second argument:
+
+ <ul>
+
+ <li>If <code>isPreferredResource</code> throws an
+ <code>IOException</code>, then this method throws a
+ <code>ClassNotFoundException</code> containing the
+ <code>IOException</code> as its cause.
+
+ <li>If <code>isPreferredResource</code> returns
+ <code>true</code>, then this method invokes <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#findClass(java.lang.String)" title="class or interface in java.net"><CODE>findClass</CODE></A> with <code>name</code>. If <code>findClass</code>
+ throws an exception, then this method throws that exception.
+ Otherwise, this method returns the <code>Class</code> returned
+ by <code>findClass</code>, and if <code>resolve</code> is
+ <code>true</code>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#resolveClass(java.lang.Class)" title="class or interface in java.lang"><CODE>resolveClass</CODE></A> is
+ invoked with the <code>Class</code> before returning.
+
+ <li>If <code>isPreferredResource</code> returns
+ <code>false</code>, then this method invokes the superclass
+ implementation of <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#loadClass(java.lang.String, boolean)" title="class or interface in java.lang"><CODE>loadClass</CODE></A> with <code>name</code> and <code>resolve</code> and
+ returns the result. If the superclass's <code>loadClass</code>
+ throws an exception, then this method throws that exception.
+
+ </ul>
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#loadClass(java.lang.String, boolean)" title="class or interface in java.lang">loadClass</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">ClassLoader</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - the binary name of the class to load<DD><CODE>resolve</CODE> - if <code>true</code>, then <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#resolveClass(java.lang.Class)" title="class or interface in java.lang"><CODE>resolveClass</CODE></A> will be invoked with the loaded class before
+ returning
+<DT><B>Returns:</B><DD>the loaded class
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassNotFoundException.html" title="class or interface in java.lang">ClassNotFoundException</A></CODE> - if the class could not be found</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getResource(java.lang.String)"><!-- --></A><H3>
+getResource</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URL.html" title="class or interface in java.net">URL</A> <B>getResource</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> name)</PRE>
+<DL>
+<DD>Gets a resource with the specified name.
+
+ <p><code>PreferredClassLoader</code> implements this method as
+ follows:
+
+ <p>This method invokes <A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#isPreferredResource(java.lang.String, boolean)"><CODE>isPreferredResource</CODE></A> with <code>name</code> as the first
+ argument and <code>false</code> as the second argument:
+
+ <ul>
+
+ <li>If <code>isPreferredResource</code> throws an
+ <code>IOException</code>, then this method returns
+ <code>null</code>.
+
+ <li>If <code>isPreferredResource</code> returns
+ <code>true</code>, then this method invokes <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#findResource(java.lang.String)" title="class or interface in java.net"><CODE>findResource</CODE></A> with <code>name</code> and returns
+ the result.
+
+ <li>If <code>isPreferredResource</code> returns
+ <code>false</code>, then this method invokes the superclass
+ implementation of <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#getResource(java.lang.String)" title="class or interface in java.lang"><CODE>getResource</CODE></A>
+ with <code>name</code> and returns the result.
+
+ </ul>
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#getResource(java.lang.String)" title="class or interface in java.lang">getResource</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">ClassLoader</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the resource to get
+<DT><B>Returns:</B><DD>a <code>URL</code> for the resource, or
+ <code>null</code> if the resource could not be found</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="definePackage(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.net.URL)"><!-- --></A><H3>
+definePackage</H3>
+<PRE>
+protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Package.html" title="class or interface in java.lang">Package</A> <B>definePackage</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> name,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> specTitle,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> specVersion,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> specVendor,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implTitle,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implVersion,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implVendor,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URL.html" title="class or interface in java.net">URL</A> sealBase)</PRE>
+<DL>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html#definePackage(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.net.URL)" title="class or interface in java.lang">definePackage</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/ClassLoader.html" title="class or interface in java.lang">ClassLoader</A></CODE></DL>
+</DD>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getClassAnnotation()"><!-- --></A><H3>
+getClassAnnotation</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getClassAnnotation</B>()</PRE>
+<DL>
+<DD>Returns the class annotation string for classes defined by this
+ class loader. The returned value may be <code>null</code>.
+
+ <p><code>PreferredClassLoader</code> implements this method as
+ follows:
+
+ <p>If this <code>PreferredClassLoader</code> was constructed
+ with a non-<code>null</code> export class annotation string,
+ then this method returns that string. Otherwise, this method
+ returns a space-separated list of this loader's path of URLs.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jini/loader/ClassAnnotation.html#getClassAnnotation()">getClassAnnotation</A></CODE> in interface <CODE><A HREF="../../../../net/jini/loader/ClassAnnotation.html" title="interface in net.jini.loader">ClassAnnotation</A></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the class annotation string for classes defined by this
+ loader, or <code>null</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getPermissions(java.security.CodeSource)"><!-- --></A><H3>
+getPermissions</H3>
+<PRE>
+protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/PermissionCollection.html" title="class or interface in java.security">PermissionCollection</A> <B>getPermissions</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/CodeSource.html" title="class or interface in java.security">CodeSource</A> codeSource)</PRE>
+<DL>
+<DD>Returns the static permissions to be automatically granted to
+ classes loaded from the specified <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/security/CodeSource.html" title="class or interface in java.security"><CODE>CodeSource</CODE></A> and
+ defined by this class loader.
+
+ <p><code>PreferredClassLoader</code> implements this method as
+ follows:
+
+ <p>If there is a security manager and this
+ <code>PreferredClassLoader</code> was constructed to enforce
+ <A HREF="../../../../net/jini/loader/DownloadPermission.html" title="class in net.jini.loader"><CODE>DownloadPermission</CODE></A>, then this method checks that the
+ current security policy grants the specified
+ <code>CodeSource</code> the permission
+ <code>DownloadPermission("permit")</code>; if that check fails,
+ then this method throws a <code>SecurityException</code>.
+
+ <p>Then this method invokes the superclass implementation of
+ <A HREF="../../../../net/jini/loader/pref/PreferredClassLoader.html#getPermissions(java.security.CodeSource)"><CODE>getPermissions</CODE></A> and returns the result.
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html#getPermissions(java.security.CodeSource)" title="class or interface in java.net">getPermissions</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URLClassLoader.html" title="class or interface in java.net">URLClassLoader</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>codeSource</CODE> - the <code>CodeSource</code> to return the
+ permissions to be granted to
+<DT><B>Returns:</B><DD>the permissions to be granted to the
+ <code>CodeSource</code>
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/SecurityException.html" title="class or interface in java.lang">SecurityException</A></CODE> - if there is a security manager, this
+ <code>PreferredClassLoader</code> was constructed to enforce
+ <code>DownloadPermission</code>, and the current security
+ policy does not grant the specified <code>CodeSource</code> the
+ permission <code>DownloadPermission("permit")</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="toString()"><!-- --></A><H3>
+toString</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>toString</B>()</PRE>
+<DL>
+<DD>Returns a string representation of this class loader.
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></DL>
+</DD>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/PreferredClassLoader.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV CLASS
+ <A HREF="../../../../net/jini/loader/pref/PreferredClassProvider.html" title="class in net.jini.loader.pref"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?net/jini/loader/pref/PreferredClassLoader.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="PreferredClassLoader.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>