peerinfoservice.html

jxta的api库

<TD><CODE><B><A HREF="../../../net/jxta/peer/PeerInfoService.html#getPeerMonitorInfo(net.jxta.peer.PeerID, net.jxta.meter.PeerMonitorInfoListener, long)">getPeerMonitorInfo</A></B>(<A HREF="../../../net/jxta/peer/PeerID.html" title="class in net.jxta.peer">PeerID</A>&nbsp;peerID,
                   <A HREF="../../../net/jxta/meter/PeerMonitorInfoListener.html" title="interface in net.jxta.meter">PeerMonitorInfoListener</A>&nbsp;peerMonitorInfoListener,
                   long&nbsp;timeout)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Obtain the monitoring capabilities of a Remote Peer. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;long[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../net/jxta/peer/PeerInfoService.html#getSupportedReportRates()">getSupportedReportRates</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Asynchronous reporting of Monitored data may be obtained only at rates supported by 
		the MonitorManager on the peer.  </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/peer/PeerInfoService.html#isLocalMonitoringAvailable()">isLocalMonitoringAvailable</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;See if Local Monitoring is available on this Peer
		Local monitoring is only available if you are using a version of 
		of jxta.jar that was build with metering activated.  </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/peer/PeerInfoService.html#isLocalMonitoringAvailable(net.jxta.platform.ModuleClassID)">isLocalMonitoringAvailable</A></B>(<A HREF="../../../net/jxta/platform/ModuleClassID.html" title="class in net.jxta.platform">ModuleClassID</A>&nbsp;moduleClassID)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;See if Local monitoring is available from a specific ServiceMonitor.  
		</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/peer/PeerInfoService.html#isSupportedReportRate(long)">isSupportedReportRate</A></B>(long&nbsp;reportRate)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Asynchronous reporting of Monitored data may be obtained only at rates supported by 
		the MonitorManager on the peer.  </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/peer/PeerInfoService.html#removeMonitorListener(net.jxta.meter.MonitorListener)">removeMonitorListener</A></B>(<A HREF="../../../net/jxta/meter/MonitorListener.html" title="interface in net.jxta.meter">MonitorListener</A>&nbsp;monitorListener)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Stop the periodic reporting for all registered filters corresponding to this MonitorListener</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/peer/PeerInfoService.html#removeRemoteMonitorListener(net.jxta.meter.MonitorListener, long)">removeRemoteMonitorListener</A></B>(<A HREF="../../../net/jxta/meter/MonitorListener.html" title="interface in net.jxta.meter">MonitorListener</A>&nbsp;monitorListener,
                            long&nbsp;timeout)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Stop the periodic reporting for all registered filters to the all remote Peers corresponding to this MonitorListener.</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/peer/PeerInfoService.html#removeRemoteMonitorListener(net.jxta.peer.PeerID, net.jxta.meter.MonitorListener, long)">removeRemoteMonitorListener</A></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)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Stop the periodic reporting for all registered filters to the specified Peer corresponding to this MonitorListener.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_net.jxta.service.Service"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from interface net.jxta.service.<A HREF="../../../net/jxta/service/Service.html" title="interface in net.jxta.service">Service</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../net/jxta/service/Service.html#getImplAdvertisement()">getImplAdvertisement</A>, <A HREF="../../../net/jxta/service/Service.html#getInterface()">getInterface</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_net.jxta.platform.Module"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from interface net.jxta.platform.<A HREF="../../../net/jxta/platform/Module.html" title="interface in net.jxta.platform">Module</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../net/jxta/platform/Module.html#init(net.jxta.peergroup.PeerGroup, net.jxta.id.ID, net.jxta.document.Advertisement)">init</A>, <A HREF="../../../net/jxta/platform/Module.html#startApp(java.lang.String[])">startApp</A>, <A HREF="../../../net/jxta/platform/Module.html#stopApp()">stopApp</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

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


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


<!-- ============ 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="isLocalMonitoringAvailable()"><!-- --></A><H3>
isLocalMonitoringAvailable</H3>
<PRE>
public boolean <B>isLocalMonitoringAvailable</B>()</PRE>
<DL>
<DD>See if Local Monitoring is available on this Peer
		Local monitoring is only available if you are using a version of 
		of jxta.jar that was build with metering activated.  <p>

		See the document: 
					<UL>
	  					<LI> <I> Building and Configuring JXTA with Monitoring Capabilities </I> </LI>
					</UL>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="isLocalMonitoringAvailable(net.jxta.platform.ModuleClassID)"><!-- --></A><H3>
