You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by bu...@apache.org on 2010/12/24 21:38:02 UTC
svn commit: r781476 [8/10] -
/websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/
Added: websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/LookupLocatorDiscovery.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/LookupLocatorDiscovery.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/LookupLocatorDiscovery.html Fri Dec 24 20:38:01 2010
@@ -0,0 +1,940 @@
+<!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:16 EST 2010 -->
+<TITLE>
+LookupLocatorDiscovery (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.discovery.LookupLocatorDiscovery class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="LookupLocatorDiscovery (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/LookupLocatorDiscovery.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">
+ <A HREF="../../../net/jini/discovery/LookupDiscoveryService.html" title="interface in net.jini.discovery"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/discovery/LookupUnmarshalException.html" title="class in net.jini.discovery"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/discovery/LookupLocatorDiscovery.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LookupLocatorDiscovery.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.discovery</FONT>
+<BR>
+Class LookupLocatorDiscovery</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 "><B>net.jini.discovery.LookupLocatorDiscovery</B>
+</PRE>
+<DL>
+<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html" title="interface in net.jini.discovery">DiscoveryLocatorManagement</A>, <A HREF="../../../net/jini/discovery/DiscoveryManagement.html" title="interface in net.jini.discovery">DiscoveryManagement</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public class <B>LookupLocatorDiscovery</B><DT>extends <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><DT>implements <A HREF="../../../net/jini/discovery/DiscoveryManagement.html" title="interface in net.jini.discovery">DiscoveryManagement</A>, <A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html" title="interface in net.jini.discovery">DiscoveryLocatorManagement</A></DL>
+</PRE>
+
+<P>
+This class encapsulates the functionality required of an entity that
+ wishes to employ the unicast discovery protocol to discover a lookup
+ service. This utility provides an implementation that makes the process
+ of finding specific lookup services much simpler for both services and
+ clients.
+ <p>
+ Because this class participates in only the unicast discovery protocol,
+ and because the unicast discovery protocol imposes no restriction on the
+ physical location of the entity relative to a lookup service, this utility
+ can be used to discover lookup services running on hosts that are located
+ far from, or near to, the host on which the entity is running. This lack
+ of a restriction on location brings with it a requirement that the
+ discovering entity supply this class with specific information about the
+ desired lookup services; namely, the location of the device(s) hosting
+ each lookup service. This information is supplied through an instance
+ of the <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery"><CODE>LookupLocator</CODE></A> class.
+<P>
+
+<P>
+<DL>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery"><CODE>LookupLocator</CODE></A><DT><B>Implementation Specifics:</B></DT>
+ <DD><!-- Implementation Specifics -->
+
+ The following implementation-specific items are discussed below:
+ <ul><li> <a href="#lldConfigEntries">Configuring LookupLocatorDiscovery</a>
+ <li> <a href="#lldLogging">Logging</a>
+ </ul>
+
+ <a name="lldConfigEntries">
+ <p>
+ <b><font size="+1">Configuring LookupLocatorDiscovery</font></b>
+ <p>
+ </a>
+
+ This implementation of <code>LookupLocatorDiscovery</code> supports the
+ following configuration entries; where each configuration entry name
+ is associated with the component name
+ <code>net.jini.discovery.LookupLocatorDiscovery</code>. Note that the
+ configuration entries specified here are specific to this implementation
+ of <codeLookupLocatorDiscovery</code>. Unless otherwise stated, each
+ entry is retrieved from the configuration only once per instance of
+ this utility, where each such retrieval is performed in the constructor.
+
+ <a name="initialUnicastDelayRange">
+ <table summary="Describes the initialUnicastDelayRange
+ configuration entry" border="0" cellpadding="2">
+ <tr valign="top">
+ <th scope="col" summary="layout"> <font size="+1">•</font>
+ <th scope="col" align="left" colspan="2"> <font size="+1">
+ <code>initialUnicastDelayRange</code></font>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Type: <td> <code>long</code>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Default: <td> <code>0 milliseconds</code>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Description:
+ <td> With respect to when this utility is started, this entry controls
+ how long to wait before attempting unicast discovery.
+ If the value is positive, initial unicast discovery requests
+ will be delayed by a random value between <code>0</code> and
+ <code>initialUnicastDelayRange</code> milliseconds. Once the wait
+ period is up, the <code>LookupLocator</code>s specified at construction
+ time are used for initiating unicast discovery requests, unless the
+ managed <code>LookupLocator</code>s have been changed in the interim;
+ in which case, no delayed unicast discovery requests are performed.
+ Note that this entry only has effect when this utility is initialized.
+ It does not delay discovery requests that are initiated if the managed
+ <code>LookupLocator</code>s are subsequently changed.
+ </table>
+ <a name="registrarPreparer">
+ <table summary="Describes the registrarPreparer configuration entry"
+ border="0" cellpadding="2">
+ <tr valign="top">
+ <th scope="col" summary="layout"> <font size="+1">•</font>
+ <th scope="col" align="left" colspan="2"> <font size="+1">
+ <code>registrarPreparer</code></font>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Type: <td> <A HREF="../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security"><CODE>ProxyPreparer</CODE></A>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Default: <td> <code>new <A HREF="../../../net/jini/security/BasicProxyPreparer.html" title="class in net.jini.security"><CODE>BasicProxyPreparer</CODE></A>()
+ </code>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Description:
+ <td> Preparer for the proxies to the lookup services that are
+ discovered and used by this utility.
+ <p>
+ This preparer should perform all operations required to use a
+ newly received proxy to a lookup service, which may including
+ verifying trust in the proxy, granting permissions, and setting
+ constraints.
+ <p>
+ Currently, none of the methods on the
+ <A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup"><CODE>ServiceRegistrar</CODE></A>
+ returned by this preparer are invoked by this implementation of
+ <code>LookupLocatorDiscovery</code>.
+ </table>
+
+ <a name="taskManager">
+ <table summary="Describes the taskManager configuration entry"
+ border="0" cellpadding="2">
+ <tr valign="top">
+ <th scope="col" summary="layout"> <font size="+1">•</font>
+ <th scope="col" align="left" colspan="2"> <font size="+1">
+ <code>taskManager</code></font>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Type: <td> <A HREF="../../../com/sun/jini/thread/TaskManager.html" title="class in com.sun.jini.thread"><CODE>TaskManager</CODE></A>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Default: <td> <code>new
+ <A HREF="../../../com/sun/jini/thread/TaskManager.html#TaskManager()"><CODE>TaskManager</CODE></A>(15, (15*1000), 1.0f)</code>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Description:
+ <td> The object that pools and manages the various threads
+ executed by this utility. The default manager creates a
+ maximum of 15 threads, waits 15 seconds before removing
+ idle threads, and uses a load factor of 1.0 when
+ determining whether to create a new thread. This object
+ should not be shared with other components in the
+ application that employs this utility.
+ </table>
+
+ <a name="wakeupManager">
+ <table summary="Describes the wakeupManager configuration entry"
+ border="0" cellpadding="2">
+ <tr valign="top">
+ <th scope="col" summary="layout"> <font size="+1">•</font>
+ <th scope="col" align="left" colspan="2"> <font size="+1">
+ <code>wakeupManager</code></font>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Type: <td> <A HREF="../../../com/sun/jini/thread/WakeupManager.html" title="class in com.sun.jini.thread"><CODE>WakeupManager</CODE></A>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Default: <td> <code>new
+ <A HREF="../../../com/sun/jini/thread/WakeupManager.html#WakeupManager(com.sun.jini.thread.WakeupManager.ThreadDesc)"><CODE>WakeupManager</CODE></A>(new
+ <A HREF="../../../com/sun/jini/thread/WakeupManager.ThreadDesc.html" title="class in com.sun.jini.thread"><CODE>WakeupManager.ThreadDesc</CODE></A>(null,true))</code>
+
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Description:
+ <td> Object that pools and manages the various tasks that are
+ initially executed by the object corresponding to the
+ <a href="#taskManager"><code>taskManager</code></a> entry
+ of this component, but which fail during that initial execution.
+ This object schedules the re-execution of such a failed task -
+ in the <a href="#taskManager"><code>taskManager</code></a>
+ object - at various times in the future, (employing a
+ "backoff strategy"). The re-execution of the failed task will
+ continue to be scheduled by this object until the task finally
+ succeeds. This object should not be shared with other components
+ in the application that employs this utility.
+ </table>
+
+ <a name="lldLogging">
+ <p>
+ <b><font size="+1">Logging</font></b>
+ <p>
+ </a>
+
+ This implementation of <code>LookupLocatorDiscovery</code> uses the
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Logger.html" title="class or interface in java.util.logging"><CODE>Logger</CODE></A> named <code>net.jini.discovery.LookupLocatorDiscovery</code>
+ to log information at the following logging levels: <p>
+
+ <table border="1" cellpadding="5"
+ summary="Describes the information logged by LookupLocatorDiscovery,
+ and the levels at which that information is logged">
+
+ <caption halign="center" valign="top">
+ <b><code>net.jini.discovery.LookupLocatorDiscovery</code></b>
+ </caption>
+
+ <tr> <th scope="col"> Level</th>
+ <th scope="col"> Description</th>
+ </tr>
+
+ <tr>
+ <td><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#INFO" title="class or interface in java.util.logging"><CODE>INFO</CODE></A></td>
+ <td>
+ when any exception occurs in a task or thread, while attempting unicast
+ discovery of a given locator
+ </td>
+ </tr>
+ <tr>
+ <td><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#INFO" title="class or interface in java.util.logging"><CODE>INFO</CODE></A></td>
+ <td>when any exception occurs while attempting to prepare a proxy</td>
+ </tr>
+ <tr>
+ <td><A HREF="../../../com/sun/jini/logging/Levels.html#HANDLED"><CODE>HANDLED</CODE></A></td>
+ <td>
+ when an exception is handled during unicast discovery.
+ </td>
+ </tr>
+ <tr>
+ <td><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINEST" title="class or interface in java.util.logging"><CODE>FINEST</CODE></A></td>
+ <td>whenever any thread or task is started</td>
+ </tr>
+
+ <tr>
+ <td><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINEST" title="class or interface in java.util.logging"><CODE>FINEST</CODE></A></td>
+ <td>
+ whenever any thread (except the <code>Notifier</code> thread) or task
+ completes successfully
+ </td>
+ </tr>
+
+ <tr>
+ <td><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINEST" title="class or interface in java.util.logging"><CODE>FINEST</CODE></A></td>
+ <td>whenever a discovered or discarded event is sent</td>
+ </tr>
+
+ <tr>
+ <td><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINEST" title="class or interface in java.util.logging"><CODE>FINEST</CODE></A></td>
+ <td>whenever a proxy is prepared</td>
+ </tr>
+
+ <tr>
+ <td><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINEST" title="class or interface in java.util.logging"><CODE>FINEST</CODE></A></td>
+ <td>
+ when an <code>IOException</code> occurs upon attempting to close the
+ socket after a unicast discovery attempt has either completed
+ successfully or failed
+ </td>
+ </tr>
+ </table>
+ <p>
+
+ This implementation of <code>LookupLocatorDiscovery</code> determines
+ the constraints (if any) to apply to unicast discovery for a given
+ <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery"><CODE>LookupLocator</CODE></A> instance
+ by calling the
+ <A HREF="../../../net/jini/core/constraint/RemoteMethodControl.html#getConstraints()"><CODE>getConstraints</CODE></A> method of that instance, if it implements the
+ <A HREF="../../../net/jini/core/constraint/RemoteMethodControl.html" title="interface in net.jini.core.constraint"><CODE>RemoteMethodControl</CODE></A>
+ interface. If the <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery"><CODE>LookupLocator</CODE></A> instance does not implement
+ <A HREF="../../../net/jini/core/constraint/RemoteMethodControl.html" title="interface in net.jini.core.constraint"><CODE>RemoteMethodControl</CODE></A>,
+ then no constraints are applied to unicast discovery for that instance.
+ <p>
+ For more information on constraining unicast discovery, refer to the
+ documentation for the <A HREF="../../../net/jini/discovery/ConstrainableLookupLocator.html" title="class in net.jini.discovery"><CODE>ConstrainableLookupLocator</CODE></A> class.</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/discovery/LookupLocatorDiscovery.html#LookupLocatorDiscovery(net.jini.core.discovery.LookupLocator[])">LookupLocatorDiscovery</A></B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)</CODE>
+
+<BR>
+ Creates an instance of this class (<code>LookupLocatorDiscovery</code>),
+ with an initial array of <code>LookupLocator</code>s to be managed.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#LookupLocatorDiscovery(net.jini.core.discovery.LookupLocator[], net.jini.config.Configuration)">LookupLocatorDiscovery</A></B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators,
+ <A HREF="../../../net/jini/config/Configuration.html" title="interface in net.jini.config">Configuration</A> config)</CODE>
+
+<BR>
+ Constructs a new lookup locator discovery object, set to discover the
+ given set of locators, and having the given <code>Configuration</code>.</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> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#addDiscoveryListener(net.jini.discovery.DiscoveryListener)">addDiscoveryListener</A></B>(<A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery">DiscoveryListener</A> l)</CODE>
+
+<BR>
+ Add a DiscoveryListener to the listener set.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#addLocators(net.jini.core.discovery.LookupLocator[])">addLocators</A></B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)</CODE>
+
+<BR>
+ Adds a set of locators to the managed set of locators.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#discard(net.jini.core.lookup.ServiceRegistrar)">discard</A></B>(<A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A> proxy)</CODE>
+
+<BR>
+ Removes an instance of <code>ServiceRegistrar</code> from the
+ managed set of lookup services, making the corresponding lookup
+ service eligible for re-discovery.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#getDiscoveredLocators()">getDiscoveredLocators</A></B>()</CODE>
+
+<BR>
+ Returns the set of <code>LookupLocator</code> objects representing the
+ desired lookup services that are currently discovered.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#getLocators()">getLocators</A></B>()</CODE>
+
+<BR>
+ Returns an array consisting of the elements of the managed set
+ of locators; that is, instances of <code>LookupLocator</code> in
+ which each instance corresponds to a specific lookup service to
+ discover.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#getRegistrars()">getRegistrars</A></B>()</CODE>
+
+<BR>
+ Returns an array of instances of <code>ServiceRegistrar</code>, each
+ corresponding to a proxy to one of the currently discovered lookup
+ services.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#getUndiscoveredLocators()">getUndiscoveredLocators</A></B>()</CODE>
+
+<BR>
+ Returns the set of <code>LookupLocator</code> objects representing the
+ desired lookup services that have not yet been discovered.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#removeDiscoveryListener(net.jini.discovery.DiscoveryListener)">removeDiscoveryListener</A></B>(<A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery">DiscoveryListener</A> l)</CODE>
+
+<BR>
+ Remove a DiscoveryListener from the listener set.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#removeLocators(net.jini.core.discovery.LookupLocator[])">removeLocators</A></B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)</CODE>
+
+<BR>
+ Deletes a set of locators from the managed set of locators, and discards
+ any already-discovered lookup service that corresponds to a deleted
+ locator.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#setLocators(net.jini.core.discovery.LookupLocator[])">setLocators</A></B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)</CODE>
+
+<BR>
+ Replaces all of the locators in the managed set with locators from
+ a new set, and discards any already-discovered lookup service that
+ corresponds to a locator that is removed from the managed set
+ as a result of an invocation of this method.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#terminate()">terminate</A></B>()</CODE>
+
+<BR>
+ Terminates all threads, ending all locator discovery processing being
+ performed by the current instance of this class.</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#toString()" title="class or interface in java.lang">toString</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="LookupLocatorDiscovery(net.jini.core.discovery.LookupLocator[])"><!-- --></A><H3>
+LookupLocatorDiscovery</H3>
+<PRE>
+public <B>LookupLocatorDiscovery</B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)</PRE>
+<DL>
+<DD>Creates an instance of this class (<code>LookupLocatorDiscovery</code>),
+ with an initial array of <code>LookupLocator</code>s to be managed.
+ For each managed <code>LookupLocator</code>, unicast discovery is
+ performed to obtain a <code>ServiceRegistrar</code> proxy for that
+ lookup service.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>locators</CODE> - the locators to discover
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - input array contains at least
+ one <code>null</code> element</DL>
+</DL>
+<HR>
+
+<A NAME="LookupLocatorDiscovery(net.jini.core.discovery.LookupLocator[], net.jini.config.Configuration)"><!-- --></A><H3>
+LookupLocatorDiscovery</H3>
+<PRE>
+public <B>LookupLocatorDiscovery</B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators,
+ <A HREF="../../../net/jini/config/Configuration.html" title="interface in net.jini.config">Configuration</A> config)
+ throws <A HREF="../../../net/jini/config/ConfigurationException.html" title="class in net.jini.config">ConfigurationException</A></PRE>
+<DL>
+<DD>Constructs a new lookup locator discovery object, set to discover the
+ given set of locators, and having the given <code>Configuration</code>.
+ <p>
+ For each managed <code>LookupLocator</code>, unicast discovery is
+ performed to obtain a <code>ServiceRegistrar</code> proxy for that
+ lookup service.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>locators</CODE> - the locators to discover<DD><CODE>config</CODE> - an instance of <code>Configuration</code>, used to
+ obtain the objects needed to configure the current
+ instance of this class
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../net/jini/config/ConfigurationException.html" title="class in net.jini.config">ConfigurationException</A></CODE> - indicates an exception
+ occurred while retrieving an item from the given
+ <code>Configuration</code>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - input array contains at least
+ one <code>null</code> element or <code>null</code> is input
+ for the configuration</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="addDiscoveryListener(net.jini.discovery.DiscoveryListener)"><!-- --></A><H3>
+addDiscoveryListener</H3>
+<PRE>
+public void <B>addDiscoveryListener</B>(<A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery">DiscoveryListener</A> l)</PRE>
+<DL>
+<DD>Add a DiscoveryListener to the listener set. The listener's
+ discovered method gets called right way with an array of
+ ServiceRegistrars that have already been discovered, and will
+ be called in the future whenever additional lookup services
+ are discovered.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryManagement.html#addDiscoveryListener(net.jini.discovery.DiscoveryListener)">addDiscoveryListener</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryManagement.html" title="interface in net.jini.discovery">DiscoveryManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>l</CODE> - the new DiscoveryListener to add
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - this exception occurs when
+ <code>null</code> is input to the listener parameter
+ <code>l</code>.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - this exception occurs when
+ this method is called after the <code>terminate</code>
+ method has been called.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#removeDiscoveryListener(net.jini.discovery.DiscoveryListener)"><CODE>removeDiscoveryListener(net.jini.discovery.DiscoveryListener)</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="removeDiscoveryListener(net.jini.discovery.DiscoveryListener)"><!-- --></A><H3>
+removeDiscoveryListener</H3>
+<PRE>
+public void <B>removeDiscoveryListener</B>(<A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery">DiscoveryListener</A> l)</PRE>
+<DL>
+<DD>Remove a DiscoveryListener from the listener set. It does
+ nothing if the DiscoveryListener does not exist in the
+ the listener set.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryManagement.html#removeDiscoveryListener(net.jini.discovery.DiscoveryListener)">removeDiscoveryListener</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryManagement.html" title="interface in net.jini.discovery">DiscoveryManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>l</CODE> - the existing DiscoveryListener to remove
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - this exception occurs when
+ this method is called after the <code>terminate</code>
+ method has been called.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#addDiscoveryListener(net.jini.discovery.DiscoveryListener)"><CODE>addDiscoveryListener(net.jini.discovery.DiscoveryListener)</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getRegistrars()"><!-- --></A><H3>
+getRegistrars</H3>
+<PRE>
+public <A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A>[] <B>getRegistrars</B>()</PRE>
+<DL>
+<DD>Returns an array of instances of <code>ServiceRegistrar</code>, each
+ corresponding to a proxy to one of the currently discovered lookup
+ services. For each invocation of this method, a new array is returned.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryManagement.html#getRegistrars()">getRegistrars</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryManagement.html" title="interface in net.jini.discovery">DiscoveryManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>array of instances of <code>ServiceRegistrar</code>, each
+ corresponding to a proxy to one of the currently discovered
+ lookup services
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - this exception occurs when
+ this method is called after the <code>terminate</code>
+ method has been called.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup"><CODE>ServiceRegistrar</CODE></A>,
+<A HREF="../../../net/jini/discovery/DiscoveryManagement.html#removeDiscoveryListener(net.jini.discovery.DiscoveryListener)"><CODE>DiscoveryManagement.removeDiscoveryListener(net.jini.discovery.DiscoveryListener)</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="discard(net.jini.core.lookup.ServiceRegistrar)"><!-- --></A><H3>
+discard</H3>
+<PRE>
+public void <B>discard</B>(<A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A> proxy)</PRE>
+<DL>
+<DD>Removes an instance of <code>ServiceRegistrar</code> from the
+ managed set of lookup services, making the corresponding lookup
+ service eligible for re-discovery. This method takes no action if
+ the parameter input to this method is <code>null</code>, or if it
+ does not match (using <code>equals</code>) any of the elements in
+ the managed set.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryManagement.html#discard(net.jini.core.lookup.ServiceRegistrar)">discard</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryManagement.html" title="interface in net.jini.discovery">DiscoveryManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>proxy</CODE> - the instance of <code>ServiceRegistrar</code> to discard
+ from the managed set of lookup services
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - this exception occurs when
+ this method is called after the <code>terminate</code>
+ method has been called.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup"><CODE>ServiceRegistrar</CODE></A>,
+<A HREF="../../../net/jini/discovery/DiscoveryManagement.html#discard(net.jini.core.lookup.ServiceRegistrar)"><CODE>DiscoveryManagement.discard(net.jini.core.lookup.ServiceRegistrar)</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="terminate()"><!-- --></A><H3>
+terminate</H3>
+<PRE>
+public void <B>terminate</B>()</PRE>
+<DL>
+<DD>Terminates all threads, ending all locator discovery processing being
+ performed by the current instance of this class.
+ <p>
+ After this method has been invoked, no new lookup services will
+ be discovered, and the effect of any new operations performed
+ on the current instance of this class are undefined.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryManagement.html#terminate()">terminate</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryManagement.html" title="interface in net.jini.discovery">DiscoveryManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryManagement.html#terminate()"><CODE>DiscoveryManagement.terminate()</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLocators()"><!-- --></A><H3>
+getLocators</H3>
+<PRE>
+public <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] <B>getLocators</B>()</PRE>
+<DL>
+<DD>Returns an array consisting of the elements of the managed set
+ of locators; that is, instances of <code>LookupLocator</code> in
+ which each instance corresponds to a specific lookup service to
+ discover. The returned set will include both the set of
+ <code>LookupLocator</code>s corresponding to lookup services
+ that have already been discovered as well as the set of those
+ that have not yet been discovered. If the managed set of locators
+ is empty, this method will return the empty array. This method
+ returns a new array upon each invocation.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html#getLocators()">getLocators</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html" title="interface in net.jini.discovery">DiscoveryLocatorManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD><code>LookupLocator</code> array consisting of the elements
+ of the managed set of locators
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - this exception occurs when
+ this method is called after the <code>terminate</code>
+ method has been called.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html#getLocators()"><CODE>DiscoveryLocatorManagement.getLocators()</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#setLocators(net.jini.core.discovery.LookupLocator[])"><CODE>setLocators(net.jini.core.discovery.LookupLocator[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="addLocators(net.jini.core.discovery.LookupLocator[])"><!-- --></A><H3>
+addLocators</H3>
+<PRE>
+public void <B>addLocators</B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)</PRE>
+<DL>
+<DD>Adds a set of locators to the managed set of locators. Elements in the
+ input set that duplicate (using the <code>LookupLocator.equals</code>
+ method) elements already in the managed set will be ignored. If the
+ empty array is input, the managed set of locators will not change.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html#addLocators(net.jini.core.discovery.LookupLocator[])">addLocators</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html" title="interface in net.jini.discovery">DiscoveryLocatorManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>locators</CODE> - <code>LookupLocator</code> array consisting of the
+ locators to add to the managed set.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - this exception occurs when
+ either <code>null</code> is input to the <code>locators</code>
+ parameter, or one or more of the elements of the
+ <code>locators</code> parameter is <code>null</code>.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - this exception occurs when
+ this method is called after the <code>terminate</code>
+ method has been called.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html#addLocators(net.jini.core.discovery.LookupLocator[])"><CODE>DiscoveryLocatorManagement.addLocators(net.jini.core.discovery.LookupLocator[])</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#removeLocators(net.jini.core.discovery.LookupLocator[])"><CODE>removeLocators(net.jini.core.discovery.LookupLocator[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setLocators(net.jini.core.discovery.LookupLocator[])"><!-- --></A><H3>
+setLocators</H3>
+<PRE>
+public void <B>setLocators</B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)</PRE>
+<DL>
+<DD>Replaces all of the locators in the managed set with locators from
+ a new set, and discards any already-discovered lookup service that
+ corresponds to a locator that is removed from the managed set
+ as a result of an invocation of this method. For any such lookup
+ service that is discarded, a discard notification is sent; and that
+ lookup service will not be eligible for re-discovery (assuming it is
+ not currently eligible for discovery through other means, such as
+ group discovery).
+ <p>
+ If the empty array is input, locator discovery will cease until this
+ method is invoked with an input parameter that is non-<code>null</code>
+ and non-empty.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html#setLocators(net.jini.core.discovery.LookupLocator[])">setLocators</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html" title="interface in net.jini.discovery">DiscoveryLocatorManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>locators</CODE> - <code>LookupLocator</code> array consisting of the
+ locators that will replace the current locators in the
+ managed set.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - this exception occurs when
+ either <code>null</code> is input to the <code>locators</code>
+ parameter, or one or more of the elements of the
+ <code>locators</code> parameter is <code>null</code>.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - this exception occurs when
+ this method is called after the <code>terminate</code>
+ method has been called.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html#setLocators(net.jini.core.discovery.LookupLocator[])"><CODE>DiscoveryLocatorManagement.setLocators(net.jini.core.discovery.LookupLocator[])</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#getLocators()"><CODE>getLocators()</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="removeLocators(net.jini.core.discovery.LookupLocator[])"><!-- --></A><H3>
+removeLocators</H3>
+<PRE>
+public void <B>removeLocators</B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)</PRE>
+<DL>
+<DD>Deletes a set of locators from the managed set of locators, and discards
+ any already-discovered lookup service that corresponds to a deleted
+ locator. For any lookup service that is discarded as a result of an
+ invocation of this method, a discard notification is sent; and that
+ lookup service will not be eligible for re-discovery (assuming it is
+ not currently eligible for discovery through other means, such as
+ group discovery).
+ <p>
+ If the empty array is input, this method takes no action.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html#removeLocators(net.jini.core.discovery.LookupLocator[])">removeLocators</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html" title="interface in net.jini.discovery">DiscoveryLocatorManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>locators</CODE> - <code>LookupLocator</code> array consisting of the
+ locators that will be removed from the managed set.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - this exception occurs when
+ either <code>null</code> is input to the <code>locators</code>
+ parameter, or one or more of the elements of the
+ <code>locators</code> parameter is <code>null</code>.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - this exception occurs when
+ this method is called after the <code>terminate</code>
+ method has been called.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html#removeLocators(net.jini.core.discovery.LookupLocator[])"><CODE>DiscoveryLocatorManagement.removeLocators(net.jini.core.discovery.LookupLocator[])</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html#addLocators(net.jini.core.discovery.LookupLocator[])"><CODE>addLocators(net.jini.core.discovery.LookupLocator[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getDiscoveredLocators()"><!-- --></A><H3>
+getDiscoveredLocators</H3>
+<PRE>
+public <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] <B>getDiscoveredLocators</B>()</PRE>
+<DL>
+<DD>Returns the set of <code>LookupLocator</code> objects representing the
+ desired lookup services that are currently discovered. If no lookup
+ services are currently discovered, this method returns the empty array.
+ This method returns a new array upon each invocation.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD><code>LookupLocator</code> array consisting of the elements
+ from the managed set of locators that correspond to lookup
+ services that have already been discovered.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - this exception occurs when
+ this method is called after the <code>terminate</code>
+ method has been called.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getUndiscoveredLocators()"><!-- --></A><H3>
+getUndiscoveredLocators</H3>
+<PRE>
+public <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] <B>getUndiscoveredLocators</B>()</PRE>
+<DL>
+<DD>Returns the set of <code>LookupLocator</code> objects representing the
+ desired lookup services that have not yet been discovered. If all
+ of the desired lookup services are currently discovered, this method
+ returns the empty array. This method returns a new array upon each
+ invocation.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD><code>LookupLocator</code> array consisting of the elements
+ from the managed set of locators that correspond to lookup
+ services that have not yet been discovered.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - this exception occurs when
+ this method is called after the <code>terminate</code>
+ method has been called.</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/LookupLocatorDiscovery.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">
+ <A HREF="../../../net/jini/discovery/LookupDiscoveryService.html" title="interface in net.jini.discovery"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/discovery/LookupUnmarshalException.html" title="class in net.jini.discovery"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/discovery/LookupLocatorDiscovery.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LookupLocatorDiscovery.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>
Added: websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/LookupUnmarshalException.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/LookupUnmarshalException.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/LookupUnmarshalException.html Fri Dec 24 20:38:01 2010
@@ -0,0 +1,483 @@
+<!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:16 EST 2010 -->
+<TITLE>
+LookupUnmarshalException (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.discovery.LookupUnmarshalException class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="LookupUnmarshalException (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/LookupUnmarshalException.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">
+ <A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html" title="class in net.jini.discovery"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/discovery/OutgoingMulticastAnnouncement.html" title="class in net.jini.discovery"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/discovery/LookupUnmarshalException.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LookupUnmarshalException.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.discovery</FONT>
+<BR>
+Class LookupUnmarshalException</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/Throwable.html" title="class or interface in java.lang">java.lang.Throwable</A>
+ <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Exception.html" title="class or interface in java.lang">java.lang.Exception</A>
+ <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>net.jini.discovery.LookupUnmarshalException</B>
+</PRE>
+<DL>
+<DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/Serializable.html" title="class or interface in java.io">Serializable</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public class <B>LookupUnmarshalException</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></DL>
+</PRE>
+
+<P>
+When unmarshalling an instance of <code>MarshalledObject</code>, different
+ exceptions can occur. An <code>IOException</code> can occur while
+ deserializing the object from its internal representation. A
+ <code>ClassNotFoundException</code> can occur if, while deserializing
+ the object from its internal representation, either the class file of
+ the object cannot be found, or the class file of either an interface
+ or a class referenced by the object being deserialized cannot be found.
+ Typically, a <code>ClassNotFoundException</code> occurs when the codebase
+ from which to retrieve the needed class file is not currently available.
+ <p>
+ This class provides a mechanism that clients of the lookup discovery
+ service may use for efficient handling of the exceptions that may
+ occur when unmarshalling elements of a set of marshalled instances
+ of the <code>ServiceRegistrar</code> interface. When elements in such
+ a set are unmarshalled, the <code>LookupUnmarshalException</code> class
+ may be used to collect and report pertinent information generated when
+ failure occurs while unmarshalling the elements of the set.
+ <p>
+ The information that may be of interest to entities that receive this
+ exception class is contained in the following fields: a set of
+ <code>ServiceRegistrar</code> instances in which each element is the
+ result of a successful unmarshalling attempt, a set of marshalled instances
+ of <code>ServiceRegistrar</code> in which each element could not be
+ successfully unmarshalled, and a set of exceptions (<code>IOException<code>,
+ <code>ClassNotFoundException</code>, or some unchecked exception) in which
+ each element corresponds to one of the unmarshalling failures.
+ <p>
+ Thus, when exceptional conditions occur while unmarshalling a set of
+ marshalled instances of <code>ServiceRegistrar</code>, this class can
+ be used not only to indicate that an exceptional condition has occurred,
+ but also to provide information that can be used to perform error handling
+ activities such as: determining if it is feasible to continue with
+ processing, reporting exceptions, attempting recovery, and debugging.
+ <p>
+ Note that this exception class should be used only to report exceptional
+ conditions occurring when unmarshalling a set of marshalled instances
+ of the <code>ServiceRegistrar</code> interface.
+<P>
+
+<P>
+<DL>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup"><CODE>ServiceRegistrar</CODE></A>,
+<A HREF="../../../serialized-form.html#net.jini.discovery.LookupUnmarshalException">Serialized Form</A></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/discovery/LookupUnmarshalException.html#LookupUnmarshalException(net.jini.core.lookup.ServiceRegistrar[], java.rmi.MarshalledObject[], java.lang.Throwable[])">LookupUnmarshalException</A></B>(<A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A>[] registrars,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[] marshalledRegistrars,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[] exceptions)</CODE>
+
+<BR>
+ Constructs a new instance of <code>LookupUnmarshalException</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupUnmarshalException.html#LookupUnmarshalException(net.jini.core.lookup.ServiceRegistrar[], java.rmi.MarshalledObject[], java.lang.Throwable[], java.lang.String)">LookupUnmarshalException</A></B>(<A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A>[] registrars,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[] marshalledRegistrars,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[] exceptions,
+ <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> message)</CODE>
+
+<BR>
+ Constructs a new instance of <code>LookupUnmarshalException</code>.</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> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupUnmarshalException.html#getExceptions()">getExceptions</A></B>()</CODE>
+
+<BR>
+ Accessor method that returns an array consisting of instances of
+ <code>Throwable</code>, where each element of the array corresponds
+ to one of the exceptions that occurred during the unmarshalling
+ process.</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/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupUnmarshalException.html#getMarshalledRegistrars()">getMarshalledRegistrars</A></B>()</CODE>
+
+<BR>
+ Accessor method that returns an array consisting of instances of
+ <code>MarshalledObject</code>, where each element of the array is a
+ marshalled instance of the <code>ServiceRegistrar</code> interface,
+ and corresponds to an object that could not be successfully
+ unmarshalled.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupUnmarshalException.html#getRegistrars()">getRegistrars</A></B>()</CODE>
+
+<BR>
+ Accessor method that returns an array consisting of instances of
+ <code>ServiceRegistrar</code>, where each element of the array
+ corresponds to a successfully unmarshalled object.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Throwable"><!-- --></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/Throwable.html" title="class or interface in java.lang">Throwable</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/Throwable.html#fillInStackTrace()" title="class or interface in java.lang">fillInStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#getCause()" title="class or interface in java.lang">getCause</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#getLocalizedMessage()" title="class or interface in java.lang">getLocalizedMessage</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#getMessage()" title="class or interface in java.lang">getMessage</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#getStackTrace()" title="class or interface in java.lang">getStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#initCause(java.lang.Throwable)" title="class or interface in java.lang">initCause</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwab
le.html#printStackTrace()" title="class or interface in java.lang">printStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#printStackTrace(java.io.PrintStream)" title="class or interface in java.lang">printStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#printStackTrace(java.io.PrintWriter)" title="class or interface in java.lang">printStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#setStackTrace(java.lang.StackTraceElement[])" title="class or interface in java.lang">setStackTrace</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html#toString()" title="class or interface in java.lang">toString</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="LookupUnmarshalException(net.jini.core.lookup.ServiceRegistrar[], java.rmi.MarshalledObject[], java.lang.Throwable[])"><!-- --></A><H3>
+LookupUnmarshalException</H3>
+<PRE>
+public <B>LookupUnmarshalException</B>(<A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A>[] registrars,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[] marshalledRegistrars,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[] exceptions)</PRE>
+<DL>
+<DD>Constructs a new instance of <code>LookupUnmarshalException</code>.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>registrars</CODE> - Array containing the set of instances of
+ <code>ServiceRegistrar</code> that were
+ successfully unmarshalled.<DD><CODE>marshalledRegistrars</CODE> - Array containing the set of marshalled
+ <code>ServiceRegistrar</code> instances
+ that could not be unmarshalled.<DD><CODE>exceptions</CODE> - Array containing the set of exceptions that
+ occurred during the unmarshalling process.
+ Each element in this set should be an
+ instance of <code>IOException</code>,
+ <code>ClassNotFoundException</code>, or
+ some unchecked exception. Furthermore,
+ there should be a one-to-one correspondence
+ between each element in this set and
+ each element in the
+ <code>marshalledRegistrars</code> parameter.
+ <p>
+ That is, the element of this set
+ corresponding to index i should be an
+ instance of the exception that occurred
+ while attempting to unmarshal the element
+ at index i of the
+ <code>marshalledRegistrars</code> parameter.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - this exception occurs
+ when <code>null</code> is input for either the
+ <code>marshalledRegistrars</code> parameter or the
+ <code>exceptions</code> parameter.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - this exception occurs when
+ either the <code>marshalledRegistrars</code> parameter or the
+ <code>exceptions</code> parameter has zero length; or when the
+ lengths of those two parameters are not equal.</DL>
+</DL>
+<HR>
+
+<A NAME="LookupUnmarshalException(net.jini.core.lookup.ServiceRegistrar[], java.rmi.MarshalledObject[], java.lang.Throwable[], java.lang.String)"><!-- --></A><H3>
+LookupUnmarshalException</H3>
+<PRE>
+public <B>LookupUnmarshalException</B>(<A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A>[] registrars,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[] marshalledRegistrars,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[] exceptions,
+ <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> message)</PRE>
+<DL>
+<DD>Constructs a new instance of <code>LookupUnmarshalException</code>.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>registrars</CODE> - Array containing the set of instances of
+ <code>ServiceRegistrar</code> that were
+ successfully unmarshalled.<DD><CODE>marshalledRegistrars</CODE> - Array containing the set of marshalled
+ <code>ServiceRegistrar</code> instances
+ that could not be unmarshalled.<DD><CODE>exceptions</CODE> - Array containing the set of exceptions that
+ occurred during the unmarshalling process.
+ Each element in this set should be an
+ instance of <code>IOException</code>,
+ <code>ClassNotFoundException</code>, or
+ some unchecked exception. Furthermore,
+ there should be a one-to-one correspondence
+ between each element in this set and
+ each element in the
+ <code>marshalledRegistrars</code> parameter.
+ <p>
+ That is, the element of this set
+ corresponding to index i should be an
+ instance of the exception that occurred
+ while attempting to unmarshal the element
+ at index i of the
+ <code>marshalledRegistrars</code> parameter.<DD><CODE>message</CODE> - <code>String</code> describing the nature
+ of the exception
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang">NullPointerException</A></CODE> - this exception occurs
+ when <code>null</code> is input for either the
+ <code>marshalledRegistrars</code> parameter or the
+ <code>exceptions</code> parameter.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - this exception occurs when
+ either the <code>marshalledRegistrars</code> parameter or the
+ <code>exceptions</code> parameter has zero length; or when the
+ lengths of those two parameters are not equal.</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="getRegistrars()"><!-- --></A><H3>
+getRegistrars</H3>
+<PRE>
+public <A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A>[] <B>getRegistrars</B>()</PRE>
+<DL>
+<DD>Accessor method that returns an array consisting of instances of
+ <code>ServiceRegistrar</code>, where each element of the array
+ corresponds to a successfully unmarshalled object. Note that the
+ same array is returned on each invocation of this method; that is,
+ a copy is not made.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>array of instances of <code>ServiceRegistrar</code>, where
+ each element corresponds to a successfully unmarshalled object.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getMarshalledRegistrars()"><!-- --></A><H3>
+getMarshalledRegistrars</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/MarshalledObject.html" title="class or interface in java.rmi">MarshalledObject</A>[] <B>getMarshalledRegistrars</B>()</PRE>
+<DL>
+<DD>Accessor method that returns an array consisting of instances of
+ <code>MarshalledObject</code>, where each element of the array is a
+ marshalled instance of the <code>ServiceRegistrar</code> interface,
+ and corresponds to an object that could not be successfully
+ unmarshalled. Note that the same array is returned on each invocation
+ of this method; that is, a copy is not made.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>array of marshalled instances of <code>ServiceRegistrar</code>,
+ where each element corresponds to an object in which failure
+ occurred while attempting to unmarshal the object.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getExceptions()"><!-- --></A><H3>
+getExceptions</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Throwable.html" title="class or interface in java.lang">Throwable</A>[] <B>getExceptions</B>()</PRE>
+<DL>
+<DD>Accessor method that returns an array consisting of instances of
+ <code>Throwable</code>, where each element of the array corresponds
+ to one of the exceptions that occurred during the unmarshalling
+ process. Note that the same array is returned on each invocation
+ of this method; that is, a copy is not made.
+ <p>
+ Each element in the return set should be an instance of
+ <code>IOException</code>, <code>ClassNotFoundException</code>, or
+ some unchecked exception. Additionally, there should be a one-to-one
+ correspondence between each element in the array returned by this method
+ and the array returned by the <code>getMarshalledRegistrars<code>
+ method. That is, the i-th element of the set returned by this method
+ should be an instance of the exception that occurred while attempting
+ to unmarshal the i-th element of the set returned by the method
+ <code>getMarshalledRegistrars</code>.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>array of instances of <code>Throwable</code>, where each element
+ corresponds to one of the exceptions that occurred during
+ the unmarshalling process.</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/LookupUnmarshalException.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">
+ <A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html" title="class in net.jini.discovery"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/discovery/OutgoingMulticastAnnouncement.html" title="class in net.jini.discovery"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../index.html?net/jini/discovery/LookupUnmarshalException.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LookupUnmarshalException.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>