util/concurrent/ThreadFactory.java

/*
 * Written by Doug Lea with assistance from members of JCP JSR-166
 * Expert Group and released to the public domain. Use, modify, and
 * redistribute this code in any way without acknowledgement.
 */

package java.util.concurrent;

/**
 * An object that creates new threads on demand.  Using thread factories
 * removes hardwiring of calls to {@link Thread#Thread(Runnable) new Thread},
 * enabling applications to use special thread subclasses, priorities, etc.
 *
 * @since 1.5
 * @author Doug Lea
 */
public interface ThreadFactory { 

    /**
     * Constructs a new <tt>Thread</tt>.  Implementations may also initialize
     * priority, name, daemon status, <tt>ThreadGroup</tt>, etc.
     *
     * @param r a runnable to be executed by new thread instance
     * @return constructed thread
     */
    Thread newThread(Runnable r);
}
Revision:	1.4
Committed:	Sun Aug 31 13:33:14 2003 UTC (20 years, 9 months ago) by dl
Branch:	MAIN
CVS Tags:	JSR166_NOV3_FREEZE, JSR166_DEC9_PRE_ES_SUBMIT, JSR166_DEC9_POST_ES_SUBMIT
Changes since 1.3:	+0 -4 lines
Log Message:	Removed non-standard tags and misc javadoc cleanup
#	Content
1	/*
2	* Written by Doug Lea with assistance from members of JCP JSR-166
3	* Expert Group and released to the public domain. Use, modify, and
4	* redistribute this code in any way without acknowledgement.
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	* @since 1.5
15	* @author Doug Lea
16	*/
17	public interface ThreadFactory {
18
19	/**
20	* Constructs a new <tt>Thread</tt>. Implementations may also initialize
21	* priority, name, daemon status, <tt>ThreadGroup</tt>, etc.
22	*
23	* @param r a runnable to be executed by new thread instance
24	* @return constructed thread
25	*/
26	Thread newThread(Runnable r);
27	}