Spec-Zone.ru › OpenJDK 27

Класс перечисления Thread.State

java.lang.Object
java.lang.Enum<Thread.State>
java.lang.Thread.State
Все реализованные интерфейсы:
Serializable, Comparable<Thread.State>, Constable
Внешний класс:
Thread
public static enum Thread.State extends Enum<Thread.State>
Состояние потока. Поток может находиться в одном из следующих состояний:
  • NEW
    Поток, который ещё не был запущен, находится в этом состоянии.
  • RUNNABLE
    Поток, выполняющийся в виртуальной машине Java, находится в этом состоянии.
  • BLOCKED
    Поток, заблокированный в ожидании блокировки монитора, находится в этом состоянии.
  • WAITING
    Поток, бесконечно ожидающий выполнения определённого действия другим потоком, находится в этом состоянии.
  • TIMED_WAITING
    Поток, ожидающий выполнения действия другим потоком в течение заданного времени, находится в этом состоянии.
  • TERMINATED
    Завершившийся поток находится в этом состоянии.

В каждый момент времени поток может находиться только в одном состоянии. Эти состояния являются состояниями виртуальной машины и не отражают состояния потоков операционной системы.

Начиная с:
1.5
См. также:
  • Thread.getState()

Краткое описание вложенных классов

Вложенные классы и интерфейсы, объявленные в классе Enum

Enum.EnumDesc<E>
Модификатор и тип Класс Описание
static final class  Enum.EnumDesc<E extends Enum<E>>
Номинальный дескриптор константы enum.

Краткое описание констант перечисления

Константа перечисления Описание
BLOCKED
Состояние потока, заблокированного в ожидании блокировки монитора.
NEW
Состояние потока, который ещё не был запущен.
RUNNABLE
Состояние выполняемого потока.
TERMINATED
Состояние завершившегося потока.
TIMED_WAITING
Состояние ожидающего потока с заданным временем ожидания.
WAITING
Состояние ожидающего потока.

Краткое описание методов

Модификатор и тип Метод Описание
static Thread.State valueOf(String name)
Возвращает константу перечисления этого класса с указанным именем.
static Thread.State[] values()
Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

Методы, объявленные в классе Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
Модификатор и тип Метод Описание
protected final Object clone()
Выбрасывает CloneNotSupportedException.
final int compareTo(Thread.State o)
Сравнивает это перечисление с указанным объектом, определяя порядок.
final Optional<Enum.EnumDesc<Thread.State>> describeConstable()
Возвращает дескриптор перечисления EnumDesc для этого экземпляра, если его можно создать, или пустой Optional, если его создать нельзя.
final boolean equals(Object other)
Возвращает true, если указанный объект равен этой константе перечисления.
protected final void finalize()
Устарело, подлежит удалению: этот элемент API будет удалён в будущей версии.
Финализация объявлена устаревшей и подлежит удалению.
final Class<Thread.State> getDeclaringClass()
Возвращает объект Class, соответствующий типу перечисления этой константы.
final int hashCode()
Возвращает хеш-код этой константы перечисления.
final String name()
Возвращает имя этой константы перечисления в точности в том виде, в котором оно указано в объявлении перечисления.
final int ordinal()
Возвращает порядковый номер этой константы перечисления (её позицию в объявлении перечисления; начальной константе присваивается номер 0).
String toString()
Возвращает имя этой константы перечисления, указанное в объявлении.
static <T extends Enum<T>>
T
valueOf(Class<T> enumClass, String name)
Возвращает константу указанного класса перечисления с указанным именем.

Методы, объявленные в классе Object

getClass, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

Подробное описание констант перечисления

NEW

public static final Thread.State NEW
Состояние потока, который ещё не был запущен.

RUNNABLE

public static final Thread.State RUNNABLE
Состояние выполняемого потока. Поток в состоянии выполнения работает в виртуальной машине Java, но может ожидать доступа к другим ресурсам операционной системы, например к процессору.

BLOCKED

public static final Thread.State BLOCKED
Состояние потока, заблокированного в ожидании блокировки монитора. Поток в заблокированном состоянии ожидает блокировки монитора, чтобы войти в синхронизированный блок или метод либо повторно войти в синхронизированный блок или метод после вызова Object.wait.

WAITING

public static final Thread.State WAITING
Состояние ожидающего потока. Поток находится в состоянии ожидания вследствие вызова одного из следующих методов:
  • Object.wait без тайм-аута
  • Thread.join без тайм-аута
  • LockSupport.park

Поток в состоянии ожидания ждёт выполнения определённого действия другим потоком. Например, поток, вызвавший Object.wait() для объекта, ожидает, пока другой поток вызовет Object.notify() или Object.notifyAll() для этого объекта. Поток, вызвавший Thread.join(), ожидает завершения указанного потока.

TIMED_WAITING

public static final Thread.State TIMED_WAITING
Состояние ожидающего потока с заданным временем ожидания. Поток находится в состоянии ожидания с тайм-аутом вследствие вызова одного из следующих методов с указанным положительным временем ожидания:
  • Thread.sleep
  • Object.wait с тайм-аутом
  • Thread.join с тайм-аутом
  • LockSupport.parkNanos
  • LockSupport.parkUntil

TERMINATED

public static final Thread.State TERMINATED
Состояние завершившегося потока. Поток завершил выполнение.

Подробное описание методов

values

public static Thread.State[] values()
Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.
Возвращает:
массив, содержащий константы этого класса перечисления в порядке их объявления

valueOf

public static Thread.State valueOf(String name)
Возвращает константу перечисления этого класса с указанным именем. Строка должна точно совпадать с идентификатором, использованным для объявления константы перечисления в этом классе. (Пробелы в начале и конце строки не допускаются.)
Параметры:
name — имя возвращаемой константы перечисления.
Возвращает:
константу перечисления с указанным именем
Выбрасывает:
IllegalArgumentException — если в этом классе перечисления нет константы с указанным именем
NullPointerException — если аргумент равен null

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, включая концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API