JavaThreads

java.lang.Object
- com.oracle.svm.core.thread.JavaThreads

Direct Known Subclasses:

PosixJavaThreads, WindowsJavaThreads
```
public abstract class JavaThreads
extends Object
```

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

protected static interface JavaThreads.ThreadStartData

Nested Classes
Modifier and Type	Class and Description
`protected static interface`	`JavaThreads.ThreadStartData`

Field Summary

Fields
Modifier and Type	Field and Description
`protected static FastThreadLocalObject<Thread>`	`currentThread` The `Thread` for the `IsolateThread`.
`protected AtomicInteger`	`daemonThreads`
`protected AtomicInteger`	`liveThreads`
`protected AtomicInteger`	`nonDaemonThreads`
`protected AtomicInteger`	`peakThreads`
`protected AtomicLong`	`totalThreads`

Constructor Summary

Constructors
Constructor and Description

JavaThreads()

Constructors
Constructor and Description
`JavaThreads()`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`assignJavaThread(String name, ThreadGroup group, boolean asDaemon)` Create a `Thread` object for the current thread.
`boolean`	`assignJavaThread(Thread thread, boolean manuallyStarted)` Assign a `Thread` object to the current thread, which must have already been attached `VMThreads` as an `IsolateThread`.
`Thread`	`createIfNotExisting(org.graalvm.nativeimage.IsolateThread vmThread)`
`static void`	`detachThread(org.graalvm.nativeimage.IsolateThread vmThread)` Detach the provided Java thread.
`static void`	`dispatchUncaughtException(Thread thread, Throwable throwable)` If there is an uncaught exception handler, call it.
`protected abstract void`	`doStartThread(Thread thread, long stackSize)` Start a new OS thread.
`protected static void`	`exit(Thread thread)`
`Thread`	`fromVMThread(org.graalvm.nativeimage.IsolateThread vmThread)`
`static Thread`	`getCurrentThread()`
`int`	`getDaemonThreads()`
`int`	`getLiveThreads()`
`int`	`getPeakThreads()`
`protected static UninterruptibleUtils.AtomicReference<ParkEvent>`	`getSleepParkEvent(Thread thread)`
`static int`	`getThreadStatus(Thread thread)`
`long`	`getTotalThreads()`
`protected static UninterruptibleUtils.AtomicReference<ParkEvent>`	`getUnsafeParkEvent(Thread thread)`
`protected static void`	`interruptVMCondVars()`
`void`	`joinAllNonDaemons()` Joins all non-daemon threads.
`protected void`	`noteThreadFinish(Thread thread)`
`protected void`	`noteThreadStart(Thread thread)`
`protected static void`	`prepareStartData(Thread thread, JavaThreads.ThreadStartData startData)`
`protected abstract void`	`setNativeName(Thread thread, String name)` Set the OS-level name of the thread.
`static void`	`setThreadStatus(Thread thread, int threadStatus)`
`void`	`signalNonDaemonThreadStart()` Signal that a thread was started by calling Thread.start().
`static JavaThreads`	`singleton()`
`boolean`	`tearDownVM()` Tear down the VMThreads.
`protected static void`	`threadStartRoutine(org.graalvm.nativeimage.ObjectHandle threadHandle)`
`protected abstract void`	`yield()`

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

- Field Detail
  - currentThread
```
protected static final FastThreadLocalObject<Thread> currentThread
```
    The Thread for the IsolateThread. It can be null if the Thread has never been accessed. The only possible transition is from null to the Thread, after that initialization (which must use atomic operations) the value never changes again. Therefore, reads do not need to be volatile reads.
  - totalThreads
```
protected final AtomicLong totalThreads
```
  - peakThreads
```
protected final AtomicInteger peakThreads
```
  - liveThreads
```
protected final AtomicInteger liveThreads
```
  - daemonThreads
```
protected final AtomicInteger daemonThreads
```
  - nonDaemonThreads
```
protected final AtomicInteger nonDaemonThreads
```
- Constructor Detail
  - JavaThreads
```
public JavaThreads()
```
- Method Detail
  - singleton
```
public static JavaThreads singleton()
```
  - getThreadStatus
```
public static int getThreadStatus(Thread thread)
```
  - setThreadStatus
```
public static void setThreadStatus(Thread thread,
                                   int threadStatus)
```
  - getUnsafeParkEvent
```
protected static UninterruptibleUtils.AtomicReference<ParkEvent> getUnsafeParkEvent(Thread thread)
```
  - getSleepParkEvent
