Thread.State (Java Platform SE 8 ) (original) (raw)

• java.lang.Object

• • java.lang.Enum<Thread.State>
  • • java.lang.Thread.State

• All Implemented Interfaces:
  Serializable, Comparable<Thread.State>
  Enclosing class:
  Thread

public static enum Thread.State
extends Enum<Thread.State>
A thread state. A thread can be in one of the following states:

• NEW
  A thread that has not yet started is in this state.

• RUNNABLE
  A thread executing in the Java virtual machine is in this state.

• BLOCKED
  A thread that is blocked waiting for a monitor lock is in this state.

• WAITING
  A thread that is waiting indefinitely for another thread to perform a particular action is in this state.

• TIMED_WAITING
  A thread that is waiting for another thread to perform an action for up to a specified waiting time is in this state.

• TERMINATED
  A thread that has exited is in this state.
  A thread can be in only one state at a given point in time. These states are virtual machine states which do not reflect any operating system thread states.
  Since:
  1.5
  See Also:
  Thread.getState()

• • Enum Constant Summary

  Enum Constants

  Enum Constant	Description
  BLOCKED	Thread state for a thread blocked waiting for a monitor lock.
  NEW	Thread state for a thread which has not yet started.
  RUNNABLE	Thread state for a runnable thread.
  TERMINATED	Thread state for a terminated thread.
  TIMED_WAITING	Thread state for a waiting thread with a specified waiting time.
  WAITING	Thread state for a waiting thread.

  • Method Summary

  All Methods Static Methods Concrete Methods

  Modifier and Type	Method	Description
  static Thread.State	valueOf(String name)	Returns the enum constant of this type with the specified name.
  static Thread.State[]	values()	Returns an array containing the constants of this enum type, in the order they are declared.

     * ### Methods inherited from class java.lang.[Enum](../../java/lang/Enum.html "class in java.lang")  
     `[clone](../../java/lang/Enum.html#clone--), [compareTo](../../java/lang/Enum.html#compareTo-E-), [equals](../../java/lang/Enum.html#equals-java.lang.Object-), [finalize](../../java/lang/Enum.html#finalize--), [getDeclaringClass](../../java/lang/Enum.html#getDeclaringClass--), [hashCode](../../java/lang/Enum.html#hashCode--), [name](../../java/lang/Enum.html#name--), [ordinal](../../java/lang/Enum.html#ordinal--), [toString](../../java/lang/Enum.html#toString--), [valueOf](../../java/lang/Enum.html#valueOf-java.lang.Class-java.lang.String-)`  
     * ### Methods inherited from class java.lang.[Object](../../java/lang/Object.html "class in java.lang")  
     `[getClass](../../java/lang/Object.html#getClass--), [notify](../../java/lang/Object.html#notify--), [notifyAll](../../java/lang/Object.html#notifyAll--), [wait](../../java/lang/Object.html#wait--), [wait](../../java/lang/Object.html#wait-long-), [wait](../../java/lang/Object.html#wait-long-int-)`

• • Enum Constant Detail

     * #### NEW  
     public static final [Thread.State](../../java/lang/Thread.State.html "enum in java.lang") NEW  
     Thread state for a thread which has not yet started.  
     * #### RUNNABLE  
     public static final [Thread.State](../../java/lang/Thread.State.html "enum in java.lang") RUNNABLE  
     Thread state for a runnable thread. A thread in the runnable state is executing in the Java virtual machine but it may be waiting for other resources from the operating system such as processor.  
     * #### BLOCKED  
     public static final [Thread.State](../../java/lang/Thread.State.html "enum in java.lang") BLOCKED  
     Thread state for a thread blocked waiting for a monitor lock. A thread in the blocked state is waiting for a monitor lock to enter a synchronized block/method or reenter a synchronized block/method after calling[Object.wait](../../java/lang/Object.html#wait--).  
     * #### WAITING  
     public static final [Thread.State](../../java/lang/Thread.State.html "enum in java.lang") WAITING  
     Thread state for a waiting thread. A thread is in the waiting state due to calling one of the following methods:  
              * [Object.wait](../../java/lang/Object.html#wait--) with no timeout  
              * [Thread.join](../../java/lang/Thread.html#join--) with no timeout  
              * [LockSupport.park](../../java/util/concurrent/locks/LockSupport.html#park--)  
     A thread in the waiting state is waiting for another thread to perform a particular action. For example, a thread that has called Object.wait() on an object is waiting for another thread to callObject.notify() or Object.notifyAll() on that object. A thread that has called Thread.join() is waiting for a specified thread to terminate.  
     * #### TIMED\_WAITING  
     public static final [Thread.State](../../java/lang/Thread.State.html "enum in java.lang") TIMED_WAITING  
     * #### TERMINATED  
     public static final [Thread.State](../../java/lang/Thread.State.html "enum in java.lang") TERMINATED  
     Thread state for a terminated thread. The thread has completed execution.  

  • Method Detail

    * #### values  
    public static [Thread.State](../../java/lang/Thread.State.html "enum in java.lang")[] values()  
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:  
    for (Thread.State c : Thread.State.values())  
        System.out.println(c);  
    Returns:  
    an array containing the constants of this enum type, in the order they are declared  
    * #### valueOf  
    public static [Thread.State](../../java/lang/Thread.State.html "enum in java.lang") valueOf([String](../../java/lang/String.html "class in java.lang") name)  
    Returns the enum constant of this type with the specified name. The string must match _exactly_ an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)  
    Parameters:  
    `name` \- the name of the enum constant to be returned.  
    Returns:  
    the enum constant with the specified name  
    Throws:  
    `[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang")` \- if this enum type has no constant with the specified name  
    `[NullPointerException](../../java/lang/NullPointerException.html "class in java.lang")` \- if the argument is null

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.