1 |
jsr166 |
1.1 |
/* |
2 |
|
|
* Written by Doug Lea with assistance from members of JCP JSR-166 |
3 |
|
|
* Expert Group and released to the public domain, as explained at |
4 |
|
|
* http://creativecommons.org/publicdomain/zero/1.0/ |
5 |
|
|
*/ |
6 |
|
|
|
7 |
|
|
package java.util.concurrent; |
8 |
|
|
|
9 |
|
|
/** |
10 |
|
|
* An object that creates new threads on demand. Using thread factories |
11 |
|
|
* removes hardwiring of calls to {@link Thread#Thread(Runnable) new Thread}, |
12 |
|
|
* enabling applications to use special thread subclasses, priorities, etc. |
13 |
|
|
* |
14 |
|
|
* <p> |
15 |
|
|
* The simplest implementation of this interface is just: |
16 |
|
|
* <pre> {@code |
17 |
|
|
* class SimpleThreadFactory implements ThreadFactory { |
18 |
|
|
* public Thread newThread(Runnable r) { |
19 |
|
|
* return new Thread(r); |
20 |
|
|
* } |
21 |
|
|
* }}</pre> |
22 |
|
|
* |
23 |
|
|
* The {@link Executors#defaultThreadFactory} method provides a more |
24 |
|
|
* useful simple implementation, that sets the created thread context |
25 |
|
|
* to known values before returning it. |
26 |
|
|
* @since 1.5 |
27 |
|
|
* @author Doug Lea |
28 |
|
|
*/ |
29 |
|
|
public interface ThreadFactory { |
30 |
|
|
|
31 |
|
|
/** |
32 |
|
|
* Constructs a new {@code Thread}. Implementations may also initialize |
33 |
|
|
* priority, name, daemon status, {@code ThreadGroup}, etc. |
34 |
|
|
* |
35 |
|
|
* @param r a runnable to be executed by new thread instance |
36 |
|
|
* @return constructed thread, or {@code null} if the request to |
37 |
|
|
* create a thread is rejected |
38 |
|
|
*/ |
39 |
|
|
Thread newThread(Runnable r); |
40 |
|
|
} |