Interface ForkJoinPool.ForkJoinWorkerThreadFactory

Enclosing class:
ForkJoinPool
public static interface ForkJoinPool.ForkJoinWorkerThreadFactory

Factory for creating new ForkJoinWorkerThreads. A ForkJoinWorkerThreadFactory must be defined and used for ForkJoinWorkerThread subclasses that extend base functionality or initialize threads with different contexts.

Methods

Modifier and Type Method Description
ForkJoinWorkerThread newThread​(ForkJoinPool pool)

Returns a new worker thread operating in the given pool.

Methods

newThread

ForkJoinWorkerThread newThread(ForkJoinPool pool)

Returns a new worker thread operating in the given pool. Returning null or throwing an exception may result in tasks never being executed. If this method throws an exception, it is relayed to the caller of the method (for example execute) causing attempted thread creation. If this method returns null or throws an exception, it is not retried until the next attempted creation (for example another call to execute).

Parameters:
pool - the pool this thread works in
Returns:
the new worker thread, or null if the request to create a thread is rejected
Throws:
NullPointerException - if the pool is null

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/ForkJoinPool.ForkJoinWorkerThreadFactory.html