You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by si...@apache.org on 2010/12/24 21:37:45 UTC
svn commit: r1052601 [7/10] - in
/incubator/river/site/trunk/content/river/doc/api/net/jini/discovery: ./
class-use/
Added: incubator/river/site/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryRegistration.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryRegistration.html?rev=1052601&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryRegistration.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryRegistration.html Fri Dec 24 20:37:44 2010
@@ -0,0 +1,876 @@
+<!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>
+LookupDiscoveryRegistration (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.discovery.LookupDiscoveryRegistration interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="LookupDiscoveryRegistration (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/LookupDiscoveryRegistration.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/LookupDiscoveryManager.html" title="class in net.jini.discovery"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/discovery/LookupDiscoveryService.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/LookupDiscoveryRegistration.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LookupDiscoveryRegistration.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 | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <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>
+Interface LookupDiscoveryRegistration</H2>
+<HR>
+<DL>
+<DT><PRE>public interface <B>LookupDiscoveryRegistration</B></DL>
+</PRE>
+
+<P>
+When a client requests a registration with a lookup discovery service,
+ an instance of this interface is returned. It is through this interface
+ that the client manages the parameters reflected in its registration
+ with the lookup discovery service.
+ <p>
+ This interface is not a remote interface; each implementation of the
+ lookup discovery service exports proxy objects that implement this
+ interface local to the client, using an implementation-specific protocol
+ to communicate with the actual remote server. The proxy methods obey
+ normal RMI remote interface semantics except where explicitly noted. Two
+ proxy objects are equal if they are proxies for the same registration
+ created by the same lookup discovery service.
+ <p>
+ If a client's registration with the lookup discovery service has expired
+ or been cancelled, then any invocation of a remote method defined in this
+ interface will result in a java.rmi.NoSuchObjectException.
+ <p>
+ Each remote method of this interface may throw a RemoteException.
+ Typically, this exception occurs when there is a communication failure
+ between the client's registration object and the lookup discovery service.
+ Whenever this exception occurs as a result of the invocation of one of
+ these methods, the method may or may not have completed its processing
+ successfully.
+<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="../../../net/jini/discovery/LookupDiscoveryService.html" title="interface in net.jini.discovery"><CODE>LookupDiscoveryService</CODE></A></DL>
+<HR>
+
+<P>
+
+<!-- ========== 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/LookupDiscoveryRegistration.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 associated
+ with this registration.</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/LookupDiscoveryRegistration.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 LookupLocator objects to the managed set of locators
+ associated with this registration.</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/LookupDiscoveryRegistration.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> registrar)</CODE>
+
+<BR>
+ Informs the lookup discovery service of the existence of an
+ unavailable lookup service and requests that the lookup discovery
+ service discard the unavailable lookup service.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event">EventRegistration</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html#getEventRegistration()">getEventRegistration</A></B>()</CODE>
+
+<BR>
+ Returns an EventRegistration object that encapsulates the information
+ needed by the client to identify a notification sent by the lookup
+ discovery service to the registration's listener.</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/LookupDiscoveryRegistration.html#getGroups()">getGroups</A></B>()</CODE>
+
+<BR>
+ Returns an array consisting of the names of the groups whose members
+ are lookup services the lookup discovery service will attempt to
+ discover for this registration.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html#getLease()">getLease</A></B>()</CODE>
+
+<BR>
+ Returns the Lease object that controls a client's registration with
+ the lookup discovery service.</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/LookupDiscoveryRegistration.html#getLocators()">getLocators</A></B>()</CODE>
+
+<BR>
+ Returns an array consisting of the LookupLocator objects corresponding
+ to specific lookup services the lookup discovery service will attempt
+ to discover for this registration.</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/LookupDiscoveryRegistration.html#getRegistrars()">getRegistrars</A></B>()</CODE>
+
+<BR>
+ Returns an array consisting of instances of the ServiceRegistrar
+ interface.</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/LookupDiscoveryRegistration.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 this registration's 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/LookupDiscoveryRegistration.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 of LookupLocator objects from this registration's
+ 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/LookupDiscoveryRegistration.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 this registration's managed set of
+ groups with new set of names.</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/LookupDiscoveryRegistration.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 this registration's managed set of
+ locators with a new set of LookupLocator objects.</TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ 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="getEventRegistration()"><!-- --></A><H3>
+getEventRegistration</H3>
+<PRE>
+<A HREF="../../../net/jini/core/event/EventRegistration.html" title="class in net.jini.core.event">EventRegistration</A> <B>getEventRegistration</B>()</PRE>
+<DL>
+<DD>Returns an EventRegistration object that encapsulates the information
+ needed by the client to identify a notification sent by the lookup
+ discovery service to the registration's listener. This method is
+ not remote and takes no arguments.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the EventRegistration for this registration.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLease()"><!-- --></A><H3>
+getLease</H3>
+<PRE>
+<A HREF="../../../net/jini/core/lease/Lease.html" title="interface in net.jini.core.lease">Lease</A> <B>getLease</B>()</PRE>
+<DL>
+<DD>Returns the Lease object that controls a client's registration with
+ the lookup discovery service. It is through the object returned by
+ this method that the client can request the renewal or cancellation
+ of the registration with the lookup discovery service. This method is
+ not remote and takes no arguments.
+ <p>
+ Note that the object returned by the getEventRegistration method also
+ provides a getLease method. That method and this method both return
+ the same Lease object. This method is provided as a convenience to
+ avoid the indirection associated with the getLease method on the
+ EventRegistration object, as well as to avoid the overhead of making
+ two method calls when retrieving the lease.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the Lease on this registration.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getRegistrars()"><!-- --></A><H3>
+getRegistrars</H3>
+<PRE>
+<A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A>[] <B>getRegistrars</B>()
+ throws <A HREF="../../../net/jini/discovery/LookupUnmarshalException.html" title="class in net.jini.discovery">LookupUnmarshalException</A>,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Returns an array consisting of instances of the ServiceRegistrar
+ interface. Each element in the returned set is a proxy to one of
+ lookup service(s) that have already been discovered for this
+ registration. The contents of the returned set make up the 'remote
+ state' of this registration's currently discovered lookup service(s).
+ This method returns a new array on each invocation.
+ <p>
+ This method can be used to maintain synchronization between the set
+ of discovered lookup services making up a registration's local state
+ on the client and the registration's corresponding remote state
+ maintained by the lookup discovery service. The local state can
+ become un-synchronized with the remote state when a gap occurs in
+ the events received by the registration's listener.
+ <p>
+ According to the event semantics, if there is no gap between two
+ sequence numbers, no events have been missed and the states remain
+ synchronized; if there is a gap, events may or may not have been
+ missed. Thus, upon finding gaps in the sequence of events, the
+ client can invoke this method and use the returned information to
+ synchronize the local state with the remote state.
+ <p>
+ This method requests that the lookup discovery service return the set
+ of proxies to the lookup services currently discovered for the
+ the particular registration object on which this method is invoked.
+ When the lookup discovery service receives such a request, it sends
+ the requested set of proxies as a set of marshalled instances of the
+ ServiceRegistrar interface. Thus, in order to construct the return
+ set, this method attempts to unmarshal each element of the set
+ received from the lookup discovery service. Should a failure occur
+ while attempting to unmarshal any of the elements of the received
+ set of marshalled proxy objects, this method will throw an exception
+ of type LookupUnmarshalException.
+ <p>
+ When a LookupUnmarshalException is thrown by this method, the
+ contents of the exception provides the client with the following
+ useful information: (1) the knowledge that a problem has occurred
+ while unmarshalling at least one of the elements making up the
+ remote state of this registration's discovered lookup service(s),
+ (2) the set consisting of the proxy objects that were successfully
+ unmarshalled by this method, (3) the set consisting of the marshalled
+ proxy objects that could not be unmarshalled by this method, and
+ (4) the set of exceptions corresponding to each failed attempt at
+ unmarshalling.
+ <p>
+ Typically, the type of exception that occurs when attempting to
+ unmarshal an element of the set of marshalled proxies is either an
+ IOException or a ClassNotFoundException. A ClassNotFoundException
+ occurs whenever a remote field of the marshalled proxy cannot be
+ retrieved (usually because the codebase of one of the field's classes
+ or interfaces is currently 'down'). To address this situation, the
+ client may wish to proceed with its processing using the successfully
+ unmarshalled proxies; and attempt to unmarshal the unavailable proxies
+ (or re-invoke this method) at some later time.
+ <p>
+ Note that if this method returns successfully without throwing a
+ LookupUnmarshalException, the client is guaranteed that all
+ marshalled proxies returned to this method by the lookup discovery
+ service have been successfully unmarshalled; and the client then
+ has a snapshot - relative to the point in time when this method
+ is invoked - of the remote state of the lookup service(s) discovered
+ for this registration.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>an array of ServiceRegistrar objects.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../net/jini/discovery/LookupUnmarshalException.html" title="class in net.jini.discovery">LookupUnmarshalException</A></CODE> - this exception
+ is thrown when failure occurs while attempting to unmarshal
+ one or more of the marshalled instances of ServiceRegistrar
+ received from the lookup discovery service.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getGroups()"><!-- --></A><H3>
+getGroups</H3>
+<PRE>
+<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>()
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Returns an array consisting of the names of the groups whose members
+ are lookup services the lookup discovery service will attempt to
+ discover for this registration. This set of group names is referred
+ to as the registration's 'managed set of groups'.
+ <p>
+ If the registration's managed set of groups is currently empty, this
+ method will return the empty array. If the lookup discovery service
+ has no managed set of groups associated with this registration, this
+ method will return null.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>a String array containing the elements of the managed set of
+ groups for the registration.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html#setGroups(java.lang.String[])"><CODE>setGroups(java.lang.String[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLocators()"><!-- --></A><H3>
+getLocators</H3>
+<PRE>
+<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] <B>getLocators</B>()
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Returns an array consisting of the LookupLocator objects corresponding
+ to specific lookup services the lookup discovery service will attempt
+ to discover for this registration. This set of locators is referred
+ to as the registration's 'managed set of locators'.
+ <p>
+ If the registration's managed set of locators is currently empty, this
+ method will return the empty array. If the lookup discovery service
+ has no managed set of locators associated with this registration,
+ this method will return null.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>array consisting of net.jini.core.discovery.LookupLocator
+ objects corresponding to the elements of the managed set of
+ locators for the registration.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html#setLocators(net.jini.core.discovery.LookupLocator[])"><CODE>setLocators(net.jini.core.discovery.LookupLocator[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="addGroups(java.lang.String[])"><!-- --></A><H3>
+addGroups</H3>
+<PRE>
+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/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Adds a set of group names to the managed set of groups associated
+ with this registration.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>groups</CODE> - a String array, none of whose elements may be null,
+ consisting of the group names with which to augment this
+ registration's managed set of groups.
+ <p>
+ If any element of this parameter duplicates any other
+ element of this parameter, the duplicate will be ignored.
+ If any element of this parameter duplicates any element
+ of the registration's current managed set of groups,
+ the duplicate will be ignored.
+ <p>
+ If the empty set (equivalent to
+ net.jini.discovery.LookupDiscovery.NO_GROUPS) is input,
+ then this registration's managed set of groups will not
+ change.
+ <p>
+ If null (equivalent to
+ net.jini.discovery.LookupDiscovery.ALL_GROUPS) is
+ input, this method will throw a NullPointerException.
+<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 the lookup discovery service has no managed set of groups
+ associated with this registration.
+<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 null (net.jini.discovery.LookupDiscovery.ALL_GROUPS)
+ is input to the groups parameter, or one or more of the
+ elements of the groups parameter is null.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service. When this exception does occur, this
+ registration's managed set of groups may or may not have been
+ successfully augmented.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html#removeGroups(java.lang.String[])"><CODE>removeGroups(java.lang.String[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setGroups(java.lang.String[])"><!-- --></A><H3>
+setGroups</H3>
+<PRE>
+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/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Replaces all of the group names in this registration's managed set of
+ groups with new set of names.
+ <p>
+ 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 this registration'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 for this registration.
+ <p>
+ After an invocation of this method results in the removal (due to
+ replacement) of one or more group names from the registration's
+ managed set of groups, attempts to discover any lookup service that
+ meets all of the following criteria will cease to be made for this
+ registration: the lookup service is a member of one or more of the
+ removed group(s), but that lookup service is neither a member of
+ any group in the resulting managed set of groups, nor does that
+ lookup service correspond to any element in the registration's
+ managed set of locators.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>groups</CODE> - a String array, none of whose elements may be null,
+ consisting of the group names with which to replace the
+ names in this registration's managed set of groups.
+ <p>
+ If any element of this parameter duplicates any other
+ element of this parameter, the duplicate will be ignored.
+ <p>
+ If the empty set (equivalent to
+ net.jini.discovery.LookupDiscovery.NO_GROUPS) is input,
+ then group discovery for this registration will cease.
+ <p>
+ If null (equivalent to
+ net.jini.discovery.LookupDiscovery.ALL_GROUPS) is
+ input, the lookup discovery service will attempt to
+ discover all as yet undiscovered lookup services located
+ within its multicast radius and, upon discovery of any
+ such lookup service, will send to this registration's
+ listener an event signaling that discovery.
+<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 one
+ or more of the elements of the groups parameter is null.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service. When this exception does occur, this
+ registration's managed set of groups may or may not have been
+ successfully replaced.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html#getGroups()"><CODE>getGroups()</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="removeGroups(java.lang.String[])"><!-- --></A><H3>
+removeGroups</H3>
+<PRE>
+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)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Deletes a set of group names from this registration's managed set of
+ groups.
+ <p>
+ After an invocation of this method results in the removal of one
+ or more group names from the registration's managed set of groups,
+ attempts to discover any lookup service that satisfies the following
+ condition will cease to be made for this registration: the lookup
+ service is a member of one or more of the removed group(s), but that
+ lookup service is neither a member of any group in the resulting
+ managed set of groups, nor does that lookup service correspond to
+ any element in the registration's managed set of locators.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>groups</CODE> - a String array, none of whose elements may be null,
+ consisting of the group names to delete from this
+ registration's managed set of groups.
+ <p>
+ If any element of this parameter duplicates any other
+ element of this parameter, the duplicate will be ignored.
+ <p>
+ If the empty set (equivalent to
+ net.jini.discovery.LookupDiscovery.NO_GROUPS) is input,
+ the registration's managed set of groups will not change.
+ <p>
+ If null (equivalent to
+ net.jini.discovery.LookupDiscovery.ALL_GROUPS) is
+ input, this method will throw a NullPointerException.
+<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 the lookup discovery service has no managed set of groups
+ associated with this registration.
+<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 null (net.jini.discovery.LookupDiscovery.ALL_GROUPS)
+ is input to the groups parameter, or one or more of the
+ elements of the groups parameter is null.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service. When this exception does occur, this
+ registration's managed set of groups may or may not have been
+ successfully modified.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html#addGroups(java.lang.String[])"><CODE>addGroups(java.lang.String[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="addLocators(net.jini.core.discovery.LookupLocator[])"><!-- --></A><H3>
+addLocators</H3>
+<PRE>
+void <B>addLocators</B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Adds a set of LookupLocator objects to the managed set of locators
+ associated with this registration.
+ <p>
+ For any new locator placed in the registration's managed set of
+ locators as a result of an invocation of this method, if that
+ locator equals no other locator corresponding to a previously
+ discovered lookup service (across all registrations), the lookup
+ discovery service will attempt unicast discovery of the lookup
+ service associated with the new locator.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>locators</CODE> - an array, none of whose elements may be null, consisting
+ of the LookupLocator objects with which to augment
+ this registration's managed set of locators.
+ <p>
+ If any element of this parameter duplicates any other
+ element of this parameter, the duplicate will be
+ ignored. If any element of this parameter duplicates
+ any element of this registration's managed set of
+ locators, the duplicate will be ignored.
+ <p>
+ If the empty array is input, then this registration's
+ managed set of locators will not change. If null is
+ input, this method will throw a NullPointerException.
+<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 the lookup discovery service has no managed set of
+ locators associated with this registration.
+<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 null is input to the locators parameter, or one or
+ more of the elements of the locators parameter is null.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service. When this exception does occur, this
+ registration's managed set of locators may or may not have
+ been successfully augmented.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.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>
+void <B>setLocators</B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Replaces all of the locators in this registration's managed set of
+ locators with a new set of LookupLocator objects.
+ <p>
+ For any new locator placed in the managed set of locators as a result
+ of an invocation of this method, if that locator equals no other
+ locator corresponding to a previously discovered lookup service
+ (across all registrations), the lookup discovery service will attempt
+ unicast discovery of the lookup service associated with the new locator.
+ <p>
+ After an invocation of this method results in the removal (due to
+ replacement) of a locator from the registration's managed set of
+ locators, the action taken by the lookup discovery service can be
+ described as follows: if the lookup service corresponding to the
+ removed locator has yet to be discovered for this registration,
+ attempts to perform locator discovery of that lookup service will
+ cease; if that lookup service has already been discovered for this
+ registration through locator discovery, but not through group
+ discovery, the lookup service will be discarded.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>locators</CODE> - an array, none of whose elements may be null, consisting
+ of the LookupLocator objects with which to replace the
+ locators in this registration's managed set of locators.
+ <p>
+ If any element of this parameter duplicates any other
+ element of this parameter, the duplicate will be
+ ignored.
+ <p>
+ If the empty array is input, then locator discovery for
+ this registration will cease. If null is input, this
+ method will throw a NullPointerException.
+<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 null is input to the locators parameter, or one or
+ more of the elements of the locators parameter is null.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service. When this exception does occur, this
+ registration's managed set of locators may or may not have
+ been successfully replaced.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html#getLocators()"><CODE>getLocators()</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="removeLocators(net.jini.core.discovery.LookupLocator[])"><!-- --></A><H3>
+removeLocators</H3>
+<PRE>
+void <B>removeLocators</B>(<A HREF="../../../net/jini/core/discovery/LookupLocator.html" title="class in net.jini.core.discovery">LookupLocator</A>[] locators)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Deletes a set of of LookupLocator objects from this registration's
+ managed set of locators.
+ <p>
+ After an invocation of this method results in the removal of a
+ locator from the registration's managed set of locators, the action
+ taken by the lookup discovery service can be described as follows:
+ if the lookup service corresponding to the removed locator has yet
+ to be discovered for this registration, attempts to perform locator
+ discovery of that lookup service will cease; if that lookup service
+ has already been discovered for this registration through locator
+ discovery, but not through group discovery, the lookup service will
+ be discarded.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>locators</CODE> - an array, none of whose elements may be null, consisting
+ of the LookupLocator objects to remove from this
+ registration's managed set of locators.
+ <p>
+ If any element of this parameter duplicates any other
+ element of this parameter, the duplicate will be
+ ignored.
+ <p>
+ If the empty set is input, the managed set of locators
+ will not change. If null is input, this method will
+ throw a NullPointerException.
+<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 the lookup discovery service has no managed set of
+ locators associated with this registration.
+<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 null is input to the locators parameter, or one or
+ more of the elements of the locators parameter is null.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service. When this exception does occur, this
+ registration's managed set of locators may or may not have
+ been successfully modified.<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html#addLocators(net.jini.core.discovery.LookupLocator[])"><CODE>addLocators(net.jini.core.discovery.LookupLocator[])</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="discard(net.jini.core.lookup.ServiceRegistrar)"><!-- --></A><H3>
+discard</H3>
+<PRE>
+void <B>discard</B>(<A HREF="../../../net/jini/core/lookup/ServiceRegistrar.html" title="interface in net.jini.core.lookup">ServiceRegistrar</A> registrar)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Informs the lookup discovery service of the existence of an
+ unavailable lookup service and requests that the lookup discovery
+ service discard the unavailable lookup service.
+ <p>
+ When the lookup discovery service removes an already-discovered lookup
+ service from a registration's managed set of lookup services and
+ makes the lookup service eligible for re-discovery, the lookup service
+ is considered to be "discarded". There are a number of situations where
+ the lookup discovery service will discard a lookup service.
+ <p>
+ The lookup discovery service will discard a lookup service in response
+ to a discard request resulting from an invocation of this method.
+ <p>
+ The lookup discovery service will discard a lookup service when the
+ lookup service - previously discovered through locator discovery - is
+ removed from a registration's managed set of locators in response to
+ an invocation of either the setLocators method or the removeLocators
+ method.
+ <p>
+ The lookup discovery service will discard a lookup service when the
+ multicast announcements from an already-discovered lookup service
+ are no longer being received.
+ <p>
+ Whenever the lookup discovery service discards a lookup service
+ previously discovered for this registration, it will send an event
+ to this registration's listener indicating that the lookup service
+ has been discarded.
+ <p>
+ Note that if a lookup service crashes or is unavailable for some
+ reason, there will be no automatic notification of the occurrence
+ of such an event. This means that for each of a registration's
+ targeted lookup services, after a lookup service is initially
+ discovered, the lookup discovery service will not attempt to discover
+ that lookup service again (for that registration) until that lookup
+ service is discarded.
+ <p>
+ Thus, when a client determines that lookup service discovered for a
+ registration is no longer available, it is the responsibility of the
+ client to inform the lookup discovery service - through the invocation
+ of this method - that the previously discovered lookup service is no
+ longer available, and that attempts should be made to re-discover that
+ lookup service for the registration. Typically, a client determines
+ that a lookup service is unavailable when the client attempts to use
+ the lookup service but receives a non-fatal exception or error
+ (for example, a RemoteException) as a result of the attempt.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>registrar</CODE> - a reference to the lookup service that the lookup
+ discovery service is being asked to discard.
+ <p>
+ If this parameter equals none of the lookup services
+ contained in the managed set of lookup services for
+ this registration, no action will be taken.
+<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
+ null is input to the registrar parameter.
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service. When this exception does occur,
+ the lookup service may or may not have been successfully
+ discarded.</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/LookupDiscoveryRegistration.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/LookupDiscoveryManager.html" title="class in net.jini.discovery"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/discovery/LookupDiscoveryService.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/LookupDiscoveryRegistration.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LookupDiscoveryRegistration.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 | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <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: incubator/river/site/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryService.html
URL: http://svn.apache.org/viewvc/incubator/river/site/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryService.html?rev=1052601&view=auto
==============================================================================
--- incubator/river/site/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryService.html (added)
+++ incubator/river/site/trunk/content/river/doc/api/net/jini/discovery/LookupDiscoveryService.html Fri Dec 24 20:37:44 2010
@@ -0,0 +1,318 @@
+<!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>
+LookupDiscoveryService (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="net.jini.discovery.LookupDiscoveryService interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="LookupDiscoveryService (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/LookupDiscoveryService.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/LookupDiscoveryRegistration.html" title="interface in net.jini.discovery"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.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/LookupDiscoveryService.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LookupDiscoveryService.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 | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <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>
+Interface LookupDiscoveryService</H2>
+<HR>
+<DL>
+<DT><PRE>public interface <B>LookupDiscoveryService</B></DL>
+</PRE>
+
+<P>
+Defines the interface to the lookup discovery service. This interface is
+ not a remote interface; each implementation of this service exports
+ proxy objects that implement the LookupDiscoveryService interface local to
+ the client, using an implementation-specific protocol to communicate
+ with the actual remote server. All of the proxy methods obey normal
+ RMI remote interface semantics except where explicitly noted. Two
+ proxy objects are equal if they are proxies for the same lookup discovery
+ service.
+<P>
+
+<P>
+<DL>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html" title="interface in net.jini.discovery"><CODE>LookupDiscoveryRegistration</CODE></A></DL>
+<HR>
+
+<P>
+
+<!-- ========== 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="../../../net/jini/discovery/LookupDiscoveryRegistration.html" title="interface in net.jini.discovery">LookupDiscoveryRegistration</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../net/jini/discovery/LookupDiscoveryService.html#register(java.lang.String[], net.jini.core.discovery.LookupLocator[], net.jini.core.event.RemoteEventListener, java.rmi.MarshalledObject, long)">register</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/core/event/RemoteEventListener.html" title="interface in net.jini.core.event">RemoteEventListener</A> listener,
+ <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> handback,
+ long leaseDuration)</CODE>
+
+<BR>
+ Register with the lookup discovery service.</TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ 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="register(java.lang.String[], net.jini.core.discovery.LookupLocator[], net.jini.core.event.RemoteEventListener, java.rmi.MarshalledObject, long)"><!-- --></A><H3>
+register</H3>
+<PRE>
+<A HREF="../../../net/jini/discovery/LookupDiscoveryRegistration.html" title="interface in net.jini.discovery">LookupDiscoveryRegistration</A> <B>register</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/core/event/RemoteEventListener.html" title="interface in net.jini.core.event">RemoteEventListener</A> listener,
+ <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> handback,
+ long leaseDuration)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Register with the lookup discovery service. When a client invokes
+ this method, it requests that the lookup discovery service perform
+ discovery processing on its behalf.
+ <p>
+ An invocation of this method produces an object - referred to as a
+ registration object (or simply, a registration) - that is mutable.
+ Because the registration produced by this method is mutable, each
+ invocation of this method produces a new registration object. Thus,
+ this method is not idempotent.
+ <p>
+ To register with the lookup discovery service, the client must
+ indicate the lookup services it is interested in discovering. It
+ does this by submitting two sets of of objects. One set consists
+ of the names of the groups whose members are lookup services the
+ client wishes to be discovered. The other set consists of
+ LookupLocator objects, each corresponding to a specific lookup
+ service the client wishes to be discovered. The state information
+ managed by the lookup discovery service contains no knowledge of
+ the clients that register. Thus, there is no requirement that the
+ client identify itself during the registration process.
+ <p>
+ Registration with the lookup discovery service includes registration
+ with the event mechanism of the lookup discovery service. That is,
+ for each registration created as a result of an invocation of this
+ method, an event identifier will be generated that uniquely maps
+ the registration to the listener object and to the set of groups
+ and locators input to this method. This event identifier is returned
+ as a part of the registration object, and is unique across all
+ other active registrations with the lookup discovery service.
+ <p>
+ While the registration is in effect, whenever the lookup discovery
+ service finds a lookup service matching the discovery criteria of
+ one or more of its registrations, an instance of
+ net.jini.discovery.RemoteDiscoveryEvent will be sent to the
+ listener corresponding to each such registration. The event sent
+ to each listener will contain the appropriate event identifier.
+ <p>
+ Any registration granted as a result of an invocation of this method
+ is leased. The initial duration of the lease granted to a client
+ by the lookup discovery service will be less than or equal to the
+ requested duration input to this method. Any registration with the
+ lookup discovery service is persistent across restarts (crashes)
+ of the lookup discovery service until the lease on the registration
+ expires or is cancelled.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>groups</CODE> - String array, none of whose elements may be null,
+ consisting of zero or more names of groups to
+ which lookup services to discover belong.
+ A value of null
+ (net.jini.discovery.LookupDiscovery.ALL_GROUPS)
+ is acceptable. If null is passed to this argument,
+ the lookup discovery service will attempt to
+ discover all lookup services located within the
+ multicast radius of the host on which the lookup
+ discovery service is running. If an empty array
+ (net.jini.discovery.LookupDiscovery.NO_GROUPS)
+ is passed to this argument, then no group discovery
+ will be performed for the associated registration
+ until the client, through one of the registration's
+ methods, populates the managed set of groups.<DD><CODE>locators</CODE> - array of zero or more non-null LookupLocator
+ objects, each corresponding to a specific lookup
+ service to discover. If either the empty array
+ or null is passed to this argument, then no
+ locator discovery will be performed for the
+ associated registration until the client, through
+ one of the registration's methods, populates the
+ managed set of locators.<DD><CODE>listener</CODE> - a non-null instance of RemoteEventListener. This
+ argument specifies the entity that will receive
+ events notifying the registration that a lookup
+ service of interest has been discovered. A
+ non-null value must be passed to this argument,
+ otherwise a NullPointerException will be thrown
+ and the registration will not succeed.<DD><CODE>handback</CODE> - null or an instance of MarshalledObject. This
+ argument specifies an object that will be
+ included in the notification event that the
+ lookup discovery service sends to the registered
+ listener.<DD><CODE>leaseDuration</CODE> - long value representing the amount of time (in
+ milliseconds) for which the resources of the
+ lookup discovery service are being requested.
+<DT><B>Returns:</B><DD>an instance of the LookupDiscoveryRegistration interface.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE> - typically, this exception occurs when
+ there is a communication failure between the client and the
+ lookup discovery service. When this exception does occur, the
+ registration may or may not have completed successfully.
+<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
+ null is input to the <code>listener</code> parameter, as well
+ as when one or more of the elements of the <code>groups</code>
+ parameter is null.
+<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
+ the value input to the <code>leaseDuration</code> parameter
+ is neither positive, Lease.FOREVER, nor Lease.ANY.</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/LookupDiscoveryService.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/LookupDiscoveryRegistration.html" title="interface in net.jini.discovery"><B>PREV CLASS</B></A>
+ <A HREF="../../../net/jini/discovery/LookupLocatorDiscovery.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/LookupDiscoveryService.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LookupDiscoveryService.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 | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <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>