memorypoolmxbean.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 806 行 · 第 1/3 页

<PRE>
boolean <B>isValid</B>()</PRE>
<DL>
<DD>测试此内存池在 Java 虚拟机中是否有效。一旦 Java 虚拟机将内存池从内存系统删除，该内存池就变为无效。
<P>
<DD><DL>

<DT><B>返回：</B><DD>如果内存池在正在运行的 Java 虚拟机中有效，则返回 <tt>true</tt>；否则返回 <tt>false</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="getMemoryManagerNames()"><!-- --></A><H3>
getMemoryManagerNames</H3>
<PRE>
<A HREF="../String.html" title="java.lang 中的类">String</A>[] <B>getMemoryManagerNames</B>()</PRE>
<DL>
<DD>返回管理此内存池的内存管理器的名称。每个内存池将由至少一个内存管理器进行管理。
<P>
<DD><DL>

<DT><B>返回：</B><DD><tt>String</tt> 对象的一个数组，其中每个对象都是管理此内存池的内存管理器的名称。</DL>
</DD>
</DL>
<HR>

<A NAME="getUsageThreshold()"><!-- --></A><H3>
getUsageThreshold</H3>
<PRE>
long <B>getUsageThreshold</B>()</PRE>
<DL>
<DD>返回此内存池的使用量阈值（以字节为单位）。每个内存池都具有一个与平台有关的默认阈值。可以通过 <A HREF="MemoryPoolMXBean.html#setUsageThreshold(long)"><CODE>setUsageThreshold</CODE></A> 方法更改当前的使用量阈值。
<P>
<DD><DL>

<DT><B>返回：</B><DD>此内存池的使用量阈值（以字节为单位）。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此内存池不支持使用量阈值。<DT><B>另请参见：</B><DD><A HREF="MemoryPoolMXBean.html#isUsageThresholdSupported()"><CODE>isUsageThresholdSupported()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setUsageThreshold(long)"><!-- --></A><H3>
setUsageThreshold</H3>
<PRE>
void <B>setUsageThreshold</B>(long&nbsp;threshold)</PRE>
<DL>
<DD>如果此内存池支持使用量阈值，则将此内存池的阈值设置为给定的 <tt>threshold</tt> 值。如果阈值设置为正数，将启用此内存池中的使用量阈值超过检查。如果设置为零，则将禁用使用量阈值超过检查。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>threshold</CODE> - 新阈值（以字节为单位）。必须为非负数。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>threshold</tt> 为负或大于此内存池的最大内存量（如果已定义）。
<DD><CODE><A HREF="../UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此内存池不支持使用量阈值。
<DD><CODE><A HREF="../SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果存在安全管理器，且调用方不具有 ManagementPermission("control")。<DT><B>另请参见：</B><DD><A HREF="MemoryPoolMXBean.html#isUsageThresholdSupported()"><CODE>isUsageThresholdSupported()</CODE></A>, 
<a href="#UsageThreshold">使用量阈值</a></DL>
</DD>
</DL>
<HR>

<A NAME="isUsageThresholdExceeded()"><!-- --></A><H3>
isUsageThresholdExceeded</H3>
<PRE>
boolean <B>isUsageThresholdExceeded</B>()</PRE>
<DL>
<DD>测试此内存池的使用量是否达到或超过其使用量阈值。
<P>
<DD><DL>

<DT><B>返回：</B><DD>如果此内存池的使用量达到或超过了阈值，则返回 <tt>true</tt>；否则返回 <tt>false</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此内存池不支持使用量阈值。</DL>
</DD>
</DL>
<HR>

<A NAME="getUsageThresholdCount()"><!-- --></A><H3>
getUsageThresholdCount</H3>
<PRE>
long <B>getUsageThresholdCount</B>()</PRE>
<DL>
<DD>返回内存使用量超过其阈值的次数。
<P>
<DD><DL>

<DT><B>返回：</B><DD>内存使用量超过其阈值的次数。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此内存池不支持使用量阈值。</DL>
</DD>
</DL>
<HR>

<A NAME="isUsageThresholdSupported()"><!-- --></A><H3>
isUsageThresholdSupported</H3>
<PRE>
boolean <B>isUsageThresholdSupported</B>()</PRE>
<DL>
<DD>测试此内存池是否支持使用量阈值。
<P>
<DD><DL>

<DT><B>返回：</B><DD>如果此内存池支持使用量阈值，则返回 <tt>true</tt>；否则返回 <tt>false</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="getCollectionUsageThreshold()"><!-- --></A><H3>
getCollectionUsageThreshold</H3>
<PRE>
long <B>getCollectionUsageThreshold</B>()</PRE>
<DL>
<DD>返回此内存池的回收使用量阈值（以字节为单位）。默认值为零。可以通过 <A HREF="MemoryPoolMXBean.html#setCollectionUsageThreshold(long)"><CODE>setCollectionUsageThreshold</CODE></A> 方法更改回收使用量阈值。
<P>
<DD><DL>

<DT><B>返回：</B><DD>此内存池的回收使用量阈值（以字节为单位）。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此内存池不支持回收使用量阈值。<DT><B>另请参见：</B><DD><A HREF="MemoryPoolMXBean.html#isCollectionUsageThresholdSupported()"><CODE>isCollectionUsageThresholdSupported()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setCollectionUsageThreshold(long)"><!-- --></A><H3>
setCollectionUsageThreshold</H3>
<PRE>
void <B>setCollectionUsageThreshold</B>(long&nbsp;threhsold)</PRE>
<DL>
<DD>将此内存池的回收使用量阈值设置为给定的 <tt>threshold</tt> 值。当此阈值设置为正数时，Java 虚拟机将在对此内存池中不使用的对象进行了回收工作后，在最恰当的时间检查内存使用量。
 <p>
