threadmxbean.html

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

<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="ThreadMXBean.html#isThreadContentionMonitoringSupported()">isThreadContentionMonitoringSupported</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;测试 Java 虚拟机是否支持线程争用监视。</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="ThreadMXBean.html#isThreadCpuTimeEnabled()">isThreadCpuTimeEnabled</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;测试是否启用了线程 CPU 时间测量。</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="ThreadMXBean.html#isThreadCpuTimeSupported()">isThreadCpuTimeSupported</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;测试 Java 虚拟机实现是否支持任何线程的 CPU 时间测量。</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="ThreadMXBean.html#resetPeakThreadCount()">resetPeakThreadCount</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将峰值线程计数重置为当前活动线程的数量。</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="ThreadMXBean.html#setThreadContentionMonitoringEnabled(boolean)">setThreadContentionMonitoringEnabled</A></B>(boolean&nbsp;enable)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;启用或禁用线程争用监视。</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="ThreadMXBean.html#setThreadCpuTimeEnabled(boolean)">setThreadCpuTimeEnabled</A></B>(boolean&nbsp;enable)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;启用或禁用线程 CPU 时间测量。</TD>
</TR>
</TABLE>
&nbsp;
<P>

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

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="getThreadCount()"><!-- --></A><H3>
getThreadCount</H3>
<PRE>
int <B>getThreadCount</B>()</PRE>
<DL>
<DD>返回活动线程的当前数目，包括守护线程和非守护线程。
<P>
<DD><DL>

<DT><B>返回：</B><DD>活动线程的当前数目。</DL>
</DD>
</DL>
<HR>

<A NAME="getPeakThreadCount()"><!-- --></A><H3>
getPeakThreadCount</H3>
<PRE>
int <B>getPeakThreadCount</B>()</PRE>
<DL>
<DD>返回自从 Java 虚拟机启动或峰值重置以来峰值活动线程计数。
<P>
<DD><DL>

<DT><B>返回：</B><DD>峰值活动线程计数。</DL>
</DD>
</DL>
<HR>

<A NAME="getTotalStartedThreadCount()"><!-- --></A><H3>
getTotalStartedThreadCount</H3>
<PRE>
long <B>getTotalStartedThreadCount</B>()</PRE>
<DL>
<DD>返回自从 Java 虚拟机启动以来创建和启动的线程总数目。
<P>
<DD><DL>

<DT><B>返回：</B><DD>已启动的线程的总数。</DL>
</DD>
</DL>
<HR>

<A NAME="getDaemonThreadCount()"><!-- --></A><H3>
getDaemonThreadCount</H3>
<PRE>
int <B>getDaemonThreadCount</B>()</PRE>
<DL>
<DD>返回活动守护线程的当前数目。
<P>
<DD><DL>

<DT><B>返回：</B><DD>活动守护线程的当前数目。</DL>
</DD>
</DL>
<HR>

<A NAME="getAllThreadIds()"><!-- --></A><H3>
getAllThreadIds</H3>
<PRE>
long[] <B>getAllThreadIds</B>()</PRE>
<DL>
<DD>返回活动线程 ID。在返回的数组中包含的某些线程可能在此方法返回时已经终止。
<P>
<DD><DL>

<DT><B>返回：</B><DD><tt>long</tt> 数组，每个成员都是线程 ID。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果存在安全管理器，且调用方不具有 ManagementPermission("monitor")。</DL>
</DD>
</DL>
<HR>

<A NAME="getThreadInfo(long)"><!-- --></A><H3>
getThreadInfo</H3>
<PRE>
<A HREF="ThreadInfo.html" title="java.lang.management 中的类">ThreadInfo</A> <B>getThreadInfo</B>(long&nbsp;id)</PRE>
<DL>
<DD>返回指定 <tt>id</tt> 的不具有堆栈跟踪的线程的线程信息。 此方法等效于调用：
 <blockquote>
   <A HREF="ThreadMXBean.html#getThreadInfo(long, int)"><CODE>getThreadInfo(id, 0);</CODE></A>
 </blockquote>

 <p>
此方法返回表示指定 ID 的线程的线程信息的 <tt>ThreadInfo</tt> 对象。返回的 <tt>ThreadInfo</tt> 对象中的堆栈跟踪将为一个空的 <tt>StackTraceElement</tt> 数组。

如果给定 ID 的线程不为活动状态，或不存在，此方法将返回 <tt>null</tt>。如果线程已经启动且尚未终止，则该线程处于活动状态。