```
protected static UninterruptibleUtils.AtomicReference<ParkEvent> getSleepParkEvent(Thread thread)
```
  - fromVMThread
```
public Thread fromVMThread(org.graalvm.nativeimage.IsolateThread vmThread)
```
  - getCurrentThread
```
public static Thread getCurrentThread()
```
  - createIfNotExisting
```
public Thread createIfNotExisting(org.graalvm.nativeimage.IsolateThread vmThread)
```
  - getTotalThreads
```
public long getTotalThreads()
```
  - getPeakThreads
```
public int getPeakThreads()
```
  - getLiveThreads
```
public int getLiveThreads()
```
  - getDaemonThreads
```
public int getDaemonThreads()
```
  - joinAllNonDaemons
```
public void joinAllNonDaemons()
```
    Joins all non-daemon threads. If the current thread is itself a non-daemon thread, it does not attempt to join itself.
  - signalNonDaemonThreadStart
```
public void signalNonDaemonThreadStart()
```
    Signal that a thread was started by calling Thread.start().
  - assignJavaThread
```
public boolean assignJavaThread(String name,
                                ThreadGroup group,
                                boolean asDaemon)
```
    Create a Thread object for the current thread. The current thread must have already been attached VMThreads as an IsolateThread.
    
    Parameters:
    
    name - the thread's name, or null for a default name.
    
    group - the thread group, or null for the default thread group.
    
    Returns:
    
    true if successful; false if a Thread object has already been assigned.
  - assignJavaThread
```
public boolean assignJavaThread(Thread thread,
                                boolean manuallyStarted)
```
    Assign a Thread object to the current thread, which must have already been attached VMThreads as an IsolateThread. The manuallyStarted parameter is true if this thread was started directly by calling assignJavaThread(Thread). It is false when the thread is started using PosixJavaThreads.pthreadStartRoutine, e.g., called from PosixJavaThreads.start0.
    
    Returns:
    
    true if successful; false if a Thread object has already been assigned.
  - tearDownVM
```
public boolean tearDownVM()
```
    Tear down the VMThreads.
    This is called from an CEntryPoint exit action.
    Returns true if the VM has been torn down, false otherwise.
  - detachThread
```
public static void detachThread(org.graalvm.nativeimage.IsolateThread vmThread)
```
    Detach the provided Java thread. Note that the Java thread might not have been created, in which case it is null and we have nothing to do.
  - exit
```
protected static void exit(Thread thread)
```
  - prepareStartData
```
protected static void prepareStartData(Thread thread,
                                       JavaThreads.ThreadStartData startData)
```
  - doStartThread
```
protected abstract void doStartThread(Thread thread,
                                      long stackSize)
```
    Start a new OS thread. The implementation must call JavaThreads.prepareStartData(java.lang.Thread, com.oracle.svm.core.thread.JavaThreads.ThreadStartData) after preparations and before starting the thread. The new OS thread must call JavaThreads.threadStartRoutine(org.graalvm.nativeimage.ObjectHandle).
  - threadStartRoutine
```
protected static void threadStartRoutine(org.graalvm.nativeimage.ObjectHandle threadHandle)
```
  - noteThreadStart
```
protected void noteThreadStart(Thread thread)
```
  - noteThreadFinish
```
protected void noteThreadFinish(Thread thread)
```
  - setNativeName
```
protected abstract void setNativeName(Thread thread,
                                      String name)
```
    Set the OS-level name of the thread. This functionality is optional, i.e., if the OS does not support thread names the implementation can remain empty.
  - yield
```
protected abstract void yield()
```
  - interruptVMCondVars
```
protected static void interruptVMCondVars()
```
  - dispatchUncaughtException
```
public static void dispatchUncaughtException(Thread thread,
                                             Throwable throwable)
```
    If there is an uncaught exception handler, call it.

Class JavaThreads

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

currentThread

totalThreads

peakThreads

liveThreads

daemonThreads

nonDaemonThreads

Constructor Detail

JavaThreads

Method Detail

singleton

getThreadStatus

setThreadStatus

getUnsafeParkEvent

getSleepParkEvent

fromVMThread

getCurrentThread

createIfNotExisting

getTotalThreads

getPeakThreads

getLiveThreads

getDaemonThreads

joinAllNonDaemons

signalNonDaemonThreadStart

assignJavaThread

assignJavaThread

tearDownVM

detachThread

exit

prepareStartData

doStartThread

threadStartRoutine

noteThreadStart

noteThreadFinish

setNativeName

yield

interruptVMCondVars

dispatchUncaughtException