01: /*_############################################################################
02: _##
03: _## SNMP4J - ThreadFactory.java
04: _##
05: _## Copyright (C) 2003-2008 Frank Fock and Jochen Katz (SNMP4J.org)
06: _##
07: _## Licensed under the Apache License, Version 2.0 (the "License");
08: _## you may not use this file except in compliance with the License.
09: _## You may obtain a copy of the License at
10: _##
11: _## http://www.apache.org/licenses/LICENSE-2.0
12: _##
13: _## Unless required by applicable law or agreed to in writing, software
14: _## distributed under the License is distributed on an "AS IS" BASIS,
15: _## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16: _## See the License for the specific language governing permissions and
17: _## limitations under the License.
18: _##
19: _##########################################################################*/
20:
21: package org.snmp4j.util;
22:
23: /**
24: * The <code>ThreadFactory</code> describes a factory for threads of execution
25: * modeled as <code>WorkerTask</code>s.
26: *
27: * @author Frank Fock
28: * @version 1.9
29: * @since 1.9
30: */
31: public interface ThreadFactory {
32:
33: /**
34: * Creates a new thread of execution for the supplied task. The returned
35: * <code>WorkerTask</code> is a symetric wrapper for the supplied one.
36: * When the returned task is being run, the supplied one will be executed
37: * in a new thread of execution until it either terminates or the
38: * {@link WorkerTask#terminate()} method has been called.
39: *
40: * @param name
41: * the name of the execution thread.
42: * @param task
43: * the task to be executed in the new thread.
44: * @param daemon
45: * indicates whether the new thread is a daemon (<code>true</code> or an
46: * user thread (<code>false</code>).
47: * @return
48: * the <code>WorkerTask</code> wrapper to control start and termination of
49: * the thread.
50: */
51: WorkerTask createWorkerThread(String name, WorkerTask task,
52: boolean daemon);
53:
54: }
|