rendezvousserviceinterface.html

jxta的api库

 disconnected.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#stopRendezVous()">stopRendezVous</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="getConnectedPeers()"><!-- --></A><H3>
getConnectedPeers</H3>
<PRE>
public java.util.Enumeration <B>getConnectedPeers</B>()</PRE>
<DL>
<DD>Returns an Enumeration of PeerID of the peers that are currentely
 connected.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#getConnectedPeers()">getConnectedPeers</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 peers connected to that rendezvous</DL>
</DD>
</DL>
<HR>

<A NAME="getConnectedPeerIDs()"><!-- --></A><H3>
getConnectedPeerIDs</H3>
<PRE>
public java.util.Vector <B>getConnectedPeerIDs</B>()</PRE>
<DL>
<DD>Returns a Vector of PeerID of the peers that are currentely
 connected.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#getConnectedPeerIDs()">getConnectedPeerIDs</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>Vector vector of peers connected to that rendezvous</DL>
</DD>
</DL>
<HR>

<A NAME="sendRendezVousAdv(net.jxta.protocol.PeerAdvertisement, net.jxta.protocol.PeerAdvertisement)"><!-- --></A><H3>
sendRendezVousAdv</H3>
<PRE>
public void <B>sendRendezVousAdv</B>(<A HREF="../../../../net/jxta/protocol/PeerAdvertisement.html" title="class in net.jxta.protocol">PeerAdvertisement</A>&nbsp;destPeer,
                              <A HREF="../../../../net/jxta/protocol/PeerAdvertisement.html" title="class in net.jxta.protocol">PeerAdvertisement</A>&nbsp;rendezVous)</PRE>
<DL>
<DD>Sends advertisement about other RendezVous to a given peer
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#sendRendezVousAdv(net.jxta.protocol.PeerAdvertisement, net.jxta.protocol.PeerAdvertisement)">sendRendezVousAdv</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>destPeer</CODE> - is the advertisement of the peer to which to
 send the RendezVous advertisement.<DD><CODE>rendezVous</CODE> - is the advertisment of a RendezVous peer</DL>
</DD>
</DL>
<HR>

<A NAME="addPropagateListener(java.lang.String, net.jxta.endpoint.EndpointListener)"><!-- --></A><H3>
addPropagateListener</H3>
<PRE>
public boolean <B>addPropagateListener</B>(java.lang.String&nbsp;name,
                                    <A HREF="../../../../net/jxta/endpoint/EndpointListener.html" title="interface in net.jxta.endpoint">EndpointListener</A>&nbsp;listener)</PRE>
<DL>
<DD>Clients of the rendezvous service can use this to receive raw
 propagation rather than crawling query/responses. It takes care of TTL
 counting and loop detection.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#addPropagateListener(java.lang.String, net.jxta.endpoint.EndpointListener)">addPropagateListener</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>name</CODE> - The name of the listener.<DD><CODE>listener</CODE> - An EndpointListener to process the message.
<DT><B>Returns:</B><DD>true if listener was registered, otherwise false.</DL>
</DD>
</DL>
<HR>

<A NAME="removePropagateListener(java.lang.String, net.jxta.endpoint.EndpointListener)"><!-- --></A><H3>
removePropagateListener</H3>
<PRE>
public <A HREF="../../../../net/jxta/endpoint/EndpointListener.html" title="interface in net.jxta.endpoint">EndpointListener</A> <B>removePropagateListener</B>(java.lang.String&nbsp;name,
                                                <A HREF="../../../../net/jxta/endpoint/EndpointListener.html" title="interface in net.jxta.endpoint">EndpointListener</A>&nbsp;listener)</PRE>
<DL>
<DD>Removes a Listener previously added with addPropagateListener.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#removePropagateListener(java.lang.String, net.jxta.endpoint.EndpointListener)">removePropagateListener</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>name</CODE> - The name of the listener.<DD><CODE>listener</CODE> - An EndpointListener to process the message.
<DT><B>Returns:</B><DD>the listener removed, null otherwise</DL>
</DD>
</DL>
<HR>

<A NAME="addListener(net.jxta.rendezvous.RendezvousListener)"><!-- --></A><H3>
addListener</H3>
<PRE>
public void <B>addListener</B>(<A HREF="../../../../net/jxta/rendezvous/RendezvousListener.html" title="interface in net.jxta.rendezvous">RendezvousListener</A>&nbsp;listener)</PRE>
<DL>
<DD>Add a listener for RenDezVousEvents
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#addListener(net.jxta.rendezvous.RendezvousListener)">addListener</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>listener</CODE> - An RendezvousListener to process the event.</DL>
</DD>
</DL>
<HR>

<A NAME="removeListener(net.jxta.rendezvous.RendezvousListener)"><!-- --></A><H3>
removeListener</H3>
<PRE>
public boolean <B>removeListener</B>(<A HREF="../../../../net/jxta/rendezvous/RendezvousListener.html" title="interface in net.jxta.rendezvous">RendezvousListener</A>&nbsp;listener)</PRE>
<DL>
<DD>Removes a Listener previously added with addListener.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#removeListener(net.jxta.rendezvous.RendezvousListener)">removeListener</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>listener</CODE> - the RendezvousListener listener remove</DL>
</DD>
</DL>
<HR>

