|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
V
- 此 Future 的 get 方法所返回的结果类型public interface Future<V>
Future 表示异步计算的结果。它提供了检查计算是否完成的方法,以等待计算的完成,并获取计算的结果。计算完成后只能使用 get 方法来获取结果,如有必要,计算完成前可以阻塞此方法。取消则由 cancel 方法来执行。还提供了其他方法,以确定任务是正常完成还是被取消了。一旦计算完成,就不能再取消计算。如果为了可取消性而使用 Future 但又不提供可用的结果,则可以声明 Future<?> 形式类型、并返回 null 作为底层任务的结果。
用法示例(注意,下列各类都是构造好的。)
interface ArchiveSearcher { String search(String target); } class App { ExecutorService executor = ... ArchiveSearcher searcher = ... void showSearch(final String target) throws InterruptedException { Future<String> future = executor.submit(new Callable<String>() { public String call() { return searcher.search(target); }}); displayOtherThings(); // do other things while searching try { displayText(future.get()); // use future } catch (ExecutionException ex) { cleanup(); return; } } }
FutureTask
类是 Future 的一个实现,Future 可实现 Runnable,所以可通过 Executor 来执行。例如,可用下列内容替换上面带有 submit 的构造:
FutureTask<String> future = new FutureTask<String>(new Callable<String>() { public String call() { return searcher.search(target); }}); executor.execute(future);内存一致性效果:异步计算采取的操作 happen-before 另一线程中紧跟在相应的
Future.get()
之后的操作。
FutureTask
,
Executor
方法摘要 | |
---|---|
boolean |
cancel(boolean mayInterruptIfRunning)
试图取消对此任务的执行。 |
V |
get()
如有必要,等待计算完成,然后获取其结果。 |
V |
get(long timeout,
TimeUnit unit)
如有必要,最多等待为使计算完成所给定的时间之后,获取其结果(如果结果可用)。 |
boolean |
isCancelled()
如果在任务正常完成前将其取消,则返回 true。 |
boolean |
isDone()
如果任务已完成,则返回 true。 |
方法详细信息 |
---|
boolean cancel(boolean mayInterruptIfRunning)
此方法返回后,对 isDone()
的后续调用将始终返回 true。如果此方法返回 true,则对 isCancelled()
的后续调用将始终返回 true。
mayInterruptIfRunning
- 如果应该中断执行此任务的线程,则为 true;否则允许正在运行的任务运行完成
boolean isCancelled()
boolean isDone()
V get() throws InterruptedException, ExecutionException
CancellationException
- 如果计算被取消
ExecutionException
- 如果计算抛出异常
InterruptedException
- 如果当前的线程在等待时被中断V get(long timeout, TimeUnit unit) throws InterruptedException, ExecutionException, TimeoutException
timeout
- 等待的最大时间unit
- timeout 参数的时间单位
CancellationException
- 如果计算被取消
ExecutionException
- 如果计算抛出异常
InterruptedException
- 如果当前的线程在等待时被中断
TimeoutException
- 如果等待超时
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。