Класс 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); 

Parameters:

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

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

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

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

Since:

1.4

See Also:

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

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

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

Parameters:

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

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

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

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

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

Since:

9

See Also:

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

public static Thread currentThread()

Returns:

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

public static void yield()

public static void sleep(long millis) throws InterruptedException

Parameters:

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

Throws:

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

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

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

Parameters:

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

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

Throws:

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

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

public static void sleep(Duration duration) throws InterruptedException

Parameters:

duration - интервал сна

Throws:

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

Since:

19

public static void onSpinWait()

API Note:

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

Since:

9

public static Thread.Builder.OfPlatform ofPlatform()

API Note:

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

  // 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 Note:

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

  // 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 Reference Implementation, прерывание потока, который не активен, всё ещё записывает, что запрос на прерывание был сделан, и сообщит об этом через 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, если этот поток является текущим потоком и это платформа потока, который не был присоединен к виртуальной машине с помощью функции Java Native Interface AttachCurrentThread, то этот метод установит имя потока операционной системы. Это может быть полезно для отладки и устранения неполадок.

Параметры:

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()

Overrides:

toString в классе Object

Возвращает:

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

public ClassLoader getContextClassLoader()

Возвращает:

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

Since:

1.2

public void setContextClassLoader(ClassLoader cl)

Parameters:

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

Since:

1.2

public static boolean holdsLock(Object obj)

     assert Thread.holdsLock(obj);
 

Parameters:

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

Returns:

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

Since:

1.4

public StackTraceElement[] getStackTrace()

Returns:

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

Since:

1.5

See Also:

• Throwable.getStackTrace()

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

Returns:

карта, отображающая Thread с Map на массив элементов стека вызовов, представляющий стековый след соответствующего потока.

Since:

1.5

See Also:

• getStackTrace()
• Throwable.getStackTrace()

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

Returns:

ID этого потока

Since:

1.5

public final long threadId()

Returns:

ID этого потока

Since:

19

public Thread.State getState()

Returns:

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

Since:

1.5

public static void setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)

Parameters:

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

Since:

1.5

See Also:

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

public static Thread.UncaughtExceptionHandler getDefaultUncaughtExceptionHandler()

Returns:

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

Since:

1.5

See Also:

• setDefaultUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler)

public Thread.UncaughtExceptionHandler getUncaughtExceptionHandler()

Returns:

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

Since:

1.5

public void setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)

Parameters:

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

Since:

1.5

See Also:

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