<p>
<b>MBeanServer 访问</b>：<br><tt>ThreadInfo</tt> 的映射类型为 <tt>CompositeData</tt>，具有 <A HREF="ThreadInfo.html#from(javax.management.openmbean.CompositeData)"><CODE>ThreadInfo</CODE></A> 中指定的那些属性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>id</CODE> - 线程的线程 ID。必须为正数。
<DT><B>返回：</B><DD>给定 ID 的不具有堆栈跟踪的线程的 <A HREF="ThreadInfo.html" title="java.lang.management 中的类"><CODE>ThreadInfo</CODE></A> 对象；如果给定 ID 的线程不为活动状态，或不存在，则返回 <tt>null</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>id &lt= 0</tt>。
<DD><CODE><A HREF="../SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果存在安全管理器，且调用方不具有 ManagementPermission("monitor")。</DL>
</DD>
</DL>
<HR>

<A NAME="getThreadInfo(long[])"><!-- --></A><H3>
getThreadInfo</H3>
<PRE>
<A HREF="ThreadInfo.html" title="java.lang.management 中的类">ThreadInfo</A>[] <B>getThreadInfo</B>(long[]&nbsp;ids)</PRE>
<DL>
<DD>返回其 ID 在输出数组 <tt>ids</tt> 中的每个线程的线程信息，这些线程不具有堆栈跟踪。此方法等效于调用：
 <blockquote><pre>
   <A HREF="ThreadMXBean.html#getThreadInfo(long[], int)"><CODE>getThreadInfo</CODE></A>(ids, 0);
 </pre></blockquote>

<p>
此方法返回 <tt>ThreadInfo</tt> 对象数组。每个 <tt>ThreadInfo</tt> 对象中的堆栈跟踪将为空的 <tt>StackTraceElement</tt> 数组。

如果给定 ID 的线程不为活动状态，或不存在，返回数组中的对应元素将包含 <tt>null</tt>。如果线程已经启动且尚未终止，则该线程处于活动状态。

<p>
<b>MBeanServer 访问</b>：<br><tt>ThreadInfo</tt> 的映射类型为 <tt>CompositeData</tt>，具有 <A HREF="ThreadInfo.html#from(javax.management.openmbean.CompositeData)"><CODE>ThreadInfo</CODE></A> 中指定的那些属性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>ids</CODE> - 线程 ID 数组
<DT><B>返回：</B><DD>一个 <A HREF="ThreadInfo.html" title="java.lang.management 中的类"><CODE>ThreadInfo</CODE></A> 对象的数组，每个成员均包含关于其 ID 在 IDs 输入数组的对应元素中的线程的信息。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果输入数组 <tt>ids</tt> 中的任何元素 <tt>&lt= 0</tt>。
<DD><CODE><A HREF="../SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果存在安全管理器，且调用方不具有 ManagementPermission("monitor")。</DL>
</DD>
</DL>
<HR>

<A NAME="getThreadInfo(long, int)"><!-- --></A><H3>
getThreadInfo</H3>
<PRE>
<A HREF="ThreadInfo.html" title="java.lang.management 中的类">ThreadInfo</A> <B>getThreadInfo</B>(long&nbsp;id,
                         int&nbsp;maxDepth)</PRE>
<DL>
<DD>返回指定的 <tt>id</tt> 的线程的线程信息。<tt>maxDepth</tt> 参数指示可从堆栈跟踪检索的 <tt>StackTraceElement</tt> 的最大数目。如果 <tt>maxDepth == Integer.MAX_VALUE</tt>，则将转储线程的整个堆栈跟踪。如果 <tt>maxDepth == 0</tt>，将不转储线程的任何堆栈跟踪。
<p>
当 Java 虚拟机没有关于线程的堆栈跟踪信息或 <tt>maxDepth == 0</tt> 时，<tt>ThreadInfo</tt> 对象中的堆栈跟踪将为空的 <tt>StackTraceElement</tt> 数组。

<p>
如果给定 ID 的线程不为活动状态，或不存在，此方法将返回 <tt>null</tt>。如果线程已经启动且尚未终止，则该线程处于活动状态。

