KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > mchange > v2 > async > AsynchronousRunner


1 /*
2  * Distributed as part of c3p0 v.0.9.1
3  *
4  * Copyright (C) 2005 Machinery For Change, Inc.
5  *
6  * Author: Steve Waldman <swaldman@mchange.com>
7  *
8  * This library is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU Lesser General Public License version 2.1, as
10  * published by the Free Software Foundation.
11  *
12  * This software is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  * GNU Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public License
18  * along with this software; see the file LICENSE. If not, write to the
19  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
20  * Boston, MA 02111-1307, USA.
21  */
22
23
24 package com.mchange.v2.async;
25
26 import com.mchange.v1.util.ClosableResource;
27
28 public interface AsynchronousRunner extends ClosableResource
29 {
30     public void postRunnable(Runnable JavaDoc r);
31
32
33     /**
34      * Finish with this AsynchronousRunner, and clean-up
35      * any Threads or resources it may hold.
36      *
37      * @param skip_remaining_tasks Should be regarded as
38      * a hint, not a guarantee. If true, pending,
39      * not-yet-performed tasks will be skipped,
40      * if possible.
41      * Currently executing tasks may or
42      * may not be interrupted. If false, all
43      * previously scheduled tasks will be
44      * completed prior to clean-up. The method
45      * returns immediately regardless.
46      */
47     public void close( boolean skip_remaining_tasks );
48
49     /**
50      * Clean-up resources held by this asynchronous runner
51      * as soon as possible. Remaining tasks are skipped if possible,
52      * and any tasks executing when close() is called may
53      * or may not be interrupted. Equivalent to close( true ).
54      */
55     public void close();
56 }
57
Popular Tags