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 [6/10] -
/websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/
Added: websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryManager.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryManager.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryManager.html Fri Dec 24 20:38:01 2010
@@ -0,0 +1,1007 @@
+<!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>
+LookupDiscoveryManager (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.discovery.LookupDiscoveryManager class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="LookupDiscoveryManager (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/LookupDiscoveryManager.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/LookupDiscovery.html" title="class in net.jini.discovery"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html" title="interface 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/LookupDiscoveryManager.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LookupDiscoveryManager.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 | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | <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 LookupDiscoveryManager</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.LookupDiscoveryManager</B>
+</PRE>
+<DL>
+<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html" title="interface in net.jini.discovery">DiscoveryGroupManagement</A>, <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>LookupDiscoveryManager</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/DiscoveryGroupManagement.html" title="interface in net.jini.discovery">DiscoveryGroupManagement</A>, <A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html" title="interface in net.jini.discovery">DiscoveryLocatorManagement</A></DL>
+</PRE>
+
+<P>
+This class is a helper utility class that organizes and manages all
+ discovery-related activities on behalf of a client or service. Rather
+ than providing its own facility for coordinating and maintaining
+ all of the necessary state information related to group names,
+ <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery"><CODE>LookupLocator</CODE></A> objects, and <A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery"><CODE>DiscoveryListener</CODE></A>
+ objects, clients and services can employ this class to provide those
+ facilities on their behalf.
+ <p>
+<P>
+
+<P>
+<DL>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryManagement.html" title="interface in net.jini.discovery"><CODE>DiscoveryManagement</CODE></A>,
+<A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html" title="interface in net.jini.discovery"><CODE>DiscoveryGroupManagement</CODE></A>,
+<A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html" title="interface in net.jini.discovery"><CODE>DiscoveryLocatorManagement</CODE></A><DT><B>Implementation Specifics:</B></DT>
+ <DD><!-- Implementation Specifics -->
+
+ The following implementation-specific items are discussed below:
+ <ul><li> <a href="#ldmConfigEntries">Configuring LookupDiscoveryManager</a>
+ <li> <a href="#ldmLogging">Logging</a>
+ </ul>
+
+ <a name="ldmConfigEntries">
+ <p>
+ <b><font size="+1">Configuring LookupDiscoveryManager</font></b>
+ <p>
+ </a>
+
+ Currently, there are no configuration entries directly supported by this
+ implementation of <code>LookupDiscoveryManager</code>. All configuration
+ entries affecting the operation of this utility are retrieved by either
+ the <A HREF="../../../net/jini/discovery/LookupDiscovery.html" title="class in net.jini.discovery"><CODE>LookupDiscovery</CODE></A> utility, or the <A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html" title="class in net.jini.discovery"><CODE>LookupLocatorDiscovery</CODE></A>
+ utility. Please refer to the documentation provided with those utilities
+ when configuring the behavior of <code>LookupDiscoveryManager</code>.
+
+ <a name="ldmLogging">
+ <p>
+ <b><font size="+1">Logging</font></b>
+ <p>
+ </a>
+
+ Currently, there are no loggers directly supported by this implementation
+ of <code>LookupDiscoveryManager</code>. All logging information produced
+ when using this utility is controlled by the loggers supported by the
+ following utilities:
+ <p>
+ <ul>
+ <li> <A HREF="../../../net/jini/discovery/LookupDiscovery.html" title="class in net.jini.discovery"><CODE>LookupDiscovery</CODE></A>
+ <li> <A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.html" title="class in net.jini.discovery"><CODE>LookupLocatorDiscovery</CODE></A>
+ </ul>
+ <p>
+ For information about how to obtain logging information when using this
+ implementation of <code>LookupDiscoveryManager</code>, please refer to
+ the documentation provided with the discovery utilities listed above.
+ <p></DD>
+</DL>
+<HR>
+
+<P>
+<!-- =========== FIELD SUMMARY =========== -->
+
+<A NAME="field_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>Field Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static int</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupDiscoveryManager.html#FROM_GROUP">FROM_GROUP</A></B></CODE>
+
+<BR>
+ Constant that indicates the discovery mechanism is group discovery</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static int</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupDiscoveryManager.html#FROM_LOCATOR">FROM_LOCATOR</A></B></CODE>
+
+<BR>
+ Constant that indicates the discovery mechanism is locator discovery</TD>
+</TR>
+</TABLE>
+ <A NAME="fields_inherited_from_class_net.jini.discovery.DiscoveryGroupManagement"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Fields inherited from interface net.jini.discovery.<A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html" title="interface in net.jini.discovery">DiscoveryGroupManagement</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html#ALL_GROUPS">ALL_GROUPS</A>, <A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html#NO_GROUPS">NO_GROUPS</A></CODE></TD>
+</TR>
+</TABLE>
+
+<!-- ======== 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/LookupDiscoveryManager.html#LookupDiscoveryManager(java.lang.String[], net.jini.core.discovery.LookupLocator[], net.jini.discovery.DiscoveryListener)">LookupDiscoveryManager</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>[] groups,
+ <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators,
+ <A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery">DiscoveryListener</A> listener)</CODE>
+
+<BR>
+ Constructs an instance of this class that will organize and manage
+ all discovery-related activities on behalf of the client or service
+ that instantiates this class.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupDiscoveryManager.html#LookupDiscoveryManager(java.lang.String[], net.jini.core.discovery.LookupLocator[], net.jini.discovery.DiscoveryListener, net.jini.config.Configuration)">LookupDiscoveryManager</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>[] groups,
+ <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators,
+ <A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery">DiscoveryListener</A> listener,
+ <A HREF="../../../net/jini/config/Configuration.html" title="interface in net.jini.config">Configuration</A> config)</CODE>
+
+<BR>
+ Constructs an instance of this class, using the given
+ <code>Configuration</code>, that will organize and manage all
+ discovery-related activities on behalf of the client or service
+ that instantiates this class.</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/LookupDiscoveryManager.html#addDiscoveryListener(net.jini.discovery.DiscoveryListener)">addDiscoveryListener</A></B>(<A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery">DiscoveryListener</A> listener)</CODE>
+
+<BR>
+ Adds an instance of <code>DiscoveryListener</code> to the set of
+ objects listening for discovery events.</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/LookupDiscoveryManager.html#addGroups(java.lang.String[])">addGroups</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>[] groups)</CODE>
+
+<BR>
+ Adds a set of group names to the managed set of groups.</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/LookupDiscoveryManager.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/LookupDiscoveryManager.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> int</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupDiscoveryManager.html#getFrom(net.jini.core.lookup.ServiceRegistrar)">getFrom</A></B>(<A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A> proxy)</CODE>
+
+<BR>
+ Return where the proxy come from.</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/discovery/LookupDiscoveryManager.html#getGroups()">getGroups</A></B>()</CODE>
+
+<BR>
+ Returns an array consisting of the elements of the managed set
+ of groups; that is, the names of the groups whose members are the
+ lookup services 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/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupDiscoveryManager.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/LookupDiscoveryManager.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> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupDiscoveryManager.html#removeDiscoveryListener(net.jini.discovery.DiscoveryListener)">removeDiscoveryListener</A></B>(<A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery">DiscoveryListener</A> listener)</CODE>
+
+<BR>
+ Removes a listener from the set of objects listening for discovery
+ events.</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/LookupDiscoveryManager.html#removeGroups(java.lang.String[])">removeGroups</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>[] groups)</CODE>
+
+<BR>
+ Deletes a set of group names from the managed set of groups.</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/LookupDiscoveryManager.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/LookupDiscoveryManager.html#setGroups(java.lang.String[])">setGroups</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>[] groups)</CODE>
+
+<BR>
+ Replaces all of the group names in the managed set with names from
+ a new 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/LookupDiscoveryManager.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/LookupDiscoveryManager.html#terminate()">terminate</A></B>()</CODE>
+
+<BR>
+ Terminates all threads, ending all 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>
+
+<!-- ============ FIELD DETAIL =========== -->
+
+<A NAME="field_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>Field Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="FROM_GROUP"><!-- --></A><H3>
+FROM_GROUP</H3>
+<PRE>
+public static final int <B>FROM_GROUP</B></PRE>
+<DL>
+<DD>Constant that indicates the discovery mechanism is group discovery
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#net.jini.discovery.LookupDiscoveryManager.FROM_GROUP">Constant Field Values</A></DL>
+</DL>
+<HR>
+
+<A NAME="FROM_LOCATOR"><!-- --></A><H3>
+FROM_LOCATOR</H3>
+<PRE>
+public static final int <B>FROM_LOCATOR</B></PRE>
+<DL>
+<DD>Constant that indicates the discovery mechanism is locator discovery
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#net.jini.discovery.LookupDiscoveryManager.FROM_LOCATOR">Constant Field Values</A></DL>
+</DL>
+
+<!-- ========= 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="LookupDiscoveryManager(java.lang.String[], net.jini.core.discovery.LookupLocator[], net.jini.discovery.DiscoveryListener)"><!-- --></A><H3>
+LookupDiscoveryManager</H3>
+<PRE>
+public <B>LookupDiscoveryManager</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>[] groups,
+ <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators,
+ <A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery">DiscoveryListener</A> listener)
+ 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>Constructs an instance of this class that will organize and manage
+ all discovery-related activities on behalf of the client or service
+ that instantiates this class.
+ <p>
+ If <code>null</code> (<code>DiscoveryGroupManagement.ALL_GROUPS</code>)
+ is input to the <code>groups</code> parameter, then attempts will be
+ made via group discovery to discover all lookup services located within
+ range of the entity that constructs this class. If the empty array
+ (<code>DiscoveryGroupManagement.NO_GROUPS</code>) is input to that
+ parameter, no group discovery will be performed until the set of
+ groups to discover is populated.
+ <p>
+ If an empty array or a <code>null</code> reference is input to the
+ <code>locators</code> parameter, no locator discovery will be performed
+ until the set of locators to discover is populated.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>groups</CODE> - <code>String</code> array, none of whose elements may
+ be <code>null</code>, consisting of the names of the
+ groups whose members are lookup services the client
+ or service wishes to discover.<DD><CODE>locators</CODE> - array of instances of <code>LookupLocator</code>, none
+ of whose elements may be <code>null</code>, and in
+ which each element corresponds to a specific lookup
+ service the client or service wishes to discover via
+ locator discovery.<DD><CODE>listener</CODE> - a reference to <code>DiscoveryListener</code> object
+ that will be notified when a targeted lookup service
+ is discovered or discarded.
+<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> - because construction of this class may
+ initiate the discovery process, which can throw an
+ <code>IOException</code> when socket allocation occurs.
+<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 one or more of the elements of the <code>groups</code>
+ parameter is <code>null</code>, or one or more elements of
+ the <code>locators</code> parameter is null.<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>,
+<A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery"><CODE>DiscoveryListener</CODE></A></DL>
+</DL>
+<HR>
+
+<A NAME="LookupDiscoveryManager(java.lang.String[], net.jini.core.discovery.LookupLocator[], net.jini.discovery.DiscoveryListener, net.jini.config.Configuration)"><!-- --></A><H3>
+LookupDiscoveryManager</H3>
+<PRE>
+public <B>LookupDiscoveryManager</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>[] groups,
+ <A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators,
+ <A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery">DiscoveryListener</A> listener,
+ <A HREF="../../../net/jini/config/Configuration.html" title="interface in net.jini.config">Configuration</A> config)
+ 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>,
+ <A HREF="../../../net/jini/config/ConfigurationException.html" title="class in net.jini.config">ConfigurationException</A></PRE>
+<DL>
+<DD>Constructs an instance of this class, using the given
+ <code>Configuration</code>, that will organize and manage all
+ discovery-related activities on behalf of the client or service
+ that instantiates this class.
+ <p>
+ If <code>null</code> (<code>DiscoveryGroupManagement.ALL_GROUPS</code>)
+ is input to the <code>groups</code> parameter, then attempts will be
+ made via group discovery to discover all lookup services located within
+ range of the entity that constructs this class. If the empty array
+ (<code>DiscoveryGroupManagement.NO_GROUPS</code>) is input to that
+ parameter, no group discovery will be performed until the set of
+ groups to discover is populated.
+ <p>
+ If an empty array or a <code>null</code> reference is input to the
+ <code>locators</code> parameter, no locator discovery will be performed
+ until the set of locators to discover is populated.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>groups</CODE> - <code>String</code> array, none of whose elements may
+ be <code>null</code>, consisting of the names of the
+ groups whose members are lookup services the client
+ or service wishes to discover.<DD><CODE>locators</CODE> - array of instances of <code>LookupLocator</code>, none
+ of whose elements may be <code>null</code>, and in
+ which each element corresponds to a specific lookup
+ service the client or service wishes to discover via
+ locator discovery.<DD><CODE>listener</CODE> - a reference to <code>DiscoveryListener</code> object
+ that will be notified when a targeted lookup service
+ is discovered or discarded.<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="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - because construction of this class may
+ initiate the discovery process, which can throw an
+ <code>IOException</code> when socket allocation occurs.
+<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> - this exception occurs when
+ either one or more of the elements of the <code>groups</code>
+ parameter is <code>null</code>, or one or more elements of
+ the <code>locators</code> parameter is <code>null</code>, or
+ when <code>null</code> is input for the configuration.<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>,
+<A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery"><CODE>DiscoveryListener</CODE></A>,
+<A HREF="../../../net/jini/config/Configuration.html" title="interface in net.jini.config"><CODE>Configuration</CODE></A></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="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>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryLocatorManagement.html#getLocators()"><CODE>DiscoveryLocatorManagement.getLocators()</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupDiscoveryManager.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/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - this exception
+ occurs when there is no managed set of locators to augment.
+ That is, the current managed set of locators is
+ <code>null</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> - 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>.<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/LookupDiscoveryManager.html#removeLocators(net.jini.core.discovery.LookupLocator[])"><CODE>removeLocators(net.jini.core.discovery.LookupLocator[])</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/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - this exception
+ occurs when there is no managed set of locators from which
+ remove elements.
+<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 <code>locators</code>
+ parameter.<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/LookupDiscoveryManager.html#addLocators(net.jini.core.discovery.LookupLocator[])"><CODE>addLocators(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
+ <code>null</code> is input to the <code>locators</code>
+ parameter.<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/LookupDiscoveryManager.html#getLocators()"><CODE>getLocators()</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getGroups()"><!-- --></A><H3>
+getGroups</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>getGroups</B>()</PRE>
+<DL>
+<DD>Returns an array consisting of the elements of the managed set
+ of groups; that is, the names of the groups whose members are the
+ lookup services to discover. If the managed set of groups is empty,
+ this method will return the empty array. If there is no managed set
+ of groups, then null is returned; indicating that all groups are to
+ be discovered. This method returns a new array upon each invocation.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html#getGroups()">getGroups</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html" title="interface in net.jini.discovery">DiscoveryGroupManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD><code>String</code> array consisting of the elements of the
+ managed set of groups<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html#getGroups()"><CODE>DiscoveryGroupManagement.getGroups()</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupDiscoveryManager.html#setGroups(java.lang.String[])"><CODE>setGroups(java.lang.String[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="addGroups(java.lang.String[])"><!-- --></A><H3>
+addGroups</H3>
+<PRE>
+public void <B>addGroups</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>[] groups)
+ 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>Adds a set of group names to the managed set of groups. Elements in
+ the input set that duplicate elements already in the managed set
+ will be ignored. Once a new name is added to the managed set,
+ attempts will be made to discover all (as yet) undiscovered lookup
+ services that are members of the group having that name. If the empty
+ array (<code>DiscoveryGroupManagement.NO_GROUPS</code>) is input, the
+ managed set of groups will not change.
+
+ Note that any entity that invokes this method must have
+ <code>DiscoveryPermission</code> on each of the groups in the
+ new set, otherwise a <code>SecurityException</code> will be
+ propagated through this method.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html#addGroups(java.lang.String[])">addGroups</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html" title="interface in net.jini.discovery">DiscoveryGroupManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>groups</CODE> - <code>String</code> array consisting of the group names
+ 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/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - because an invocation of this method may
+ result in the re-initiation of the discovery process, which can
+ throw an <code>IOException</code> when socket allocation occurs.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - this exception
+ occurs when there is no managed set of groups to augment.
+ That is, the current managed set of groups is <code>null</code>.
+ If the managed set of groups is <code>null</code>, all groups
+ are being discovered; thus, requesting that a set of groups be
+ added to the set of all groups makes no sense.
+<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>groups</code>
+ parameter, or one or more of the elements of the
+ <code>groups</code> parameter is <code>null</code>. If a
+ <code>null</code> is input, then the entity is effectively
+ requesting that "all groups" be added to the current managed
+ set of groups; which is not allowed. (Note that if the entity
+ wishes to change the managed set of groups from a finite set
+ of names to "all groups", the <code>setGroups</code> method
+ should be invoked with <code>null</code> input.)<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html#addGroups(java.lang.String[])"><CODE>DiscoveryGroupManagement.addGroups(java.lang.String[])</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupDiscoveryManager.html#removeGroups(java.lang.String[])"><CODE>removeGroups(java.lang.String[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="removeGroups(java.lang.String[])"><!-- --></A><H3>
+removeGroups</H3>
+<PRE>
+public void <B>removeGroups</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>[] groups)</PRE>
+<DL>
+<DD>Deletes a set of group names from the managed set of groups. If the
+ empty array (<code>DiscoveryGroupManagement.NO_GROUPS</code>) is input,
+ this method takes no action.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html#removeGroups(java.lang.String[])">removeGroups</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html" title="interface in net.jini.discovery">DiscoveryGroupManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>groups</CODE> - <code>String</code> array consisting of the group names
+ 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/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - this exception
+ occurs when there is no managed set of groups from which to
+ remove elements.
+<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 <code>groups</code>
+ parameter.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html#removeGroups(java.lang.String[])"><CODE>DiscoveryGroupManagement.removeGroups(java.lang.String[])</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupDiscoveryManager.html#addGroups(java.lang.String[])"><CODE>addGroups(java.lang.String[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setGroups(java.lang.String[])"><!-- --></A><H3>
+setGroups</H3>
+<PRE>
+public void <B>setGroups</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>[] groups)
+ 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>Replaces all of the group names in the managed set with names from
+ a new set. Once a new group name has been placed in the managed
+ set, if there are lookup services belonging to that group that have
+ already been discovered, no event will be sent to the entity's
+ listener for those particular lookup services. Attempts to discover
+ all (as yet) undiscovered lookup services belonging to that group
+ will continue to be made.
+ <p>
+ If null (<code>DiscoveryGroupManagement.ALL_GROUPS</code>) is input
+ to this method, then attempts will be made to discover all (as yet)
+ undiscovered lookup services that are within range, and which
+ are members of any group. If the empty array
+ (<code>DiscoveryGroupManagement.NO_GROUPS</code>) is input, then
+ group discovery will cease until this method is invoked with an
+ input parameter that is non-<code>null</code> and non-empty.
+
+ Note that any entity that invokes this method must have
+ <code>DiscoveryPermission</code> on each of the groups in the
+ new set, otherwise a <code>SecurityException</code> will be
+ propagated through this method.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html#setGroups(java.lang.String[])">setGroups</A></CODE> in interface <CODE><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html" title="interface in net.jini.discovery">DiscoveryGroupManagement</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>groups</CODE> - <code>String</code> array consisting of the group
+ names that will replace the current names in the
+ managed set.
+<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> - because an invocation of this method may
+ result in the re-initiation of the discovery process, which can
+ throw an <code>IOException</code> when socket allocation occurs.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryGroupManagement.html#setGroups(java.lang.String[])"><CODE>DiscoveryGroupManagement.setGroups(java.lang.String[])</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupDiscoveryManager.html#getGroups()"><CODE>getGroups()</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<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> listener)</PRE>
+<DL>
+<DD>Adds an instance of <code>DiscoveryListener</code> to the set of
+ objects listening for discovery events. Once the listener is
+ registered, it will be notified of all lookup services discovered
+ to date, and will then be notified as new lookup services are
+ discovered or existing lookup services are discarded.
+ <p>
+ If <code>null</code> is input, this method takes no action. If the
+ listener input to this method duplicates (using the <code>equals</code>
+ method) another element in the current set of listeners, no action
+ is taken.
+<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>listener</CODE> - an instance of <code>DiscoveryListener</code>
+ corresponding to the listener to add to the set of
+ listeners.
+<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 <code>listener</code>
+ parameter.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery"><CODE>DiscoveryListener</CODE></A>,
+<A HREF="../../../net/jini/discovery/DiscoveryManagement.html#addDiscoveryListener(net.jini.discovery.DiscoveryListener)"><CODE>DiscoveryManagement.addDiscoveryListener(net.jini.discovery.DiscoveryListener)</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupDiscoveryManager.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> listener)</PRE>
+<DL>
+<DD>Removes a listener from the set of objects listening for discovery
+ events. If the listener object input to this method does not exist
+ in the set of listeners, then this method will take no action.
+<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>listener</CODE> - an instance of <code>DiscoveryListener</code>
+ corresponding to the listener to remove from the set
+ of listeners.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/DiscoveryListener.html" title="interface in net.jini.discovery"><CODE>DiscoveryListener</CODE></A>,
+<A HREF="../../../net/jini/discovery/DiscoveryManagement.html#removeDiscoveryListener(net.jini.discovery.DiscoveryListener)"><CODE>DiscoveryManagement.removeDiscoveryListener(net.jini.discovery.DiscoveryListener)</CODE></A>,
+<A HREF="../../../net/jini/discovery/LookupDiscoveryManager.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>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>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 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="getFrom(net.jini.core.lookup.ServiceRegistrar)"><!-- --></A><H3>
+getFrom</H3>
+<PRE>
+public int <B>getFrom</B>(<A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A> proxy)</PRE>
+<DL>
+<DD>Return where the proxy come from.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>proxy</CODE> - a ServiceRegistrar object
+<DT><B>Returns:</B><DD>an <code>int</code> indicating whether the proxy
+ was obtained through group or locator discovery.</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/LookupDiscoveryManager.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/LookupDiscovery.html" title="class in net.jini.discovery"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html" title="interface 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/LookupDiscoveryManager.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LookupDiscoveryManager.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 | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | <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>