如果阈值设置为正数，将启用此内存池中的回收使用量阈值超过检查。如果设置为零，则将禁用回收使用量阈值超过检查。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>threhsold</CODE> - 新的回收使用量阈值（以字节为单位）。必须为非负数。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>threshold</tt> 为负或大于此内存池的最大内存量（如果已定义）。
<DD><CODE><A HREF="../UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此内存池不支持回收使用量阈值。
<DD><CODE><A HREF="../SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果存在安全管理器，且调用方不具有 ManagementPermission("control")。<DT><B>另请参见：</B><DD><A HREF="MemoryPoolMXBean.html#isCollectionUsageThresholdSupported()"><CODE>isCollectionUsageThresholdSupported()</CODE></A>, 
<a href="#CollectionThreshold">回收使用量阈值</a></DL>
</DD>
</DL>
<HR>

<A NAME="isCollectionUsageThresholdExceeded()"><!-- --></A><H3>
isCollectionUsageThresholdExceeded</H3>
<PRE>
boolean <B>isCollectionUsageThresholdExceeded</B>()</PRE>
<DL>
<DD>测试在 Java 虚拟机最近一次回收工作之后，此内存池的内存使用量是否达到或超过了其回收使用量阈值。此方法不会请求 Java 虚拟机执行其正常自动内存管理之外的任何垃圾回收操作。
<P>
<DD><DL>

<DT><B>返回：</B><DD>如果在最近的回收操作中，此内存池的使用量达到或超过了回收使用阈值，则返回 <tt>true</tt>；否则返回 <tt>false</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此内存池不支持使用量阈值。</DL>
</DD>
</DL>
<HR>

<A NAME="getCollectionUsageThresholdCount()"><!-- --></A><H3>
getCollectionUsageThresholdCount</H3>
<PRE>
long <B>getCollectionUsageThresholdCount</B>()</PRE>
<DL>
<DD>返回 Java 虚拟机已检测到内存使用量达到或超过回收使用量阈值的次数。
<P>
<DD><DL>

<DT><B>返回：</B><DD>内存使用量达到或超过回收使用量阈值的次数。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果此内存池不支持回收使用量阈值。<DT><B>另请参见：</B><DD><A HREF="MemoryPoolMXBean.html#isCollectionUsageThresholdSupported()"><CODE>isCollectionUsageThresholdSupported()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getCollectionUsage()"><!-- --></A><H3>
getCollectionUsage</H3>
<PRE>
<A HREF="MemoryUsage.html" title="java.lang.management 中的类">MemoryUsage</A> <B>getCollectionUsage</B>()</PRE>
<DL>
<DD>返回 Java 虚拟机最近回收了此内存池中的不使用的对象之后的内存使用量。此方法不会请求 Java 虚拟机执行其正常的自动内存管理之外的任何垃圾回收操作。如果 Java 虚拟机不支持此方法，此方法将返回 <tt>null</tt>。
 
<p>
<b>MBeanServer 访问</b>：<br><tt>MemoryUsage</tt> 的映射类型为 <tt>CompositeData</tt>，具有 <A HREF="MemoryUsage.html#from(javax.management.openmbean.CompositeData)"><CODE>MemoryUsage</CODE></A> 中指定的那些属性。
<P>
<DD><DL>

<DT><B>返回：</B><DD>表示 Java 虚拟机最近对不使用的对象进行了回收之后此内存池的内存使用量的 <A HREF="MemoryUsage.html" title="java.lang.management 中的类"><CODE>MemoryUsage</CODE></A>；如果不支持此方法，则返回 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="isCollectionUsageThresholdSupported()"><!-- --></A><H3>
isCollectionUsageThresholdSupported</H3>
<PRE>
boolean <B>isCollectionUsageThresholdSupported</B>()</PRE>
<DL>
<DD>测试此内存池是否支持回收使用量阈值。
<P>
<DD><DL>

<DT><B>返回：</B><DD>如果此内存池支持回收使用量阈值，则返回 <tt>true</tt>；否则返回 <tt>false</tt>。</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="跳过导航链接"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 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>概述</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>类</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/MemoryPoolMXBean.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Standard&nbsp;Ed. 5.0</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="MemoryNotificationInfo.html" title="java.lang.management 中的类"><B>上一个类</B></A>&nbsp;
&nbsp;<A HREF="MemoryType.html" title="java.lang.management 中的枚举"><B>下一个类</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html@java_2Flang_2Fmanagement_2FMemoryPoolMXBean.html" target="_top"><B>框架</B></A>  &nbsp;
&nbsp;<A HREF="MemoryPoolMXBean.html" target="_top"><B>无框架</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  摘要：&nbsp;嵌套&nbsp;|&nbsp;字段&nbsp;|&nbsp;构造方法&nbsp;|&nbsp;<A HREF="#method_summary">方法</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
详细信息：&nbsp;字段&nbsp;|&nbsp;构造方法&nbsp;|&nbsp;<A HREF="#method_detail">方法</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<font size="-1"><a href="../../../../../../../../../java.sun.com/cgi-bin/bugreport.cgi">提交错误或意见</a><br>有关更多的 API 参考资料和开发人员文档，请参阅 <a href="../../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/devdocs-vs-specs.html">Java 2 SDK SE 开发人员文档</a>。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。 <p>版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守<a href="../../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/license.html">许可证条款</a>。另请参阅<a href="../../../../../../../../../java.sun.com/docs/redist.html">文档重新分发政策</a>。</font>
</BODY>
</HTML>