ThreadInfo (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | 생성자 | 메서드

상세: 필드 | 생성자 | 메서드

java.lang.management
클래스 ThreadInfo

java.lang.Object 
  java.lang.management.ThreadInfo

public class ThreadInfo
extends Object
extends Object

thread 정보입니다. ThreadInfo에는 thread에 관한 아래의 정보가 있습니다.

일반적인 thread 정보

thread ID
thread의 이름

실행 정보

thread 상태
thread가 블록 되어 동기 블록에의 이행을 대기하고 있다, 또는 Object.wait 호출에서의 통지를 대기하고 있는 객체
thread가 블록 되고 있는 객체를 소유하고 있는 thread의 ID
thread의 스택 트레이스

동기의 통계 정보

thread가 동기를 블록 한, 또는 통지를 대기한 회수
thread 컨텐션 감시가 유효하게 되고 나서, thread가 동기를 블록 한, 또는 통지를 대기한 누적 경과시간. 일부의 Java 가상 머신의 구현은 이 기능을 지원 하고 있지 않을 가능성이 있다. ThreadMXBean.isThreadContentionMonitoringSupported() 메서드를 사용해, Java 가상 머신이 이 기능을 지원 하고 있을지 어떨지를 판정할 수 있다

이 thread 정보 클래스는 동기 제어용은 아니고, 시스템의 감시에 사용되도록 설계되고 있습니다.

MXBean 매핑

ThreadInfo는 from 메서드로 지정된 속성을 가지는 CompositeData에 매핑 됩니다.

도입된 버전 :: 1.5
관련 항목:: ThreadMXBean.isThreadContentionMonitoringSupported()

메서드 개요
`static ThreadInfo`	`from (CompositeData cd)` 지정된 `CompositeData`에 의해 나타내지는 `ThreadInfo` 객체를 리턴합니다.
`long`	`getBlockedCount ()` 이 `ThreadInfo`에 관련된 thread가 모니터에 들어가는지, 재입 하는 것을 블록 한 합계 회수를 리턴합니다.
`long`	`getBlockedTime ()` thread 컨텐션 감시가 유효하게 되고 나서, 이 `ThreadInfo`에 관련된 thread가 모니터에 들어갈까 재입 하는 것을 블록 한 대략의 누적 경과시간 (밀리 세컨드 단위)을 리턴합니다.
`String`	`getLockName ()` 이 `ThreadInfo`에 관련된 thread가 모니터에 들어가는 것을 블록 된, 또는 `Object.wait` 메서드에 의해 통지되는 것을 대기하고 있는 모니터 락의 캐릭터 라인 표현.
`long`	`getLockOwnerId ()` 이 `ThreadInfo`에 관련된 thread가 블록 하고 있는 객체의 모니터 락을 보관 유지하고 있는 thread의 ID를 리턴합니다.
`String`	`getLockOwnerName ()` 이 `ThreadInfo`에 관련된 thread가 블록 하고 있는 객체의 모니터 락을 보관 유지하고 있는 thread의 이름을 리턴합니다.
`StackTraceElement []`	`getStackTrace ()` 이 `ThreadInfo`에 관련된 thread의 스택 트레이스를 리턴합니다.
`long`	`getThreadId ()` 이 `ThreadInfo`에 관련된 thread의 ID를 리턴합니다.
`String`	`getThreadName ()` 이 `ThreadInfo`에 관련된 thread의 이름을 리턴합니다.
`Thread.State`	`getThreadState ()` 이 `ThreadInfo`에 관련된 thread 상태를 리턴합니다.
`long`	`getWaitedCount ()` 이 `ThreadInfo`에 관련된 thread가 통지를 대기한 합계 회수를 리턴합니다.
`long`	`getWaitedTime ()` thread 컨텐션 감시가 유효하게 되고 나서, 이 `ThreadInfo`에 관련된 thread가 통지를 대기한 대략의 누적 경과시간 (밀리 세컨드 단위)을 리턴합니다.
`boolean`	`isInNative ()` 이 `ThreadInfo`에 관련된 thread가 JNI (Java Native Interface)를 사용해 native code를 실행하고 있을지 어떨지를 테스트합니다.
`boolean`	`isSuspended ()` 이 `ThreadInfo`에 관련된 thread가 중단되고 있는지를 테스트합니다.
`String`	`toString ()` 이 thread 정보의 캐릭터 라인 표현을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

메서드의 상세

getThreadId

public long getThreadId()

이 ThreadInfo에 관련된 thread의 ID를 리턴합니다.

반환값:: 관련된 thread의 ID

getThreadName

public String  getThreadName()

이 ThreadInfo에 관련된 thread의 이름을 리턴합니다.

반환값:: 관련된 thread의 이름

getThreadState

public Thread.State  getThreadState()

이 ThreadInfo에 관련된 thread 상태를 리턴합니다.

반환값:: 관련된 thread의 Thread.State

getBlockedTime

public long getBlockedTime()

thread 컨텐션 감시가 유효하게 되고 나서, 이 ThreadInfo에 관련된 thread가 모니터에 들어갈까 재입 하는 것을 블록 한 대략의 누적 경과시간 (밀리 세컨드 단위)을 리턴합니다. 즉, 이 시간은 thread 컨텐션 감시가 마지막에 유효하게 되고 나서 thread가 BLOCKED 상태가 되어 있던 합계의 누적 시간입니다. thread 컨텐션 감시가 무효의 경우, 이 thread는 -1을 리턴합니다.

Java 가상 머신은 고정밀도 타이머를 사용해 파악 할 수 있습니다. 이 통계 정보는 thread 컨텐션 감시가 다시 유효하게 되면 리셋 됩니다.

반환값:: thread가 BLOCKED 상태에 들어간 대략의 누적 경과시간 (밀리 세컨드 단위). thread 컨텐션 감시가 무효의 경우 -1
예외:: UnsupportedOperationException - Java 가상 머신이 이 조작을 지원 하고 있지 않는 경우
관련 항목:: ThreadMXBean.isThreadContentionMonitoringSupported(), ThreadMXBean.setThreadContentionMonitoringEnabled(boolean)

getBlockedCount

public long getBlockedCount()

이 ThreadInfo에 관련된 thread가 모니터에 들어가는지, 재입 하는 것을 블록 한 합계 회수를 리턴합니다. 즉, thread가 BLOCKED 상태인 합계 회수입니다.

반환값:: thread가 BLOCKED 상태에 들어간 합계 회수

getWaitedTime

public long getWaitedTime()

thread 컨텐션 감시가 유효하게 되고 나서, 이 ThreadInfo에 관련된 thread가 통지를 대기한 대략의 누적 경과시간 (밀리 세컨드 단위)을 리턴합니다. 즉, 이 시간은 thread 컨텐션 감시가 유효하게 되고 나서, thread가 WAITING 또는 TIMED_WAITING 상태인 합계의 누적 시간입니다. thread 컨텐션 감시가 무효의 경우, 이 thread는 -1을 리턴합니다.

Java 가상 머신은 고정밀도 타이머를 사용해 파악 할 수 있습니다. 이 통계 정보는 thread 컨텐션 감시가 다시 유효하게 되면 리셋 됩니다.

반환값:: thread가 WAITING 또는 TIMED_WAITING 상태인 대략의 누적 경과시간 (밀리 세컨드 단위). thread 컨텐션 감시가 무효의 경우는 -1
예외:: UnsupportedOperationException - Java 가상 머신이 이 조작을 지원 하고 있지 않는 경우
관련 항목:: ThreadMXBean.isThreadContentionMonitoringSupported(), ThreadMXBean.setThreadContentionMonitoringEnabled(boolean)

getWaitedCount

public long getWaitedCount()

이 ThreadInfo에 관련된 thread가 통지를 대기한 합계 회수를 리턴합니다. 즉, thread가 WAITING 또는 TIMED_WAITING 상태에 있던 합계 회수입니다.

반환값:: thread가 WAITING 또는 TIMED_WAITING 상태인 합계 회수

getLockName

public String  getLockName()

이 ThreadInfo에 관련된 thread가 모니터에 들어가는 것을 블록 된, 또는 Object.wait 메서드에 의해 통지되는 것을 대기하고 있는 모니터 락의 캐릭터 라인 표현. 리턴된 모니터 락의 캐릭터 라인 표현은 객체가 인스턴스가 되는 클래스의 이름, @ 부호 (@) 및 객체의 「식별」해시 코드의 부호 없음 16 진표현으로부터 구성됩니다. 리턴된 캐릭터 라인은, System.identityHashCode(java.lang.Object) 메서드의 구현에 응해 일의가 아닐 가능성이 있습니다. 이 메서드는 아래의 값에 동일한 캐릭터 라인을 리턴합니다.


 lock.getClass(). getName() + '@' + Integer.toHexString(System.identityHashCode(lock))

여기서, lock는 모니터 락 객체입니다.

thread가 모니터 객체상에서 모니터에 들어가는 것을 블록 하고 있지 않는 경우, 또는 Object.wait 호출로 통지의 모니터 객체를 대기하고 있지 않는 경우, 이 메서드는 null을 리턴합니다.

반환값:: thread가 모니터에 들어가는 것을 블록 하고 있다, 또는 Object.wait 메서드를 통해서 통지를 대기하고 있는 모니터 락의 캐릭터 라인 표현. 그렇지 않은 경우는 null

getLockOwnerId

public long getLockOwnerId()

이 ThreadInfo에 관련된 thread가 블록 하고 있는 객체의 모니터 락을 보관 유지하고 있는 thread의 ID를 리턴합니다. 이 thread가 모니터를 블록되어 있지 않은지, 대기하고 있지 않는 경우, 또는 thread가 모니터 락을 보관 유지하고 있지 않는 경우, 이 메서드는 -1을 리턴합니다.

반환값:: 이 thread가 블록 하고 있는 객체의 모니터 락의 소유자 thread의 thread ID. 이 thread가 모니터를 블록되어 있지 않은지, 대기하고 있지 않는 경우, 또는 thread가 모니터 락을 보관 유지하고 있지 않는 경우는 -1
관련 항목:: getLockName()

getLockOwnerName

public String  getLockOwnerName()

이 ThreadInfo에 관련된 thread가 블록 하고 있는 객체의 모니터 락을 보관 유지하고 있는 thread의 이름을 리턴합니다. 이 thread가 모니터를 블록되어 있지 않은지, 대기하고 있지 않는 경우, 또는 thread가 모니터 락을 보관 유지하고 있지 않는 경우, 이 메서드는 null을 리턴합니다.

반환값:: 이 thread가 블록 하고 있는 객체의 모니터 락을 보관 유지하고 있는 thread의 이름. 이 thread가 모니터를 블록되어 있지 않은지, 대기하고 있지 않는 경우, 또는 thread가 모니터 락을 보관 유지하고 있지 않는 경우는 null
관련 항목:: getLockName()

getStackTrace

public StackTraceElement [] getStackTrace()

이 ThreadInfo에 관련된 thread의 스택 트레이스를 리턴합니다. 이 thread 정보에 대해 스택 트레이스가 요구되지 않았던 경우, 이 메서드는 길이 제로의 배열을 리턴합니다. 리턴된 배열이 제로 이외의 길이의 배열인 경우, 배열의 최초의 요소는 스택의 최상부를 나타냅니다. 이것은 순서로 불려 간 가장 새로운 메서드입니다. 배열의 마지막 요소는 스택의 저부를 나타냅니다. 이것은 순서로 불려 간 가장 낡은 메서드입니다.

Java 가상 머신안에는 특정의 상황하로 스택 트레이스로부터 1개 이상의 스택 프레임을 생략 하는 것이 있습니다. 극단적인 경우, 이 ThreadInfo에 관련된 thread의 스택 트레이스 정보를 보관 유지하지 않는 가상 머신이, 이 메서드로부터 길이 제로의 배열을 돌려주는 것이 허가됩니다.

반환값:: thread의 StackTraceElement 객체의 배열

isSuspended

public boolean isSuspended()

이 ThreadInfo에 관련된 thread가 중단되고 있는지를 테스트합니다. Thread.suspend() 가 불려가 고 있었을 경우, 이 메서드는 true를 리턴합니다.

반환값:: 이 thread가 중단되고 있는 경우는 true, 그렇지 않은 경우는 false

isInNative

public boolean isInNative()

이 ThreadInfo에 관련된 thread가 JNI (Java Native Interface)를 사용해 native code를 실행하고 있을지 어떨지를 테스트합니다. JNI native code는 가상 머신 지원 코드나 가상 머신에 의해 생성된 컴파일이 끝난 native code를 포함하지 않습니다.

반환값:: thread가 native code를 실행하고 있는 경우는 true, 그렇지 않은 경우는 false

toString

public String  toString()

이 thread 정보의 캐릭터 라인 표현을 리턴합니다.

오버라이드(override):: 클래스 Object 내의 toString

반환값:: 이 thread 정보의 캐릭터 라인 표현

from

public static ThreadInfo  from(CompositeData  cd)

지정된 CompositeData에 의해 나타내지는 ThreadInfo 객체를 리턴합니다. 지정된 CompositeData는 다음의 속성을 포함할 필요가 있습니다.

속성명 형

threadId java.lang.Long

threadName java.lang.String

threadState java.lang.String

suspended java.lang.Boolean

inNative java.lang.Boolean

blockedCount java.lang.Long

blockedTime java.lang.Long

waitedCount java.lang.Long

waitedTime java.lang.Long

lockName java.lang.String

lockOwnerId java.lang.Long

lockOwnerName java.lang.String

stackTrace javax.management.openmbean.CompositeData[]
각 요소는 아래의 속성을 포함한 StackTraceElement를 나타내는 CompositeData

속성명 형

className java.lang.String

methodName java.lang.String

fileName java.lang.String

lineNumber java.lang.Integer

nativeMethod java.lang.Boolean

파라미터:: cd - ThreadInfo를 나타내는 CompositeData
반환값:: cd가 null가 아닌 경우는 cd에 의해 나타내지는 ThreadInfo 객체. 그렇지 않은 경우는 null
예외:: IllegalArgumentException - cd가 상기의 속성을 가지는 ThreadInfo를 나타내지 않는 경우

개요