Класс Thread

public static final int MIN_PRIORITY

См. также:

• Значения констант полей

public static final int NORM_PRIORITY

См. также:

• Значения констант полей

public static final int MAX_PRIORITY

См. также:

• Значения констант полей

public Thread()

См. также:

• Наследование при создании потоков

public Thread(Runnable task)

Thread.ofPlatform().unstarted(task); 

Параметры:

task — объект, метод run которого вызывается при запуске этого потока. Если null, метод run этого класса ничего не делает.

См. также:

• Наследование при создании потоков

public Thread(ThreadGroup group, Runnable task)

Thread.ofPlatform().group(group).unstarted(task); 

Параметры:

group — группа потоков. Если null, в качестве группы устанавливается группа потоков текущего потока.

task — объект, метод run которого вызывается при запуске этого потока. Если null, вызывается метод run этого потока.

См. также:

• Наследование при создании потоков

public Thread(String name)

Параметры:

name — имя нового потока

См. также:

• Наследование при создании потоков

public Thread(ThreadGroup group, String name)

Параметры:

group — группа потоков. Если null, в качестве группы устанавливается группа потоков текущего потока.

name — имя нового потока

См. также:

• Наследование при создании потоков

public Thread(Runnable task, String name)

Thread.ofPlatform().name(name).unstarted(task); 

Параметры:

task — объект, метод run которого вызывается при запуске этого потока. Если null, вызывается метод run этого потока.

name — имя нового потока

См. также:

• Наследование при создании потоков

public Thread(ThreadGroup group, Runnable task, String name)

Thread.ofPlatform().group(group).name(name).unstarted(task); 

Параметры:

group — группа потоков. Если null, в качестве группы устанавливается группа потоков текущего потока.

task — объект, метод run которого вызывается при запуске этого потока. Если null, вызывается метод run этого потока.

name — имя нового потока

См. также:

• Наследование при создании потоков

public Thread(ThreadGroup group, Runnable task, String name, long stackSize)

Thread.ofPlatform().group(group).name(name).stackSize(stackSize).unstarted(task); 

Параметры:

group — группа потоков. Если null, в качестве группы устанавливается группа потоков текущего потока.

task — объект, метод run которого вызывается при запуске этого потока. Если null, вызывается метод run этого потока.

name — имя нового потока

stackSize — желаемый размер стека нового потока или ноль, указывающий, что этот параметр следует игнорировать.

Начиная с:

1.4

См. также:

• Наследование при создании потоков

public Thread(ThreadGroup group, Runnable task, String name, long stackSize, boolean inheritInheritableThreadLocals)

Thread.ofPlatform()
     .group(group)
     .name(name)
     .stackSize(stackSize)
     .inheritInheritableThreadLocals(inheritInheritableThreadLocals)
     .unstarted(task); 

Параметры:

group — группа потоков. Если null, в качестве группы устанавливается группа потоков текущего потока.

task — объект, метод run которого вызывается при запуске этого потока. Если null, вызывается метод run этого потока.

name — имя нового потока

stackSize — желаемый размер стека нового потока или ноль, указывающий, что этот параметр следует игнорировать

inheritInheritableThreadLocals — если true, наследовать начальные значения переменных InheritableThreadLocal от создающего потока; в противном случае начальные значения не наследуются

Начиная с:

9

См. также:

• Наследование при создании потоков

public static Thread currentThread()

Возвращает:

текущий поток

public static void yield()

public static void sleep(long millis) throws InterruptedException

Параметры:

millis — длительность сна в миллисекундах

Выбрасывает:

IllegalArgumentException — если значение millis отрицательно

InterruptedException — если текущий поток был прерван другим потоком. При выбрасывании этого исключения статус прерывания текущего потока сбрасывается.

public static void sleep(long millis, int nanos) throws InterruptedException

Параметры:

millis — длительность сна в миллисекундах

nanos — дополнительные наносекунды сна (0-999999)

Выбрасывает:

IllegalArgumentException — если значение millis отрицательно или значение nanos не входит в диапазон 0-999999

InterruptedException — если текущий поток был прерван другим потоком. При выбрасывании этого исключения статус прерывания текущего потока сбрасывается.

public static void sleep(Duration duration) throws InterruptedException

Параметры:

duration — промежуток времени сна

Выбрасывает:

InterruptedException — если текущий поток прерван во время сна. При выбрасывании этого исключения статус прерывания текущего потока сбрасывается.

Начиная с:

19

public static void onSpinWait()

Примечание к API:

Например, рассмотрим метод класса, который выполняет цикл до тех пор, пока флаг, устанавливаемый за пределами этого метода, не получит значение. Внутри цикла активного ожидания следует поместить вызов метода onSpinWait.

    class EventHandler {
        volatile boolean eventNotificationNotReceived;
        void waitForEventAndHandleIt() {
            while ( eventNotificationNotReceived ) {
                Thread.onSpinWait();
            }
            readAndProcessEvent();
        }

        void readAndProcessEvent() {
            // Read event from some source and process it
             . . .
        }
    }

