rendezvousserviceinterface.html

jxta的api库

  modules. For a group it is the PeerGroupID itself.
  The parameters of a service, in the Peer configuration, are indexed
  by the assignedID of that service, and a Service must publish its
  run-time parameters in the Peer Advertisement under its assigned ID.<DD><CODE>impl</CODE> - The implementation advertisement for this
  Module. It is permissible to pass null if no implementation
  advertisement is available. This may happen if the
  implementation was selected by explicit class name rather than
  by following an implementation advertisement. Modules are not
  required to support that style of loading, but if they do, then
  their documentation should mention it.</DL>
</DD>
</DL>
<HR>

<A NAME="startApp(java.lang.String[])"><!-- --></A><H3>
startApp</H3>
<PRE>
public int <B>startApp</B>(java.lang.String[]&nbsp;arg)</PRE>
<DL>
<DD>Some Modules will wait for this method being invoked, before
 completing their initializatino to the point that they are fully
 functional. That is also the opportunity to supply arbitrary arguments
 (mostly to applications).
 
 <p/>If this module is a <A HREF="../../../../net/jxta/peergroup/PeerGroup.html" title="interface in net.jxta.peergroup"><CODE>PeerGroup</CODE></A> service, it may be invoked
 several times depending on its return value.
 
 <p/>Note: the name of this method is historical and no-longer adequate.

  <p/>This is here for temporary class hierarchy reasons.
 it is ALWAYS ignored. By definition, the interface object
 protects the real object's start/stop methods from being called
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/platform/Module.html#startApp(java.lang.String[])">startApp</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/platform/Module.html" title="interface in net.jxta.platform">Module</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>arg</CODE> - An array of Strings forming the parameters for this
 Module.
<DT><B>Returns:</B><DD>int A status indication which may be one of 
 <A HREF="../../../../net/jxta/platform/Module.html#START_OK"><CODE>Module.START_OK</CODE></A>, <A HREF="../../../../net/jxta/platform/Module.html#START_AGAIN_PROGRESS"><CODE>Module.START_AGAIN_PROGRESS</CODE></A>,
 <A HREF="../../../../net/jxta/platform/Module.html#START_AGAIN_STALLED"><CODE>Module.START_AGAIN_STALLED</CODE></A>, which indicates partial or complete
 success, or any other value (negative values are
 recommended for future compatibility), which indicates failure.</DL>
</DD>
</DL>
<HR>

<A NAME="stopApp()"><!-- --></A><H3>
stopApp</H3>
<PRE>
public void <B>stopApp</B>()</PRE>
<DL>
<DD>One can ask a Module to stop.
  The Module cannot be forced to comply, but in the future
  we might be able to deny it access to anything after some timeout.

  <p/>Note: the name of this method is no-longer adequate.

  <p/>This is here for temporary class hierarchy reasons.
 it is ALWAYS ignored. By definition, the interface object
 protects the real object's start/stop methods from being called

 <p/>This request is currently ignored.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/platform/Module.html#stopApp()">stopApp</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/platform/Module.html" title="interface in net.jxta.platform">Module</A></CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="connectToRendezVous(net.jxta.protocol.PeerAdvertisement)"><!-- --></A><H3>
connectToRendezVous</H3>
<PRE>
public void <B>connectToRendezVous</B>(<A HREF="../../../../net/jxta/protocol/PeerAdvertisement.html" title="class in net.jxta.protocol">PeerAdvertisement</A>&nbsp;adv)
                         throws java.io.IOException</PRE>
<DL>
<DD>Add a peer as a new RendezVousService point.

 <p/>If/When the RendezVousService accepts the connection, the RendezVous
 service will invoke the RendezVousMonitor.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#connectToRendezVous(net.jxta.protocol.PeerAdvertisement)">connectToRendezVous</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html" title="interface in net.jxta.rendezvous">RendezVousService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>adv</CODE> - the advertisement of the RendezVousService peer
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE> - when the RendezVousService peer is not reachable</DL>
</DD>
</DL>
<HR>

<A NAME="connectToRendezVous(net.jxta.endpoint.EndpointAddress)"><!-- --></A><H3>
connectToRendezVous</H3>
<PRE>
public void <B>connectToRendezVous</B>(<A HREF="../../../../net/jxta/endpoint/EndpointAddress.html" title="class in net.jxta.endpoint">EndpointAddress</A>&nbsp;addr)
                         throws java.io.IOException</PRE>
<DL>
<DD>Add a peer as a new RendezVousService point.

 <p/>If/When the RendezVousService accepts the connection, the RendezVous
 service will invoke the RendezVousMonitor.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#connectToRendezVous(net.jxta.endpoint.EndpointAddress)">connectToRendezVous</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html" title="interface in net.jxta.rendezvous">RendezVousService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>addr</CODE> - EndpointAddress of the rendezvous peer
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE> - when the RendezVousService peer is not reachable</DL>
</DD>
</DL>
<HR>

<A NAME="challengeRendezVous(net.jxta.id.ID, long)"><!-- --></A><H3>
challengeRendezVous</H3>
<PRE>
public void <B>challengeRendezVous</B>(<A HREF="../../../../net/jxta/id/ID.html" title="class in net.jxta.id">ID</A>&nbsp;peer,
                                long&nbsp;delay)</PRE>
