Класс Thread

MIN_PRIORITY

public static final int MIN_PRIORITY

См. также:

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

NORM_PRIORITY

public static final int NORM_PRIORITY

См. также:

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

MAX_PRIORITY

public static final int MAX_PRIORITY

См. также:

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

Thread

public Thread()

См. также:

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

Thread

public Thread(Runnable task)

Thread.ofPlatform().unstarted(task); 

Параметры:

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

См. также:

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

Thread

public Thread(ThreadGroup group, Runnable task)

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

Параметры:

group - группа потоков. Если null и есть менеджер безопасности, группа определяется методом SecurityManager.getThreadGroup(). Если менеджера безопасности нет или SecurityManager.getThreadGroup() возвращает null, группа устанавливается в текущую группу потоков.

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

Исключения:

SecurityException - если текущий поток не может создать поток в указанной группе потоков

См. также:

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

Thread

public Thread(String name)

Параметры:

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

См. также:

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

Thread

public Thread(ThreadGroup group, String name)

Параметры:

group - группа потоков. Если null и есть менеджер безопасности, группа определяется методом SecurityManager.getThreadGroup(). Если менеджера безопасности нет или SecurityManager.getThreadGroup() возвращает null, группа устанавливается в текущую группу потоков.

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

Исключения:

SecurityException - если текущий поток не может создать поток в указанной группе потоков

См. также:

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

Thread

public Thread(Runnable task, String name)

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

Параметры:

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

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

См. также:

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

Thread

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

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

Параметры:

group - группа потоков. Если null и есть менеджер безопасности, группа определяется методом SecurityManager.getThreadGroup(). Если менеджера безопасности нет или SecurityManager.getThreadGroup() возвращает null, группа устанавливается в текущую группу потоков.

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

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

Исключения:

SecurityException - если текущий поток не может создать поток в указанной группе потоков или не может переопределить методы загрузчика класса контекста.

См. также:

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

Поток

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

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

Параметры:

group - группа потоков. Если null и существует менеджер безопасности, группа определяется методом SecurityManager.getThreadGroup(). Если нет менеджера безопасности или SecurityManager.getThreadGroup() возвращает null, группа устанавливается в группу потоков текущего потока.

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

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

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

Исключения:

SecurityException - если текущий поток не может создать поток в указанной группе потоков

С тех пор:

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 и существует менеджер безопасности, группа определяется методом SecurityManager.getThreadGroup(). Если нет менеджера безопасности или SecurityManager.getThreadGroup() возвращает null, группа устанавливается в группу потоков текущего потока.

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

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

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

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

Исключения:

SecurityException - если текущий поток не может создать поток в указанной группе потоков

С тех пор:

9

См. также:

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

currentThread

public static Thread currentThread()

Возвращает:

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

yield

public static void yield()

sleep

public static void sleep(long millis) throws InterruptedException

Параметры:

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

Исключения:

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

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

sleep

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

Параметры:

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

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

Исключения:

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

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

sleep

public static void sleep(Duration duration) throws InterruptedException

Параметры:

duration - длительность сна

Исключения:

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

С тех пор:

19

onSpinWait

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 Virtual Machine может выдать процессору инструкции для более эффективного обращения с такими кодовыми шаблонами.

С тех пор как:

9

ofPlatform

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

ofVirtual

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

clone

protected Object clone() throws CloneNotSupportedException

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

clone в классе Object

Возвращает:

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

Бросает:

CloneNotSupportedException - всегда

См. также:

• Cloneable

startVirtualThread

public static Thread startVirtualThread(Runnable task)

Thread.ofVirtual().start(task); 

Параметры:

task - объект для выполнения, когда поток выполняется

Возвращает:

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

С тех пор как:

21

См. также:

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

isVirtual

public final boolean isVirtual()

Возвращает:

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

С тех пор как:

21

start

public void start()

Бросает:

IllegalThreadStateException - если поток уже запущен

run

public void run()

Определяется в:

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

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

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

stop

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

Бросает:

UnsupportedOperationException - всегда

interrupt

public void interrupt()

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

В реализации JDK Reference, прерывание потока, который не жив, всё ещё записывает запрос на прерывание и сообщит об этом через interrupted() и isInterrupted().

Бросает:

SecurityException - если текущий поток не может изменить этот поток

interrupted

public static boolean interrupted()

Возвращает:

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

См. также:

• isInterrupted()

isInterrupted

public boolean isInterrupted()

Возвращает:

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

См. также:

• interrupted()

isAlive

public final boolean isAlive()

Возвращает:

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

suspend

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

Бросает:

UnsupportedOperationException — всегда

resume

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