<p>
<b>MBeanServer 访问</b>：<br><tt>ThreadInfo</tt> 的映射类型为 <tt>CompositeData</tt>，具有 <A HREF="ThreadInfo.html#from(javax.management.openmbean.CompositeData)"><CODE>ThreadInfo</CODE></A> 中指定的那些属性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>id</CODE> - 线程的线程 ID。必须为正数。<DD><CODE>maxDepth</CODE> - 要转储的堆栈跟踪中的最大项数。<tt>Integer.MAX_VALUE</tt> 可以用于请求将整个堆栈转储。
<DT><B>返回：</B><DD>给定 ID 的线程的 <A HREF="ThreadInfo.html" title="java.lang.management 中的类"><CODE>ThreadInfo</CODE></A>。如果给定 ID 的线程不为活动状态，或不存在，则返回 <tt>null</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>id &lt= 0</tt>。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>maxDepth 为负数</tt>。
<DD><CODE><A HREF="../SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果存在安全管理器，且调用方不具有 ManagementPermission("monitor")。</DL>
</DD>
</DL>
<HR>

<A NAME="getThreadInfo(long[], int)"><!-- --></A><H3>
getThreadInfo</H3>
<PRE>
<A HREF="ThreadInfo.html" title="java.lang.management 中的类">ThreadInfo</A>[] <B>getThreadInfo</B>(long[]&nbsp;ids,
                           int&nbsp;maxDepth)</PRE>
<DL>
<DD>返回其 ID 在输入数组 <tt>ids</tt> 中的每个线程的线程信息。<tt>maxDepth</tt> 参数指示可从堆栈跟踪检索的 <tt>StackTraceElement</tt> 的最大数目。如果 <tt>maxDepth == Integer.MAX_VALUE</tt>，则将转储线程的整个堆栈跟踪。如果 <tt>maxDepth == 0</tt>，将不转储线程的任何堆栈跟踪。
<p>
当 Java 虚拟机没有关于线程的堆栈跟踪信息或 <tt>maxDepth == 0</tt> 时，<tt>ThreadInfo</tt> 对象中的堆栈跟踪将为空的 <tt>StackTraceElement</tt> 数组。
<p>
此方法返回一个 <tt>ThreadInfo</tt> 对象的数组，其每个成员均为关于线程的线程信息，索引顺序与 <tt>ids</tt> 数组中索引相同。如果给定 ID 的线程不为活动状态，或不存在，返回数组中的对应元素将设置为 <tt>null</tt>。如果线程已经启动且尚未终止，则该线程处于活动状态。

<p>
<b>MBeanServer 访问</b>：<br><tt>ThreadInfo</tt> 的映射类型为 <tt>CompositeData</tt>，具有 <A HREF="ThreadInfo.html#from(javax.management.openmbean.CompositeData)"><CODE>ThreadInfo</CODE></A> 中指定的那些属性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>ids</CODE> - 线程 ID 数组<DD><CODE>maxDepth</CODE> - 要转储的堆栈跟踪中的最大项数。<tt>Integer.MAX_VALUE</tt> 可以用于请求将整个堆栈转储。
<DT><B>返回：</B><DD>一个 <A HREF="ThreadInfo.html" title="java.lang.management 中的类"><CODE>ThreadInfo</CODE></A> 对象的数组，每个成员均包含关于其 ID 在 IDs 输入数组的对应元素中的线程的信息。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>maxDepth 为负数</tt>。
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果输入数组 <tt>ids</tt> 中的任何元素 <tt>&lt= 0</tt>。
<DD><CODE><A HREF="../SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果存在安全管理器，且调用方不具有 ManagementPermission("monitor")。</DL>
</DD>
</DL>
<HR>

<A NAME="isThreadContentionMonitoringSupported()"><!-- --></A><H3>
isThreadContentionMonitoringSupported</H3>
<PRE>
boolean <B>isThreadContentionMonitoringSupported</B>()</PRE>
<DL>
<DD>测试 Java 虚拟机是否支持线程争用监视。
<P>
<DD><DL>

<DT><B>返回：</B><DD>如果 Java 虚拟机支持线程争用监视，则返回 <tt>true</tt>；否则返回 <tt>false</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="isThreadContentionMonitoringEnabled()"><!-- --></A><H3>
isThreadContentionMonitoringEnabled</H3>
<PRE>
boolean <B>isThreadContentionMonitoringEnabled</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> - 如果 Java 虚拟机不支持线程争用监视。<DT><B>另请参见：</B><DD><A HREF="ThreadMXBean.html#isThreadContentionMonitoringSupported()"><CODE>isThreadContentionMonitoringSupported()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setThreadContentionMonitoringEnabled(boolean)"><!-- --></A><H3>
setThreadContentionMonitoringEnabled</H3>
<PRE>