peerviewelement.html

jxta的api库

  </ul></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerViewElement.html#messageSendSucceeded(net.jxta.endpoint.OutgoingMessageEvent)">messageSendSucceeded</A></B>(<A HREF="../../../../../net/jxta/endpoint/OutgoingMessageEvent.html" title="class in net.jxta.endpoint">OutgoingMessageEvent</A>&nbsp;e)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The message identified by the event was successfully sent. Successfully 
 sending a message is not a guarantee that it will be successfully
 received by the destination.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerViewElement.html#messengerReady(net.jxta.endpoint.MessengerEvent)">messengerReady</A></B>(<A HREF="../../../../../net/jxta/endpoint/MessengerEvent.html" title="class in net.jxta.endpoint">MessengerEvent</A>&nbsp;e)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A messenger is ready</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerViewElement.html#sendMessage(net.jxta.endpoint.Message, java.lang.String, java.lang.String)">sendMessage</A></B>(<A HREF="../../../../../net/jxta/endpoint/Message.html" title="class in net.jxta.endpoint">Message</A>&nbsp;msg,
            java.lang.String&nbsp;sName,
            java.lang.String&nbsp;sParam)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Send a message to the peer which is represented by the current
 PeerViewElement. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerViewElement.html#setConnectivity(boolean)">setConnectivity</A></B>(boolean&nbsp;live)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Invoked to indicate whether the last connect request succeeded.
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerViewElement.html#setPinned(boolean)">setPinned</A></B>(boolean&nbsp;pinned)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;setPinned(false) is a conditional close. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../../net/jxta/protocol/RdvAdvertisement.html" title="class in net.jxta.protocol">RdvAdvertisement</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerViewElement.html#setRdvAdvertisement(net.jxta.protocol.RdvAdvertisement)">setRdvAdvertisement</A></B>(<A HREF="../../../../../net/jxta/protocol/RdvAdvertisement.html" title="class in net.jxta.protocol">RdvAdvertisement</A>&nbsp;adv)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the encapsulated Peer Advertisement.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../../net/jxta/protocol/RouteAdvertisement.html" title="class in net.jxta.protocol">RouteAdvertisement</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerViewElement.html#setSrcRouteAdvertisement(net.jxta.protocol.RouteAdvertisement)">setSrcRouteAdvertisement</A></B>(<A HREF="../../../../../net/jxta/protocol/RouteAdvertisement.html" title="class in net.jxta.protocol">RouteAdvertisement</A>&nbsp;adv)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the encapsulated source peer RouteAdvertisement.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerViewElement.html#toString()">toString</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.Object</B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, finalize, getClass, notify, notifyAll, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="PeerViewElement(net.jxta.impl.rendezvous.rpv.PeerView, net.jxta.endpoint.EndpointService, java.io.InputStream)"><!-- --></A><H3>
PeerViewElement</H3>
<PRE>
<B>PeerViewElement</B>(<A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerView.html" title="class in net.jxta.impl.rendezvous.rpv">PeerView</A>&nbsp;pv,
                <A HREF="../../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A>&nbsp;endpoint,
                java.io.InputStream&nbsp;in)</PRE>
<DL>
<DD>Initialize from a RdvAdvertisement contained in the specified
 InputStream.
<P>
<DT><B>Parameters:</B><DD><CODE>pv</CODE> - The PeerView the element works for.<DD><CODE>endpoint</CODE> - The endpoint that it must use.<DD><CODE>in</CODE> - an InputStream from which the RdvAdvertisement is
 ready to be read from
<DT><B>Throws:</B>
<DD><CODE>java.lang.ClassCastException</CODE> - if the Advertisement contained in
 the specified InputStream is not a RdvAdvertisement.</DL>
<HR>