Бросает:

UnsupportedOperationException — всегда

setPriority

public final void setPriority(int newPriority)

Параметры:

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

Бросает:

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

SecurityException — если checkAccess() определяет, что текущий поток не может изменить этот поток

См. также:

• setPriority(int)
• ThreadGroup.getMaxPriority()

getPriority

public final int getPriority()

Возвращает:

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

См. также:

• setPriority(int)

setName

public final void setName(String name)

Примечание для реализации:

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

Параметры:

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

Бросает:

SecurityException — если текущий поток не может изменить этот поток.

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

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

См. также:

• getName()
• checkAccess()

getName

public final String getName()

Возвращает:

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

См. также:

• setName(String)

getThreadGroup

public final ThreadGroup getThreadGroup()

Возвращает:

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

activeCount

public static int activeCount()

Возвращает:

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

enumerate

public static int enumerate(Thread[] tarray)

Параметры:

tarray — массив, в который нужно поместить список потоков

Возвращает:

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

Бросает:

SecurityException — если ThreadGroup.checkAccess() определяет, что текущий поток не может получить доступ к своей группе потоков

countStackFrames

@Deprecated(since="1.2", forRemoval=true) public int countStackFrames()

Возвращает:

ничего

См. также:

• StackWalker

join

public final void join(long millis) throws InterruptedException

Примечание для реализации:

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

Параметры:

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

Бросает:

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

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

join

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 - если какой-либо поток прервал текущий поток. Статус прерывания текущего потока сбрасывается при возникновении этого исключения.

join

public final void join() throws InterruptedException

Исключения:

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

join

public final boolean join(Duration duration) throws InterruptedException

Параметры:

duration - максимальное время ожидания

Возвращает:

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

Исключения:

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

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

С:

19

dumpStack

public static void dumpStack()

setDaemon

public final void setDaemon(boolean on)

Параметры:

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

Исключения:

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

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

SecurityException - если checkAccess() определяет, что текущий поток не может изменить этот поток

isDaemon

public final boolean isDaemon()

Возвращает:

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

См. также:

• setDaemon(boolean)

checkAccess

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

Исключения:

SecurityException - если текущий поток не имеет разрешения на доступ к этому потоку.

См. также:

• SecurityManager.checkAccess(Thread)

toString

public String toString()

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

toString в классе Object

Возвращает:

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

getContextClassLoader

public ClassLoader getContextClassLoader()

Возвращает:

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

Исключения:

SecurityException - если менеджер безопасности присутствует, и загрузчик классов вызывающего не null и не идентичен или не является предком контекстного загрузчика классов, и у вызывающего нет разрешения RuntimePermission("getClassLoader")

С:

1.2

setContextClassLoader

public void setContextClassLoader(ClassLoader cl)

Параметры:

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

Исключения:

SecurityException - если текущий поток не может установить контекстный загрузчик классов

С:

1.2

holdsLock

public static boolean holdsLock(Object obj)

     assert Thread.holdsLock(obj);
 

Параметры:

obj - объект, для которого необходимо проверить владение замком

Возвращает:

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

С:

1.4

getStackTrace

public StackTraceElement[] getStackTrace()

Возвращает:

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

Исключения:

SecurityException - если менеджер безопасности существует и его метод checkPermission не разрешает получение трассировки стека потока.

С:

1.5

См. также:

• Throwable.getStackTrace()

getAllStackTraces

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

Returns:

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

Throws:

SecurityException - если существует менеджер безопасности, и его метод checkPermission не позволяет получить трассировку стека потока.

Since:

1.5

See Also:

• getStackTrace()
• Throwable.getStackTrace()

getId

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

Returns:

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

Since:

1.5

threadId

public final long threadId()

Returns:

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

Since:

19

getState

public Thread.State getState()

Returns:

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

Since:

1.5

setDefaultUncaughtExceptionHandler

public static void setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)

Parameters:

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

Throws:

SecurityException - если присутствует менеджер безопасности, и он отказывается предоставить RuntimePermission("setDefaultUncaughtExceptionHandler")

Since:

1.5

See Also:

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

getDefaultUncaughtExceptionHandler

public static Thread.UncaughtExceptionHandler getDefaultUncaughtExceptionHandler()

Returns:

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

Since:

1.5

See Also:

• setDefaultUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler)

getUncaughtExceptionHandler

public Thread.UncaughtExceptionHandler getUncaughtExceptionHandler()

Returns:

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

Since:

1.5

setUncaughtExceptionHandler

public void setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)

Parameters:

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

Throws:

SecurityException - если текущий поток не имеет права изменить этот поток.

Since:

1.5

See Also:

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