Приведенный выше код останется корректным, даже если метод onSpinWait вообще не вызывать. Однако на некоторых архитектурах виртуальная машина Java может выдавать инструкции процессору, позволяющие эффективнее обрабатывать такие шаблоны кода.

Начиная с:

9

public static Thread.Builder.OfPlatform ofPlatform()

Примечание к API:

Ниже приведены примеры использования построителя:

  // Start a daemon thread to run a task
  Thread thread = Thread.ofPlatform().daemon().start(runnable);

  // Create an unstarted thread with name "duke", its start() method
  // must be invoked to schedule it to execute.
  Thread thread = Thread.ofPlatform().name("duke").unstarted(runnable);

  // A ThreadFactory that creates daemon threads named "worker-0", "worker-1", ...
  ThreadFactory factory = Thread.ofPlatform().daemon().name("worker-", 0).factory();

Возвращает:

Построитель для создания объектов Thread или ThreadFactory.

Начиная с:

21

public static Thread.Builder.OfVirtual ofVirtual()

Примечание к API:

Ниже приведены примеры использования построителя:

  // Start a virtual thread to run a task.
  Thread thread = Thread.ofVirtual().start(runnable);

  // A ThreadFactory that creates virtual threads
  ThreadFactory factory = Thread.ofVirtual().factory();

Возвращает:

Построитель для создания объектов Thread или ThreadFactory.

Начиная с:

21

protected Object clone() throws CloneNotSupportedException

Переопределяет:

clone в классе Object

Возвращает:

клон этого экземпляра.

Выбрасывает:

CloneNotSupportedException — всегда

См. также:

• Cloneable

public static Thread startVirtualThread(Runnable task)

Thread.ofVirtual().start(task); 

Параметры:

task — объект, который нужно выполнить при запуске потока

Возвращает:

новый запущенный виртуальный поток

Начиная с:

21

См. также:

• Наследование при создании потоков

public final boolean isVirtual()

Возвращает:

true, если этот поток является виртуальным

Начиная с:

21

public void start()

Выбрасывает:

IllegalThreadStateException — если поток уже был запущен

public void run()

Определен в:

run в интерфейсе Runnable

Требования к реализации:

Реализация по умолчанию выполняет задачу Runnable, с которой был создан Thread. Если поток создан без задачи, этот метод ничего не делает.

@Deprecated(since="1.2", forRemoval=true) public final void stop()

Выбрасывает:

UnsupportedOperationException — всегда

public void interrupt()

Примечание по реализации:

В эталонной реализации JDK прерывание неактивного потока все равно фиксирует факт запроса на прерывание и сообщает о нем через методы interrupted() и isInterrupted().

public static boolean interrupted()

Возвращает:

true, если текущий поток был прерван; в противном случае — false.

См. также:

• isInterrupted()

public boolean isInterrupted()

Возвращает:

true, если этот поток был прерван; в противном случае — false.

См. также:

• interrupted()

public final boolean isAlive()

Возвращает:

true, если этот поток активен; в противном случае — false.

public final void setPriority(int newPriority)

Параметры:

newPriority — новый приоритет потока

Исключения:

IllegalArgumentException — если приоритет не входит в диапазон от MIN_PRIORITY до MAX_PRIORITY.

См. также:

• setPriority(int)
• ThreadGroup.getMaxPriority()

public final int getPriority()

Возвращает:

приоритет этого потока.

См. также:

• setPriority(int)

public final void setName(String name)

Примечание по реализации:

В эталонной реализации JDK, если этот поток является текущим и представляет собой платформенный поток, подключенный к виртуальной машине не с помощью функции AttachCurrentThread интерфейса Java Native Interface, этот метод задает имя потока операционной системы. Это может быть полезно для отладки и поиска неисправностей.

Параметры:

name — новое имя этого потока.

Внешние спецификации

• Спецификация Java Native Interface

См. также:

• getName()

public final String getName()

Возвращает:

имя этого потока.

См. также:

• setName(String)

public final ThreadGroup getThreadGroup()

Возвращает:

группу потоков этого потока или null

public static int activeCount()

Возвращает:

приблизительное количество активных платформенных потоков в группе потоков текущего потока и во всех других группах потоков, для которых группа потоков текущего потока является предком

public static int enumerate(Thread[] tarray)

Параметры:

tarray — массив, в который помещается список потоков

Возвращает:

количество потоков, помещенных в массив

public final void join(long millis) throws InterruptedException

Примечание по реализации:

Для платформенных потоков реализация использует цикл вызовов this.wait с условием this.isAlive. При завершении потока вызывается метод this.notifyAll. Рекомендуется не использовать в приложениях wait, notify или notifyAll для экземпляров Thread.