<A NAME="PeerViewElement(net.jxta.impl.rendezvous.rpv.PeerView, net.jxta.endpoint.EndpointService, net.jxta.protocol.RdvAdvertisement)"><!-- --></A><H3>
PeerViewElement</H3>
<PRE>
<B>PeerViewElement</B>(<A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerView.html" title="class in net.jxta.impl.rendezvous.rpv">PeerView</A>&nbsp;pv,
                <A HREF="../../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A>&nbsp;endpoint,
                <A HREF="../../../../../net/jxta/protocol/RdvAdvertisement.html" title="class in net.jxta.protocol">RdvAdvertisement</A>&nbsp;adv)</PRE>
<DL>
<DD>Initialize from a RdvAdvertisement.
<P>
<DT><B>Parameters:</B><DD><CODE>pv</CODE> - The PeerView the element works for.<DD><CODE>endpoint</CODE> - The endpoint that it must use.<DD><CODE>adv</CODE> - the RdvAdvertisement from which to initialize</DL>
<HR>

<A NAME="PeerViewElement(net.jxta.impl.rendezvous.rpv.PeerView, net.jxta.endpoint.EndpointService, net.jxta.endpoint.EndpointAddress)"><!-- --></A><H3>
PeerViewElement</H3>
<PRE>
<B>PeerViewElement</B>(<A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerView.html" title="class in net.jxta.impl.rendezvous.rpv">PeerView</A>&nbsp;pv,
                <A HREF="../../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A>&nbsp;endpoint,
                <A HREF="../../../../../net/jxta/endpoint/EndpointAddress.html" title="class in net.jxta.endpoint">EndpointAddress</A>&nbsp;destAddress)</PRE>
<DL>
<DD>Initialize from a RdvAdvertisement.
<P>
<DT><B>Parameters:</B><DD><CODE>pv</CODE> - The PeerView the element works for.<DD><CODE>endpoint</CODE> - The endpoint that it must use.<DD><CODE>destAddress</CODE> - the endpoint address from which to initialize</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="init(net.jxta.impl.rendezvous.rpv.PeerView, net.jxta.endpoint.EndpointService, net.jxta.protocol.RdvAdvertisement)"><!-- --></A><H3>
init</H3>
<PRE>
void <B>init</B>(<A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerView.html" title="class in net.jxta.impl.rendezvous.rpv">PeerView</A>&nbsp;pv,
          <A HREF="../../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A>&nbsp;endpoint,
          <A HREF="../../../../../net/jxta/protocol/RdvAdvertisement.html" title="class in net.jxta.protocol">RdvAdvertisement</A>&nbsp;adv)</PRE>
<DL>
<DD>Initialize from a RdvAdvertisement.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pv</CODE> - The PeerView the element works for.<DD><CODE>endpoint</CODE> - The endpoint that it must use.<DD><CODE>adv</CODE> - the RdvAdvertisement from which to initialize</DL>
</DD>
</DL>
<HR>

<A NAME="init(net.jxta.impl.rendezvous.rpv.PeerView, net.jxta.endpoint.EndpointService, net.jxta.endpoint.EndpointAddress)"><!-- --></A><H3>
init</H3>
<PRE>
void <B>init</B>(<A HREF="../../../../../net/jxta/impl/rendezvous/rpv/PeerView.html" title="class in net.jxta.impl.rendezvous.rpv">PeerView</A>&nbsp;pv,
          <A HREF="../../../../../net/jxta/endpoint/EndpointService.html" title="interface in net.jxta.endpoint">EndpointService</A>&nbsp;endpoint,
          <A HREF="../../../../../net/jxta/endpoint/EndpointAddress.html" title="class in net.jxta.endpoint">EndpointAddress</A>&nbsp;destAddress)</PRE>
<DL>
<DD>Initialize from an endpoint address.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pv</CODE> - The PeerView the element works for.<DD><CODE>endpoint</CODE> - The endpoint that it mnust use.<DD><CODE>destAddress</CODE> - the endpoint address from which to initialize</DL>
</DD>
</DL>
<HR>

