01: /*
02: * Distributed as part of c3p0 v.0.9.1.2
03: *
04: * Copyright (C) 2005 Machinery For Change, Inc.
05: *
06: * Author: Steve Waldman <swaldman@mchange.com>
07: *
08: * This library is free software; you can redistribute it and/or modify
09: * 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: package com.mchange.v2.async;
24:
25: import com.mchange.v1.util.ClosableResource;
26:
27: public interface AsynchronousRunner extends ClosableResource {
28: public void postRunnable(Runnable r);
29:
30: /**
31: * Finish with this AsynchronousRunner, and clean-up
32: * any Threads or resources it may hold.
33: *
34: * @param skip_remaining_tasks Should be regarded as
35: * a hint, not a guarantee. If true, pending,
36: * not-yet-performed tasks will be skipped,
37: * if possible.
38: * Currently executing tasks may or
39: * may not be interrupted. If false, all
40: * previously scheduled tasks will be
41: * completed prior to clean-up. The method
42: * returns immediately regardless.
43: */
44: public void close(boolean skip_remaining_tasks);
45:
46: /**
47: * Clean-up resources held by this asynchronous runner
48: * as soon as possible. Remaining tasks are skipped if possible,
49: * and any tasks executing when close() is called may
50: * or may not be interrupted. Equivalent to close( true ).
51: */
52: public void close();
53: }
|