Параметры:

millis — время ожидания в миллисекундах

Исключения:

IllegalArgumentException — если значение millis отрицательное

InterruptedException — если текущий поток был прерван каким-либо потоком. При выбрасывании этого исключения статус прерывания текущего потока сбрасывается.

public final void join(long millis, int nanos) throws InterruptedException

Примечание по реализации:

Для платформенных потоков реализация использует цикл вызовов this.wait с условием this.isAlive. При завершении потока вызывается метод this.notifyAll. Рекомендуется не использовать в приложениях wait, notify или notifyAll для экземпляров Thread.

Параметры:

millis — время ожидания в миллисекундах

nanos — дополнительные наносекунды ожидания 0-999999

Исключения:

IllegalArgumentException — если значение millis отрицательное или значение nanos не входит в диапазон 0-999999

InterruptedException — если текущий поток был прерван каким-либо потоком. При выбрасывании этого исключения статус прерывания текущего потока сбрасывается.

public final void join() throws InterruptedException

Исключения:

InterruptedException — если текущий поток был прерван каким-либо потоком. При выбрасывании этого исключения статус прерывания текущего потока сбрасывается.

public final boolean join(Duration duration) throws InterruptedException

Параметры:

duration — максимальная продолжительность ожидания

Возвращает:

true, если поток завершился; false, если поток не завершился

Исключения:

InterruptedException — если текущий поток прерван во время ожидания. При выбрасывании этого исключения статус прерывания текущего потока сбрасывается.

IllegalThreadStateException — если этот поток не был запущен.

Начиная с версии:

19

public static void dumpStack()

public final void setDaemon(boolean on)

Параметры:

on — если true, помечает этот поток как поток-демон

Исключения:

IllegalArgumentException — если это виртуальный поток и on имеет значение false

IllegalThreadStateException — если этот поток активен

public final boolean isDaemon()

Возвращает:

true, если этот поток является потоком-демоном; в противном случае — false.

См. также:

• setDaemon(boolean)

@Deprecated(since="17", forRemoval=true) public final void checkAccess()

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

строковое представление этого потока.

public ClassLoader getContextClassLoader()

Возвращает:

контекстный ClassLoader этого потока или null, указывающий на системный загрузчик классов (или, если он недоступен, на загрузчик классов начальной загрузки)

Начиная с версии:

1.2

public void setContextClassLoader(ClassLoader cl)

Параметры:

cl — контекстный ClassLoader для этого Thread или null, указывающий на системный загрузчик классов (или, если он недоступен, на загрузчик классов начальной загрузки)

Начиная с версии:

1.2

public static boolean holdsLock(Object obj)

    assert Thread.holdsLock(obj);

Параметры:

obj — объект, для которого проверяется владение блокировкой

Возвращает:

true, если текущий поток удерживает блокировку монитора указанного объекта.

Начиная с версии:

1.4

public StackTraceElement[] getStackTrace()

Возвращает:

массив StackTraceElement, каждый элемент которого представляет один кадр стека.

Начиная с версии:

1.5

См. также:

• Throwable.getStackTrace()

public static Map<Thread, StackTraceElement[]> getAllStackTraces()

Возвращает:

Map, сопоставляющую Thread массиву StackTraceElement, представляющему трассировку стека соответствующего потока.

Начиная с версии:

1.5

См. также:

• getStackTrace()
• Throwable.getStackTrace()

@Deprecated(since="19") public long getId()

Возвращает:

идентификатор этого потока

Начиная с версии:

1.5

public final long threadId()

Возвращает:

идентификатор этого потока

Начиная с версии:

19

public Thread.State getState()

Возвращает:

состояние этого потока.

Начиная с версии:

1.5

public static void setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)

Параметры:

ueh — объект, используемый в качестве обработчика неперехваченных исключений по умолчанию. Если null, обработчик по умолчанию отсутствует.

Начиная с версии:

1.5

См. также:

• setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler)
• getUncaughtExceptionHandler()
• ThreadGroup.uncaughtException(Thread, Throwable)

public static Thread.UncaughtExceptionHandler getDefaultUncaughtExceptionHandler()

Возвращает:

обработчик неперехваченных исключений по умолчанию для всех потоков

Начиная с версии:

1.5

См. также:

• setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler)

public Thread.UncaughtExceptionHandler getUncaughtExceptionHandler()

Возвращает:

обработчик неперехваченных исключений для этого потока

Начиная с версии:

1.5

public void setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)

Параметры:

ueh — объект, используемый в качестве обработчика неперехваченных исключений этого потока. Если null, у потока нет явно заданного обработчика.

Начиная с версии:

1.5

См. также:

• setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler)
• ThreadGroup.uncaughtException(Thread, Throwable)