rendezvousservice.html

jxta的api库

propagateInGroup</H3>
<PRE>
public void <B>propagateInGroup</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,
                             java.lang.String&nbsp;prunePeer)
                      throws java.io.IOException</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>use <A HREF="../../../net/jxta/rendezvous/RendezVousService.html#propagate(net.jxta.endpoint.Message, java.lang.String, java.lang.String, int)"><CODE>propagate(Message,String,String,int)</CODE></A></I>
<P>
<DD>Propagates a message onto as many peers in the group as possible.

 <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>
</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<DD><CODE>prunePeer</CODE> - is a peer to prune in the propagation.
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="isConnectedToRendezVous()"><!-- --></A><H3>
isConnectedToRendezVous</H3>
<PRE>
public boolean <B>isConnectedToRendezVous</B>()</PRE>
<DL>
<DD>Return true if connected to a rendezvous.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>true if connected to a rendezvous, false otherwise</DL>
</DD>
</DL>
<HR>

<A NAME="isRendezVous()"><!-- --></A><H3>
isRendezVous</H3>
<PRE>
public boolean <B>isRendezVous</B>()</PRE>
<DL>
<DD>tells whether this rendezvous service currently acts as a "super-node"
 "rendezvous", knowlege hub, influence broker, or whichever higher
 status applies to the implementation.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>boolean true if this rendezvous acts as a "rendezvous" per the
 implementation definition.</DL>
</DD>
</DL>
<HR>

<A NAME="setAutoStart(boolean)"><!-- --></A><H3>
setAutoStart</H3>
<PRE>
public boolean <B>setAutoStart</B>(boolean&nbsp;auto)</PRE>
<DL>
<DD>Enable or disable the automatic switching between an Edge Peer
  and a Rendezvous Peer.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>auto</CODE> - true will activate automatic switching
<DT><B>Returns:</B><DD>the previous value of this mode</DL>
</DD>
</DL>
<HR>

<A NAME="setAutoStart(boolean, long)"><!-- --></A><H3>
setAutoStart</H3>
<PRE>
public boolean <B>setAutoStart</B>(boolean&nbsp;auto,
                            long&nbsp;period)</PRE>
<DL>
<DD>Enable or disable the automatic switching between an Edge Peer
  and a Rendezvous Peer.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>auto</CODE> - true will activate automatic switching<DD><CODE>period</CODE> - the period of auto-checking
<DT><B>Returns:</B><DD>the previous value of this mode</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;ttl)
          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 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>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>msg</CODE> - is the message to walk.<DD><CODE>serviceName</CODE> - is the name of the service<DD><CODE>serviceParam</CODE> - is the parameter of the service<DD><CODE>ttl</CODE> - is the maximum TTL of the message (note that the Rendezvous
 Service implementation is free to decrease that value.
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE> - when walking the message is impossible (network failure)</DL>
</DD>
</DL>
<HR>

<A NAME="walk(java.util.Vector, net.jxta.endpoint.Message, java.lang.String, java.lang.String, int)"><!-- --></A><H3>
walk</H3>
<PRE>
public void <B>walk</B>(java.util.Vector&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;ttl)
          throws java.io.IOException</PRE>
<DL>
<DD><p/>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 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>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>destPeerIDs</CODE> - is a Vector of PeerID of the peers which are receiving
 first the walker. Note that each entry in the Vector will create its own
 walker.<DD><CODE>msg</CODE> - is the message to walk.<DD><CODE>serviceName</CODE> - is the name of the service<DD><CODE>serviceParam</CODE> - is the parameter of the service<DD><CODE>ttl</CODE> - is the maximum TTL of the message (note that the Rendezvous
 Service implementation is free to decrease that value.
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE> - when walking the message is impossible (network failure)</DL>
</DD>
</DL>
<HR>

<A NAME="getLocalWalkView()"><!-- --></A><H3>
getLocalWalkView</H3>
<PRE>
public java.util.Vector <B>getLocalWalkView</B>()</PRE>
<DL>
<DD>Returns a vector of RdvAdvertisement of the local view of rendezvous peers.

  <p/><ul>
      <li>Values are <A HREF="../../../net/jxta/protocol/RdvAdvertisement.html" title="class in net.jxta.protocol"><CODE>RdvAdvertisement</CODE></A>.</li>
  </ul>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>Vector containing RdvAdvertisement of the local view of RDV peers.</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;timeout)</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>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>peer</CODE> - The peer to be challenged<DD><CODE>timeout</CODE> - The delay</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=3 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>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/RendezVousService.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
JXTA J2SE</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../net/jxta/rendezvous/RendezVousMonitor.html" title="interface in net.jxta.rendezvous"><B>PREV CLASS</B></A>&nbsp;
&nbsp;NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="RendezVousService.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>

</BODY>
</HTML>