peerinfoservice.html

jxta的api库

<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>peerID</CODE> - The PeerID of the Peer you wish information about<DD><CODE>peerMonitorInfoListener</CODE> - The Listener to be told about the obtained PeerMonitorInfo<DD><CODE>timeout</CODE> - Generate a timeout event if no answer has been received in this time (in Milliseconds)
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getCumulativeMonitorReport(net.jxta.meter.MonitorFilter)"><!-- --></A><H3>
getCumulativeMonitorReport</H3>
<PRE>
public <A HREF="../../../net/jxta/meter/MonitorReport.html" title="class in net.jxta.meter">MonitorReport</A> <B>getCumulativeMonitorReport</B>(<A HREF="../../../net/jxta/meter/MonitorFilter.html" title="class in net.jxta.meter">MonitorFilter</A>&nbsp;monitorFilter)
                                         throws <A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></PRE>
<DL>
<DD>Get a MonitorReport of total accumulated metrics from the ServiceMonitors (specified in the
		MonitorFilter) since they were created/reset for the local Peer.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>monitorFilter</CODE> - The MonitorFilter containing the specific ServiceMonitors and types of Service Metrics desired
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getCumulativeMonitorReport(net.jxta.peer.PeerID, net.jxta.meter.MonitorFilter, net.jxta.meter.MonitorListener, long)"><!-- --></A><H3>
getCumulativeMonitorReport</H3>
<PRE>
public void <B>getCumulativeMonitorReport</B>(<A HREF="../../../net/jxta/peer/PeerID.html" title="class in net.jxta.peer">PeerID</A>&nbsp;peerID,
                                       <A HREF="../../../net/jxta/meter/MonitorFilter.html" title="class in net.jxta.meter">MonitorFilter</A>&nbsp;monitorFilter,
                                       <A HREF="../../../net/jxta/meter/MonitorListener.html" title="interface in net.jxta.meter">MonitorListener</A>&nbsp;monitorListener,
                                       long&nbsp;timeout)
                                throws <A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></PRE>
<DL>
<DD>Get a MonitorReport of total accumulated metrics from the ServiceMonitors (specified in the
		MonitorFilter) since they were created/reset for the specified remote Peer.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>peerID</CODE> - The PeerID of the Peer you wish information about<DD><CODE>monitorFilter</CODE> - The MonitorFilter containing the specific ServiceMonitors and types of Service Metrics desired<DD><CODE>monitorListener</CODE> - The Listener to obtain the report when it arrives (or timed out)<DD><CODE>timeout</CODE> - The timeout for reporting that the information has not arrived.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="addMonitorListener(net.jxta.meter.MonitorFilter, long, boolean, net.jxta.meter.MonitorListener)"><!-- --></A><H3>
addMonitorListener</H3>
<PRE>
public long <B>addMonitorListener</B>(<A HREF="../../../net/jxta/meter/MonitorFilter.html" title="class in net.jxta.meter">MonitorFilter</A>&nbsp;monitorFilter,
                               long&nbsp;reportRate,
                               boolean&nbsp;includeCumulative,
                               <A HREF="../../../net/jxta/meter/MonitorListener.html" title="interface in net.jxta.meter">MonitorListener</A>&nbsp;monitorListener)
                        throws <A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></PRE>
<DL>
<DD>Get MonitorReports at a specified rates of metrics accrued over time from the ServiceMonitors
		(specified in the MonitorFilter) about the local Peer.  For many applications it is required to obtain metrics from
		the beginning of time and then augment over time as more data arrives. <P>

		There is a problem with the following approach:
				<OL>
					<LI>	Call getCumulativeMonitorReport to get the cumulative totals </LI>
					<LI>	Call addMonitorListener to get periodic changes </LI>
					<LI>	Add the periodic data to the totals </LI>
				</OL>

		Because of a potential race condition related to metrics that are measured between the two calls it is 
		possible to lose some metrics.  To address this, this method supports this by combining them into a single
		call that allows you to specify whether you wish the first report delivered to be a cumulative report.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>monitorFilter</CODE> - The MonitorFilter containing the specific ServiceMonitors and types of Service Metrics desired<DD><CODE>reportRate</CODE> - The rate at which you wish metric delta reports<DD><CODE>includeCumulative</CODE> - Should the first report you receive be the cumulative data since the ServiceMonitors were created/reset?<DD><CODE>monitorListener</CODE> - The Listener to obtain the report when it arrives (or timed out)
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="addRemoteMonitorListener(net.jxta.peer.PeerID, net.jxta.meter.MonitorFilter, long, boolean, net.jxta.meter.MonitorListener, long, long)"><!-- --></A><H3>
addRemoteMonitorListener</H3>
<PRE>
public void <B>addRemoteMonitorListener</B>(<A HREF="../../../net/jxta/peer/PeerID.html" title="class in net.jxta.peer">PeerID</A>&nbsp;peerID,
                                     <A HREF="../../../net/jxta/meter/MonitorFilter.html" title="class in net.jxta.meter">MonitorFilter</A>&nbsp;monitorFilter,
                                     long&nbsp;reportRate,
                                     boolean&nbsp;includeCumulative,
                                     <A HREF="../../../net/jxta/meter/MonitorListener.html" title="interface in net.jxta.meter">MonitorListener</A>&nbsp;monitorListener,
                                     long&nbsp;lease,
                                     long&nbsp;timeout)
                              throws <A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></PRE>