<DL>
<DD>Set a new deadline for the rendezvous to be proven alive.
 As a result a lease reponse must be sought and obtained within the
 specified delay or the rdv is considered disconnected.
 So, if a lease scheme is used, this can be implemented simply by
 setting the new lease deadLine accordingly.

 <p/>A timeout of 0 or less triggers immediate disconnection.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#challengeRendezVous(net.jxta.id.ID, long)">challengeRendezVous</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html" title="interface in net.jxta.rendezvous">RendezVousService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>peer</CODE> - The peer to be challenged<DD><CODE>delay</CODE> - The delay</DL>
</DD>
</DL>
<HR>

<A NAME="disconnectFromRendezVous(net.jxta.id.ID)"><!-- --></A><H3>
disconnectFromRendezVous</H3>
<PRE>
public void <B>disconnectFromRendezVous</B>(<A HREF="../../../../net/jxta/id/ID.html" title="class in net.jxta.id">ID</A>&nbsp;rendezVous)</PRE>
<DL>
<DD>Remove a RendezVousService point.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#disconnectFromRendezVous(net.jxta.id.ID)">disconnectFromRendezVous</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html" title="interface in net.jxta.rendezvous">RendezVousService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>rendezVous</CODE> - the PeerId of the RendezVous to disconnect from.</DL>
</DD>
</DL>
<HR>

<A NAME="setMonitor(net.jxta.rendezvous.RendezVousMonitor)"><!-- --></A><H3>
setMonitor</H3>
<PRE>
public <A HREF="../../../../net/jxta/rendezvous/RendezVousMonitor.html" title="interface in net.jxta.rendezvous">RendezVousMonitor</A> <B>setMonitor</B>(<A HREF="../../../../net/jxta/rendezvous/RendezVousMonitor.html" title="interface in net.jxta.rendezvous">RendezVousMonitor</A>&nbsp;handler)</PRE>
<DL>
<DD>Register a notification monitor that is called each time a RendezVous
 peer is not reachable anymore.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#setMonitor(net.jxta.rendezvous.RendezVousMonitor)">setMonitor</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html" title="interface in net.jxta.rendezvous">RendezVousService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>handler</CODE> - a monitor that is called each time a RendezVous peer is
 is not reachable anymore.
<DT><B>Returns:</B><DD>RendezVousMonitor returns, if any, the current RendezVousMonitor</DL>
</DD>
</DL>
<HR>

<A NAME="getConnectedRendezVous()"><!-- --></A><H3>
getConnectedRendezVous</H3>
<PRE>
public java.util.Enumeration <B>getConnectedRendezVous</B>()</PRE>
<DL>
<DD>Returns an Enumeration of the PeerID all the RendezVous on which this
 Peer is currentely connected.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#getConnectedRendezVous()">getConnectedRendezVous</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html" title="interface in net.jxta.rendezvous">RendezVousService</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>Enumeration enumeration of RendezVous</DL>
</DD>
</DL>
<HR>

<A NAME="getDisconnectedRendezVous()"><!-- --></A><H3>
getDisconnectedRendezVous</H3>
<PRE>
public java.util.Enumeration <B>getDisconnectedRendezVous</B>()</PRE>
<DL>
<DD>Returns an Enumeration of the PeerID all the RendezVous on which this
 Peer failed to connect to.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#getDisconnectedRendezVous()">getDisconnectedRendezVous</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html" title="interface in net.jxta.rendezvous">RendezVousService</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>Enumeration enumeration of RendezVous</DL>
</DD>
</DL>
<HR>

<A NAME="startRendezVous(net.jxta.rendezvous.RendezVousManager)"><!-- --></A><H3>
startRendezVous</H3>
<PRE>
public void <B>startRendezVous</B>(<A HREF="../../../../net/jxta/rendezvous/RendezVousManager.html" title="interface in net.jxta.rendezvous">RendezVousManager</A>&nbsp;handler)
                     throws java.io.IOException</PRE>
<DL>
<DD>Start the local peer as a RendezVous peer. The caller must provide
 a monitor to an authorization manager.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#startRendezVous(net.jxta.rendezvous.RendezVousManager)">startRendezVous</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html" title="interface in net.jxta.rendezvous">RendezVousService</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>handler</CODE> - is the RendezVousManager that will be invoked each
 time a new Peer request to be connected.
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE> - when a monitor has already been connected</DL>
</DD>
</DL>
<HR>

<A NAME="startRendezVous()"><!-- --></A><H3>
startRendezVous</H3>
<PRE>
public void <B>startRendezVous</B>()</PRE>
<DL>
<DD>Start the local peer as a RendezVous peer with the default manager.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#startRendezVous()">startRendezVous</A></CODE> in interface <CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html" title="interface in net.jxta.rendezvous">RendezVousService</A></CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="stopRendezVous()"><!-- --></A><H3>
stopRendezVous</H3>
<PRE>
public void <B>stopRendezVous</B>()</PRE>
<DL>
<DD>Stop the RendezVous function on the local Peer. All connected Peer are