<A NAME="propagate(net.jxta.endpoint.Message, java.lang.String, java.lang.String, int)"><!-- --></A><H3>
propagate</H3>
<PRE>
public void <B>propagate</B>(<A HREF="../../../../net/jxta/endpoint/Message.html" title="class in net.jxta.endpoint">Message</A>&nbsp;msg,
                      java.lang.String&nbsp;serviceName,
                      java.lang.String&nbsp;serviceParam,
                      int&nbsp;defaultTTL)
               throws java.io.IOException</PRE>
<DL>
<DD>Propagates a message onto as many peers on the local network
 as possible. Typically the message will go to all the peers to
 which at least one endpoint transport can address without using
 the router.

 <p/>This method sends the message to all peers, rendezvous peers and
 edge peer. This method of propation is very expensive and should
 not be frequentely used. When rendezvous peers are used in order to
 cache index of data, it is more efficient to use the walk() method.

 <p/>Only a single HOP at a time is performed. Messages are always
 delivered to the destination handler on arrival. This handler
 is responsible for repropagating further, if deemed appropropriate.

 <p/>Loop and TTL control are performed automatically.

 <p/>Messages can be propagated via this method for the first time or
 can be re-propagated by re-using a message that came in via propagation.
 In the later case, the TTL and loop detection parameters CANNOT be
 re-initialized. If one wants to "re-propagate" a message with a new TTL
 and blank gateways list one must generate a completely new message.
 This limits the risk of accidental propagation storms, although they
 can always be engineered deliberately.

 <p/><b>Note</b>: The original msg is not modified and may be reused upon return.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#propagate(net.jxta.endpoint.Message, java.lang.String, java.lang.String, int)">propagate</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>msg</CODE> - is the message to propagate.<DD><CODE>serviceName</CODE> - is the name of the service<DD><CODE>serviceParam</CODE> - is the parameter of the service
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="propagate(java.util.Enumeration, net.jxta.endpoint.Message, java.lang.String, java.lang.String, int)"><!-- --></A><H3>
propagate</H3>
<PRE>
public void <B>propagate</B>(java.util.Enumeration&nbsp;destPeerIDs,
                      <A HREF="../../../../net/jxta/endpoint/Message.html" title="class in net.jxta.endpoint">Message</A>&nbsp;msg,
                      java.lang.String&nbsp;serviceName,
                      java.lang.String&nbsp;serviceParam,
                      int&nbsp;defaultTTL)
               throws java.io.IOException</PRE>
<DL>
<DD>Propagates a message onto as many peers on the local network
 as possible. Typically the message will go to all the peers to
 which at least one endpoint transport can address without using
 the router.

 <p/>This method sends the message to all peers, rendezvous peers and
 edge peer. This method of propation is very expensive and should
 not be frequentely used. When rendezvous peers are used in order to
 cache index of data, it is more efficient to use the walk() method.

 <p/>Only a single HOP at a time is performed. Messages are always
 delivered to the destination handler on arrival. This handler
 is responsible for repropagating further, if deemed appropropriate.

 <p/>Loop and TTL control are performed automatically.

 <p/>Messages can be propagated via this method for the first time or
 can be re-propagated by re-using a message that came in via propagation.
 In the later case, the TTL and loop detection parameters CANNOT be
 re-initialized. If one wants to "re-propagate" a message with a new TTL
 and blank gateways list one must generate a completely new message.
 This limits the risk of accidental propagation storms, although they
 can always be engineered deliberately.

 <p/><b>Note</b>: The original msg is not modified and may be reused upon return.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../net/jxta/rendezvous/RendezVousService.html#propagate(java.util.Enumeration, net.jxta.endpoint.Message, java.lang.String, java.lang.String, int)">propagate</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>destPeerIDs</CODE> - is a vector of PeerID of the peers that are recipients
 of the propgated message.<DD><CODE>msg</CODE> - is the message to propagate.<DD><CODE>serviceName</CODE> - is the name of the service<DD><CODE>serviceParam</CODE> - is the parameter of the service
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="walk(net.jxta.endpoint.Message, java.lang.String, java.lang.String, int)"><!-- --></A><H3>
walk</H3>
<PRE>
public void <B>walk</B>(<A HREF="../../../../net/jxta/endpoint/Message.html" title="class in net.jxta.endpoint">Message</A>&nbsp;msg,
                 java.lang.String&nbsp;serviceName,
                 java.lang.String&nbsp;serviceParam,
                 int&nbsp;defaultTTL)
          throws java.io.IOException</PRE>
<DL>
<DD>Walk a message through the rendezvous peers of the network: only
 rendezvous peers will receive the message.

 <p/>Only a single HOP at a time is performed. Messages are always
 delivered to the destination handler on arrival. This handler
 is responsible for repropagating further, if deemed appropropriate.

 <p/>Loop and TTL control are performed automatically.

 <p/>Messages can be propagated via this method for the first time or
 can be re-propagated by re-using a message that came in via propagation.
 In the later case, the TTL and loop detection parameters CANNOT be
 re-initialized. If one wants to "re-propagate" a message with a new TTL
 and blank gateways