<A NAME="setPinned(boolean)"><!-- --></A><H3>
setPinned</H3>
<PRE>
public void <B>setPinned</B>(boolean&nbsp;pinned)</PRE>
<DL>
<DD>setPinned(false) is a conditional close. If nothing is in
 progress this pve will close; else closure will occur when the
 last msg is send or failed, if still unpinned.

 Note: setPinned(true) may in fact cause closure as well, if on the
 occasion we discover that alive is false and messagesInprogress is 0.
 (This is not expected to happen; just defensive).

 Warning: this method does not count pin/unpin calls, so it should
 not be used on a shared pve without external coordination.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pinned</CODE> - true if this pve shall be pinned, false if it shall
 be unpinned.</DL>
</DD>
</DL>
<HR>

<A NAME="close()"><!-- --></A><H3>
close</H3>
<PRE>
public void <B>close</B>()</PRE>
<DL>
<DD>Unconditional close. This pve is removed from the pendingPve
 map and a lost connectivity event is generated if necessary.

 Note:
 It may happen that this pve is still referenced after close()
 because it was found in the pendingPve map between the time it
 became idle and the time it removes itself from the map, or before
 it is used after close/removal and so goes back into it.  If
 messages are sent through it, it will get another messenger
 send messages and close again. So, close is not final;
 it is just an action that takes place in order to let go
 of the messenger when we're not sure we'll use it again.
 All the pending messenger management needs to be cleaned up.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="messengerReady(net.jxta.endpoint.MessengerEvent)"><!-- --></A><H3>
messengerReady</H3>
<PRE>
public boolean <B>messengerReady</B>(<A HREF="../../../../../net/jxta/endpoint/MessengerEvent.html" title="class in net.jxta.endpoint">MessengerEvent</A>&nbsp;e)</PRE>
<DL>
<DD>A messenger is ready
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../net/jxta/endpoint/MessengerEventListener.html#messengerReady(net.jxta.endpoint.MessengerEvent)">messengerReady</A></CODE> in interface <CODE><A HREF="../../../../../net/jxta/endpoint/MessengerEventListener.html" title="interface in net.jxta.endpoint">MessengerEventListener</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>true if this listener want to use the messenger. (Normally means that it will
  not be offered to any other listener.</DL>
</DD>
</DL>
<HR>

<A NAME="messageSendSucceeded(net.jxta.endpoint.OutgoingMessageEvent)"><!-- --></A><H3>
messageSendSucceeded</H3>
<PRE>
public void <B>messageSendSucceeded</B>(<A HREF="../../../../../net/jxta/endpoint/OutgoingMessageEvent.html" title="class in net.jxta.endpoint">OutgoingMessageEvent</A>&nbsp;e)</PRE>
<DL>
<DD>The message identified by the event was successfully sent. Successfully 
 sending a message is not a guarantee that it will be successfully
 received by the destination.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../net/jxta/endpoint/OutgoingMessageEventListener.html#messageSendSucceeded(net.jxta.endpoint.OutgoingMessageEvent)">messageSendSucceeded</A></CODE> in interface <CODE><A HREF="../../../../../net/jxta/endpoint/OutgoingMessageEventListener.html" title="interface in net.jxta.endpoint">OutgoingMessageEventListener</A></CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="messageSendFailed(net.jxta.endpoint.OutgoingMessageEvent)"><!-- --></A><H3>
messageSendFailed</H3>
<PRE>
public void <B>messageSendFailed</B>(<A HREF="../../../../../net/jxta/endpoint/OutgoingMessageEvent.html" title="class in net.jxta.endpoint">OutgoingMessageEvent</A>&nbsp;e)</PRE>
<DL>
<DD>The message identified by the event could not be sent. 

  <p/>The cause of the failure, if any, is available from
  <A HREF="../../../../../net/jxta/endpoint/OutgoingMessageEvent.html#getFailure()"><CODE>OutgoingMessageEvent.getFailure()</CODE></A>. Failures while sending