isLocalMonitoringAvailable</H3>
<PRE>
public boolean <B>isLocalMonitoringAvailable</B>(<A HREF="../../../net/jxta/platform/ModuleClassID.html" title="class in net.jxta.platform">ModuleClassID</A>&nbsp;moduleClassID)</PRE>
<DL>
<DD>See if Local monitoring is available from a specific ServiceMonitor.  
		Local monitoring is only available if you are using a version of 
		of jxta.jar that was build with metering activated.  <p>

 	See the document: 
					<UL>
   					<LI> <I> Building and Configuring JXTA with Monitoring Capabilities </I> </LI>
					</UL>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>moduleClassID</CODE> - The Module classID of the ServiceMonitor.  Note that the ServiceMonitor
								moduleClassID is not the same as moduleClassID of the Service 
								being monitored.</DL>
</DD>
</DL>
<HR>

<A NAME="getSupportedReportRates()"><!-- --></A><H3>
getSupportedReportRates</H3>
<PRE>
public long[] <B>getSupportedReportRates</B>()</PRE>
<DL>
<DD>Asynchronous reporting of Monitored data may be obtained only at rates supported by 
		the MonitorManager on the peer.  This method returns the locally supported rates (in milliseconds)
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="isSupportedReportRate(long)"><!-- --></A><H3>
isSupportedReportRate</H3>
<PRE>
public boolean <B>isSupportedReportRate</B>(long&nbsp;reportRate)</PRE>
<DL>
<DD>Asynchronous reporting of Monitored data may be obtained only at rates supported by 
		the MonitorManager on the peer.  This method validates whether a specific
		rate (in milliseconds) is locally supported.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getBestReportRate(long)"><!-- --></A><H3>
getBestReportRate</H3>
<PRE>
public long <B>getBestReportRate</B>(long&nbsp;desiredReportRate)</PRE>
<DL>
<DD>Asynchronous reporting of Monitored data may be obtained only at rates supported by 
		the MonitorManager on the peer.  This method supplies the closest (rounded up) 
		rate (in milliseconds) to the specified rate that is locally supported.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getPeerMonitorInfo()"><!-- --></A><H3>
getPeerMonitorInfo</H3>
<PRE>
public <A HREF="../../../net/jxta/meter/PeerMonitorInfo.html" title="class in net.jxta.meter">PeerMonitorInfo</A> <B>getPeerMonitorInfo</B>()</PRE>
<DL>
<DD>Obtain the monitoring capabilities of the Local Peer. <P>
		 The PeerMonitorInfo provides:
					<UL>
	  					<LI> Whether any monitoring is available for this Peer </LI>
	  					<LI> The supported rates of asynchronous monitoring </LI>
	  					<LI> A list (as ModuleClassIDs) of ServiceMonitors attached to this Peer </LI>
					</UL>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getPeerMonitorInfo(net.jxta.peer.PeerID, net.jxta.meter.PeerMonitorInfoListener, long)"><!-- --></A><H3>
getPeerMonitorInfo</H3>
<PRE>
public void <B>getPeerMonitorInfo</B>(<A HREF="../../../net/jxta/peer/PeerID.html" title="class in net.jxta.peer">PeerID</A>&nbsp;peerID,
                               <A HREF="../../../net/jxta/meter/PeerMonitorInfoListener.html" title="interface in net.jxta.meter">PeerMonitorInfoListener</A>&nbsp;peerMonitorInfoListener,
                               long&nbsp;timeout)
                        throws <A HREF="../../../net/jxta/meter/MonitorException.html" title="class in net.jxta.meter">MonitorException</A></PRE>
<DL>
<DD>Obtain the monitoring capabilities of a Remote Peer. <P>
		 The PeerMonitorInfo provides:
					<UL>
	  					<LI> Whether any monitoring is available for this Peer </LI>
	  					<LI> The supported rates of asynchronous monitoring </LI>
	  					<LI> A list (as ModuleClassIDs) of ServiceMonitors attached to this Peer </LI>
					</UL>

		Via the PeerMonitorInfoListener, you will be informed of the PeerMonitorInfo or why it was
		not provided (error, timeout, unavailable, etc)