<DL>
<DD>Get MonitorReports at a specified rates of metrics accrued over time from the ServiceMonitors
		(specified in the MonitorFilter) about the specified remote Peer.  For many applications it is required to obtain metrics from
		the beginning of time and then augment over time as more data arrives. <P>

		There is a problem with the following approach:
				<OL>
					<LI>	Call getCumulativeMonitorReport to get the cumulative totals </LI>
					<LI>	Call addMonitorListener to get periodic changes </LI>
					<LI>	Add the periodic data to the totals </LI>
				</OL>

		Because of a potential race condition related to metrics that are measured between the two calls it is 
		possible to lose some metrics.  To address this, this method supports this by combining them into a single
		call that allows you to specify whether you wish the first report delivered to be a cumulative report.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>peerID</CODE> - The PeerID of the Peer you wish information about<DD><CODE>monitorFilter</CODE> - The MonitorFilter containing the specific ServiceMonitors and types of Service Metrics desired<DD><CODE>reportRate</CODE> - The rate at which you wish metric delta reports<DD><CODE>includeCumulative</CODE> - Should the first report you receive be the cumulative data since the ServiceMonitors were created/reset?<DD><CODE>monitorListener</CODE> - The Listener to obtain the report when it arrives (or timed out)<DD><CODE>timeout</CODE> - The timeout for reporting that the information has not arrived.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="removeMonitorListener(net.jxta.meter.MonitorListener)"><!-- --></A><H3>
removeMonitorListener</H3>
<PRE>
public boolean <B>removeMonitorListener</B>(<A HREF="../../../net/jxta/meter/MonitorListener.html" title="interface in net.jxta.meter">MonitorListener</A>&nbsp;monitorListener)
                              throws <A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></PRE>
<DL>
<DD>Stop the periodic reporting for all registered filters corresponding to this MonitorListener
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="removeRemoteMonitorListener(net.jxta.peer.PeerID, net.jxta.meter.MonitorListener, long)"><!-- --></A><H3>
removeRemoteMonitorListener</H3>
<PRE>
public void <B>removeRemoteMonitorListener</B>(<A HREF="../../../net/jxta/peer/PeerID.html" title="class in net.jxta.peer">PeerID</A>&nbsp;peerID,
                                        <A HREF="../../../net/jxta/meter/MonitorListener.html" title="interface in net.jxta.meter">MonitorListener</A>&nbsp;monitorListener,
                                        long&nbsp;timeout)
                                 throws <A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></PRE>
<DL>
<DD>Stop the periodic reporting for all registered filters to the specified Peer corresponding to this MonitorListener.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>peerID</CODE> - The Peer that you wish to deregister periodic reporting<DD><CODE>monitorListener</CODE> - The MonitorListener that was originally registered<DD><CODE>timeout</CODE> - The timeout for reporting that the remote listener was acknowledged as deregistered
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="removeRemoteMonitorListener(net.jxta.meter.MonitorListener, long)"><!-- --></A><H3>
removeRemoteMonitorListener</H3>
<PRE>
public void <B>removeRemoteMonitorListener</B>(<A HREF="../../../net/jxta/meter/MonitorListener.html" title="interface in net.jxta.meter">MonitorListener</A>&nbsp;monitorListener,
                                        long&nbsp;timeout)
                                 throws <A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></PRE>
<DL>
<DD>Stop the periodic reporting for all registered filters to the all remote Peers corresponding to this MonitorListener.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>monitorListener</CODE> - The MonitorListener that was originally registered<DD><CODE>timeout</CODE> - The timeout for reporting that the remote listener was acknowledged as deregistered
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></CODE></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/PeerInfoService.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/peer/PeerInfoListener.html" title="interface in net.jxta.peer"><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="PeerInfoService.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>