threadinfo.html

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

<P>
<DD><DL>

<DT><B>返回：</B><DD>线程进入 <tt>BLOCKED</tt> 状态的近似累积时间（以毫秒为单位）；如果禁用了线程争用监视，则返回 <tt>-1</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>ThreadMXBean.isThreadContentionMonitoringSupported()</CODE></A>, 
<A HREF="ThreadMXBean.html#setThreadContentionMonitoringEnabled(boolean)"><CODE>ThreadMXBean.setThreadContentionMonitoringEnabled(boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getBlockedCount()"><!-- --></A><H3>
getBlockedCount</H3>
<PRE>
public long <B>getBlockedCount</B>()</PRE>
<DL>
<DD>返回与此 <tt>ThreadInfo</tt> 相关的被阻塞的线程进入或重新进入监视器的总次数。即线程为 <A HREF="../Thread.State.html#BLOCKED"><CODE>BLOCKED</CODE></A> 状态的次数。
<P>
<DD><DL>

<DT><B>返回：</B><DD>线程进入 <tt>BLOCKED</tt> 状态的总次数。</DL>
</DD>
</DL>
<HR>

<A NAME="getWaitedTime()"><!-- --></A><H3>
getWaitedTime</H3>
<PRE>
public long <B>getWaitedTime</B>()</PRE>
<DL>
<DD>返回自从启用线程争用监视以来,与此 <tt>ThreadInfo</tt> 相关的线程等待通知的近似累积时间（以毫秒为单位）。即自从启用线程争用监视以来，线程为 <A HREF="../Thread.State.html#WAITING"><CODE>WAITING</CODE></A> 或 <A HREF="../Thread.State.html#TIMED_WAITING"><CODE>TIMED_WAITING</CODE></A> 状态的总累积时间。如果线程争用监视被禁用，此方法将返回 <tt>-1</tt>。

<p>Java 虚拟机可能会使用高精度计时器测量时间。当重新启用线程争用监视时，将重置这个统计数据。
<P>
<DD><DL>

<DT><B>返回：</B><DD>线程为 <tt>WAITING</tt> 或 <tt>TIMED_WAITING</tt> 状态的近似累积时间（以毫秒为单位）；如果禁用了线程争用监视，则返回 <tt>-1</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>ThreadMXBean.isThreadContentionMonitoringSupported()</CODE></A>, 
<A HREF="ThreadMXBean.html#setThreadContentionMonitoringEnabled(boolean)"><CODE>ThreadMXBean.setThreadContentionMonitoringEnabled(boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getWaitedCount()"><!-- --></A><H3>
getWaitedCount</H3>
<PRE>
public long <B>getWaitedCount</B>()</PRE>
<DL>
<DD>返回与此 <tt>ThreadInfo</tt> 相关的线程等待通知的总次数。即线程为 <A HREF="../Thread.State.html#WAITING"><CODE>WAITING</CODE></A> 或 <A HREF="../Thread.State.html#TIMED_WAITING"><CODE>TIMED_WAITING</CODE></A> 状态的次数。
<P>
<DD><DL>

<DT><B>返回：</B><DD>线程为 <tt>WAITING</tt> 或 <tt>TIMED_WAITING</tt> 状态的总次数。</DL>
</DD>
</DL>
<HR>

<A NAME="getLockName()"><!-- --></A><H3>
getLockName</H3>
<PRE>
public <A HREF="../String.html" title="java.lang 中的类">String</A> <B>getLockName</B>()</PRE>
<DL>
<DD>返回监视器锁定的字符串表示形式，与此 <tt>ThreadInfo</tt> 相关的线程被锁定进入或正等待通过 <A HREF="../Object.html#wait(long)"><CODE>Object.wait</CODE></A> 方法得到通知。返回的监视器锁定字符串表示形式由以下内容组成：类（该对象是它的一个实例）名称、at 标记字符 '@' 和对象的 <em>identity</em> 哈希代码的十六进制无符号表示形式。根据 <A HREF="../System.html#identityHashCode(java.lang.Object)"><CODE>System.identityHashCode(java.lang.Object)</CODE></A> 方法的实现不同，返回的字符串可能不是惟一的。此方法返回的字符串等于以下表达式的值：
 <blockquote>
 <pre>
 lock.getClass().getName() + '@' + Integer.toHexString(System.identityHashCode(lock))
 </pre></blockquote>
其中 <tt>lock</tt> 为监视器锁定对象。

<p>如果线程没有被阻塞，可以进入任何监视对象，或者没有在监视器对象等待 <tt>Object.wait</tt> 调用中的通知，此方法将返回 <tt>null</tt>。
<P>
<DD><DL>

<DT><B>返回：</B><DD>监视器锁定的字符串表示形式，线程被阻塞而无法进入，或等待通过 <tt>Object.wait</tt> 方法得到通知（如果有）；否则为 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="getLockOwnerId()"><!-- --></A><H3>
getLockOwnerId</H3>
<PRE>
public long <B>getLockOwnerId</B>()</PRE>
<DL>
<DD>返回线程的 ID，此线程保持对象的监视器锁定，该对象上与此 <tt>ThreadInfo</tt> 相关的线程被阻塞。如果此线程没有被阻塞或没有在任何监视器上等待，或者，如果监视器锁定没有由任何线程保持，此方法将返回 <tt>-1</tt>。
<P>
<DD><DL>

<DT><B>返回：</B><DD>对象（此线程在其上阻塞）的监视器锁定的所有者线程的线程 ID；如果此检查没有被阻塞或没有在任何监视器上等待，或者，如果监视器锁定没有由任何线程保持，则返回 <tt>-1</tt>。<DT><B>另请参见：</B><DD><A HREF="ThreadInfo.html#getLockName()"><CODE>getLockName()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getLockOwnerName()"><!-- --></A><H3>
getLockOwnerName</H3>
<PRE>
public <A HREF="../String.html" title="java.lang 中的类">String</A> <B>getLockOwnerName</B>()</PRE>
<DL>
<DD>返回线程的名称，此线程保持对象的监视器锁定，该对象上与此 <tt>ThreadInfo</tt> 相关的线程被阻塞。如果此线程没有被阻塞或没有在任何监视器上等待，或者，如果监视器锁定没有由任何线程保持，此方法将返回 <tt>null</tt>。
<P>
<DD><DL>

<DT><B>返回：</B><DD>保持对象（此线程在其上阻塞）的监视器锁定的线程的名称；如果此线程没有被阻塞或没有在任何监视器上等待，或者，如果监视器锁定没有由任何线程保持，则返回 <tt>null</tt>。<DT><B>另请参见：</B><DD><A HREF="ThreadInfo.html#getLockName()"><CODE>getLockName()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getStackTrace()"><!-- --></A><H3>
getStackTrace</H3>
<PRE>
public <A HREF="../StackTraceElement.html" title="java.lang 中的类">StackTraceElement</A>[] <B>getStackTrace</B>()</PRE>
<DL>
<DD>返回与此 <tt>ThreadInfo</tt> 相关的线程的堆栈跟踪。如果没有为此线程信息请求堆栈跟踪，此方法将返回零长度的数组。若返回的数组不是零长度的，则其第一个元素代表堆栈顶，它是该序列中最新的方法调用。最后一个元素代表堆栈底，是该序列中最旧的方法调用。

<p>某些 Java 虚拟机在某些情况下可能会从堆栈跟踪中省略一个或多个堆栈帧。在极端情况下，没有关于与此 <tt>ThreadInfo</tt> 相关的线程的堆栈跟踪信息的虚拟机可以从该方法返回一个零长度数组。
<P>
<DD><DL>

<DT><B>返回：</B><DD>线程的 <tt>StackTraceElement</tt> 对象数组。</DL>
</DD>
</DL>
<HR>

<A NAME="isSuspended()"><!-- --></A><H3>
isSuspended</H3>
<PRE>
public boolean <B>isSuspended</B>()</PRE>
<DL>
<DD>测试与此 <tt>ThreadInfo</tt> 相关的线程是否被挂起。如果已经调用了 <A HREF="../Thread.html#suspend()"><CODE>Thread.suspend()</CODE></A> 方法，此方法将返回 <tt>true</tt>。
<P>
<DD><DL>

<DT><B>返回：</B><DD>如果线程被挂起，则返回 <tt>true</tt>；否则返回 <tt>false</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="isInNative()"><!-- --></A><H3>
isInNative</H3>
<PRE>
public boolean <B>isInNative</B>()</PRE>
<DL>
<DD>测试与此 <tt>ThreadInfo</tt> 相关的线程是否通过 Java 本机接口 (JNI) 执行本机代码。JNI 本机代码不包括虚拟机支持代码或由虚拟机生成的已编译本机代码。
<P>
<DD><DL>

<DT><B>返回：</B><DD>如果线程执行本机代码，则返回 <tt>true</tt>；否则返回 <tt>false</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="toString()"><!-- --></A><H3>
toString</H3>
<PRE>
public <A HREF="../String.html" title="java.lang 中的类">String</A> <B>toString</B>()</PRE>
<DL>
<DD>返回此线程信息的字符串表示形式。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="../Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="../Object.html#toString()">toString</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此线程信息的字符串表示形式。</DL>
</DD>
</DL>
<HR>

<A NAME="from(javax.management.openmbean.CompositeData)"><!-- --></A><H3>
from</H3>
<PRE>
public static <A HREF="ThreadInfo.html" title="java.lang.management 中的类">ThreadInfo</A> <B>from</B>(javax.management.openmbean.CompositeData&nbsp;cd)</PRE>
<DL>
<DD>返回由给定 <tt>CompositeData</tt> 表示的 <tt>ThreadInfo</tt> 对象。给定的 <tt>CompositeData</tt> 必须包含以下属性：
<blockquote>
<table border>
<tr>
  <th align=left>属性名称</th>
  <th align=left>类型</th>
</tr>
<tr>
  <td>threadId</td>
  <td><tt>java.lang.Long</tt></td>
</tr>
<tr>
  <td>threadName</td>
  <td><tt>java.lang.String</tt></td>
</tr>
<tr>
  <td>threadState</td>
  <td><tt>java.lang.String</tt></td>
</tr>
<tr>
  <td>suspended</td>
  <td><tt>java.lang.Boolean</tt></td>
</tr>
<tr>
  <td>inNative</td>
  <td><tt>java.lang.Boolean</tt></td>
</tr>
<tr>
  <td>blockedCount</td>
  <td><tt>java.lang.Long</tt></td>
</tr>
<tr>
  <td>blockedTime</td>
  <td><tt>java.lang.Long</tt></td>
</tr>
<tr>
  <td>waitedCount</td>
  <td><tt>java.lang.Long</tt></td>
</tr>
<tr>
  <td>waitedTime</td>
  <td><tt>java.lang.Long</tt></td>
</tr>
<tr>
  <td>lockName</td>
  <td><tt>java.lang.String</tt></td>
</tr>
<tr>
  <td>lockOwnerId</td>
  <td><tt>java.lang.Long</tt></td>
</tr>
<tr>
  <td>lockOwnerName</td>
  <td><tt>java.lang.String</tt></td>
</tr>
<tr>
  <td>stackTrace</td>
  <td><tt>javax.management.openmbean.CompositeData[]</tt>
       <p>
每个元素都是表示 StackTraceElement 的 <tt>CompositeData</tt>，包含以下属性：
       <blockquote>
       <table cellspacing=1 cellpadding=0>
       <tr>
<th align=left>属性名称</th>
<th align=left>类型</th>
       </tr>
       <tr>
         <td>className</td>
         <td><tt>java.lang.String</tt></td>
       </tr>
       <tr>
         <td>methodName</td>
         <td><tt>java.lang.String</tt></td>
       </tr>
       <tr>
         <td>fileName</td>
         <td><tt>java.lang.String</tt></td>
       </tr>
       <tr>
         <td>lineNumber</td>
         <td><tt>java.lang.Integer</tt></td>
       </tr>
       <tr>
         <td>nativeMethod</td>
         <td><tt>java.lang.Boolean</tt></td>
       </tr>
       </table>
       </blockquote>
   </td>
 </tr>
 </table>
 </blockquote>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>cd</CODE> - 表示 <tt>ThreadInfo</tt> 的 <tt>CompositeData</tt>
<DT><B>返回：</B><DD>如果 <tt>cd</tt> 不为 <tt>null</tt>，则返回由 <tt>cd</tt> 表示的 <tt>ThreadInfo</tt> 对象；否则返回 <tt>null</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>cd</tt> 不表示具有上述属性的 <tt>ThreadInfo</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/ThreadInfo.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="RuntimeMXBean.html" title="java.lang.management 中的接口"><B>上一个类</B></A>&nbsp;
&nbsp;<A HREF="ThreadMXBean.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_2FThreadInfo.html" target="_top"><B>框架</B></A>  &nbsp;
&nbsp;<A HREF="ThreadInfo.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>