1 /*
2 * This file is part of Domingo
3 * an Open Source Java-API to Lotus Notes/Domino
4 * hosted at http://domingo.sourceforge.net
5 *
6 * Copyright (c) 2003-2007 Beck et al. projects GmbH Munich, Germany (http://www.bea.de)
7 *
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
12 *
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
17 *
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 */
22
23 package de.bea.domingo.threadpool;
24
25 /***
26 * Interface for classes generating threads.
27 *
28 * @author <a href=mailto:kriede@users.sourceforge.net>Kurt Riede</a>
29 */
30 public interface ThreadFactory {
31
32 /***
33 * Factory method to create Thread objects.
34 *
35 * <p>The resulting object must not be of class <code>Thread</code>, but can
36 * also be of any Class derived from class <code>Thread</code>.</p>
37 *
38 * @param target the object whose run() method gets called
39 * @return a Thread
40 */
41 Thread createThread(Runnable target);
42
43 /***
44 * Initialize resources of a new thread.
45 */
46 void initThread();
47
48 /***
49 * Free resources of a new thread.
50 */
51 void termThread();
52
53 /***
54 * Callback method if an Throwable occurs during starting a thread.
55 *
56 * <p>A component that uses a thread factory (e.g. a thread pool) can call this method
57 * to notify the thread factory about problems when creating a thread.</p>
58 *
59 * @param throwable a throwable that occurred during starting a thread
60 */
61 void handleThrowable(Throwable throwable);
62 }