Thread

java.lang.Object
- java.lang.Thread

All Implemented Interfaces:

Runnable
```
public class Thread
extends Object
implements Runnable
```
A thread of execution (or task). Now handles priorities, daemon threads and interruptions.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface Thread.UncaughtExceptionHandler

Nested Classes
Modifier and Type	Class and Description
`static interface`	`Thread.UncaughtExceptionHandler`

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`MAX_PRIORITY` The maximum priority that a thread can have.
`static int`	`MIN_PRIORITY` The minimum priority that a thread can have.
`static int`	`NORM_PRIORITY` The priority that is assigned to the primordial thread.

Constructor Summary

Constructors
Constructor and Description

Thread()

Thread(Runnable target)

Thread(Runnable target, String name)

Thread(String name)

Constructors
Constructor and Description
`Thread()`
`Thread(Runnable target)`
`Thread(Runnable target, String name)`
`Thread(String name)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static Thread`	`currentThread()`
`static Thread.UncaughtExceptionHandler`	`getDefaultUncaughtExceptionHandler()` returns the current default exception handler if set, or null if none is set.
`String`	`getName()` Returns the string name of this thread.
`int`	`getPriority()`
`Thread.UncaughtExceptionHandler`	`getUncaughtExceptionHandler()` returns the current uncaught exception handler for this thread, if one has has been set or null if none is set.
`void`	`interrupt()` Set the interrupted flag.
`static boolean`	`interrupted()` Tests the interrupted state of the current thread.
`boolean`	`isAlive()`
`boolean`	`isDaemon()` Set the daemon flag.
`boolean`	`isInterrupted()` Tests to see if the current thread has been interrupted but leaves the interrupted state unchanged.
`void`	`join()` Waits for this thread to die.
`void`	`join(long timeout)` Waits for up to timeout mS for this thread to die.
`void`	`run()` When an object implementing interface `Runnable` is used to create a thread, starting the thread causes the object's `run` method to be called in that separately executing thread.
`void`	`setDaemon(boolean on)` Sets the state of the threads daemon flag.
`static void`	`setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler handler)` Set the default exception handler.
`void`	`setName(String name)` Sets the string name associated with this thread.
`void`	`setPriority(int priority)` Set the priority of this thread.
`void`	`setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler handler)` Sets the uncaught exception handler for this thread.
`static void`	`sleep(long aMilliseconds)`
`void`	`start()`
`static void`	`yield()`

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - MAX_PRIORITY
```
public static final int MAX_PRIORITY
```
    The maximum priority that a thread can have. The value is 10.
    
    See Also:
    
    Constant Field Values
  - MIN_PRIORITY
```
public static final int MIN_PRIORITY
```
    The minimum priority that a thread can have. The value is 1.
    
    See Also:
    
    Constant Field Values
  - NORM_PRIORITY
```
public static final int NORM_PRIORITY
```
    The priority that is assigned to the primordial thread. The value is 5.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Thread
```
public Thread()
```
  - Thread
```
public Thread(Runnable target)
```
  - Thread
```
public Thread(Runnable target,
              String name)
```
  - Thread
```
public Thread(String name)
```
- Method Detail
  - currentThread
```
public static Thread currentThread()
```
  - getDefaultUncaughtExceptionHandler
```
public static Thread.UncaughtExceptionHandler getDefaultUncaughtExceptionHandler()
```
    returns the current default exception handler if set, or null if none is set.
    
    Returns:
    
    the current exception handler
  - getName
```
public String getName()
```
    Returns the string name of this thread.
    
    Returns:
    
    The name of this thread.
  - getPriority
```
public final int getPriority()
```
  - getUncaughtExceptionHandler
```
public Thread.UncaughtExceptionHandler getUncaughtExceptionHandler()
```
    returns the current uncaught exception handler for this thread, if one has has been set or null if none is set.
    
    Returns:
    
    the current handler
  - interrupt
```
public void interrupt()
```
    Set the interrupted flag. If we are asleep we will wake up and an InterruptedException will be thrown.
  - interrupted
```
public static boolean interrupted()
```
    Tests the interrupted state of the current thread. If it is interrupted it will true and clear the interrupted state. Otherwise it will return false.
    
    Returns:
    
    true if the current thread has been interrupted otherwise false
  - isAlive
```
public final boolean isAlive()
```
  - isDaemon
```
public final boolean isDaemon()
```
    Set the daemon flag. If a thread is a daemon thread its existence will not prevent a JVM from exiting.
    
    Returns:
    
    true if this thread has the daemon flag set otherwise false
  - isInterrupted
```
public final boolean isInterrupted()
```
    Tests to see if the current thread has been interrupted but leaves the interrupted state unchanged.
    
    Returns:
    
    true if the current thread has been interrupted otherwise false
  - join
```
public final void join()
                throws InterruptedException
```
    Waits for this thread to die.
    
    Throws:
    
    InterruptedException
  - join
```
public final void join(long timeout)
                throws InterruptedException
```
    Waits for up to timeout mS for this thread to die.
    
    Parameters:
    
    timeout - The period in ms to wait for this thread to die
    
    Throws:
    
    InterruptedException
  - run
```
public void run()
```
    Description copied from interface: Runnable
    
    When an object implementing interface Runnable is used to create a thread, starting the thread causes the object's run method to be called in that separately executing thread.
    
    Specified by:
    
    run in interface Runnable
  - setDaemon
```
public final void setDaemon(boolean on)
```
    Sets the state of the threads daemon flag. If this flag is set then the system will not wait for it to exit when all other none daemon threads have exited.
    
    Parameters:
    
    on - the new state of the daemon flag
  - setDefaultUncaughtExceptionHandler
```
public static void setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler handler)
```
    Set the default exception handler. This will be called for any uncaught exceptions thrown by threads which do not have an uncaught exception handler set.
    
    Parameters:
    
    handler - The new exception handler
  - setName
```
public void setName(String name)
```
    Sets the string name associated with this thread.
    
    Parameters:
    
    name - The new name of the thread.
  - setPriority
```
public final void setPriority(int priority)
```
    Set the priority of this thread. Higher number have higher priority. The scheduler will always run the highest priority thread in preference to any others. If more than one thread of that priority exists the scheduler will time-slice them. In order for lower priority threas to run a higher priority thread must cease to be runnable. i.e. it must exit, sleep or wait on a monitor. It is not sufficient to just yield.
    Threads inherit the priority of their parent. The primordial thread has priority NORM_PRIORITY.
    
    Parameters:
    
    priority - must be between MIN_PRIORITY and MAX_PRIORITY.
  - setUncaughtExceptionHandler
```
public void setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler handler)
```
    Sets the uncaught exception handler for this thread. This handler will be called for any uncaught exceptions thrown bu this thread.
    
    Parameters:
    
    handler - The new handler
  - sleep
```
public static void sleep(long aMilliseconds)
                  throws InterruptedException
```
    Throws:
    
    InterruptedException
  - start
```
public final void start()
```
  - yield
```
public static void yield()
```

Class Thread

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MAX_PRIORITY

MIN_PRIORITY

NORM_PRIORITY

Constructor Detail

Thread

Thread

Thread

Thread

Method Detail

currentThread

getDefaultUncaughtExceptionHandler

getName

getPriority

getUncaughtExceptionHandler

interrupt

interrupted

isAlive

isDaemon

isInterrupted

join

join

run

setDaemon

setDefaultUncaughtExceptionHandler

setName

setPriority

setUncaughtExceptionHandler

sleep

start

yield