compact1, compact2, compact3

java.util.concurrent

Interface Future<V>

参数类型

V - 未来的 get方法返回的结果类型

All Known Subinterfaces:

Response <T>， RunnableFuture <V>， RunnableScheduledFuture <V>， ScheduledFuture <

所有已知实现类：

CompletableFuture ， CountedCompleter ， ForkJoinTask ， FutureTask ， RecursiveAction ， RecursiveTask ， SwingWorker

public interface Future<V>

A 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 ，实现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() Future.get() 。

从以下版本开始：

1.5

另请参见：

FutureTask ， Executor

方法摘要

Modifier and Type	Method and Description
boolean	cancel(boolean mayInterruptIfRunning) 尝试取消执行此任务。
V	get() 等待计算完成，然后检索其结果。
V	get(long timeout, TimeUnit unit) 如果需要等待最多在给定的时间计算完成，然后检索其结果（如果可用）。
boolean	isCancelled() 如果此任务在正常完成之前被取消，则返回 true 。
boolean	isDone() 返回 true如果任务已完成。

方法详细信息

cancel

boolean cancel(boolean mayInterruptIfRunning)

尝试取消执行此任务。 如果任务已经完成，已经被取消或由于某种其他原因而无法取消，则此尝试将失败。 如果成功，并且当cancel时此任务尚未启动，则此任务不应运行。 如果任务已经开始，那么mayInterruptIfRunning参数确定是否执行此任务的线程应该以试图停止任务被中断。

此方法返回后，后续调用isDone()将始终返回true 。 随后电话isCancelled()总是返回true如果此方法返回true 。

参数

mayInterruptIfRunning - true如果执行该任务的线程应该被中断; 否则，正在进行的任务被允许完成

结果

false如果任务无法取消，通常是因为它已经正常完成; true否则

isCancelled

boolean isCancelled()

如果此任务在正常完成之前被取消，则返回 true 。

结果

true如果此任务在完成之前被取消

isDone

boolean isDone()

返回true如果任务已完成。 完成可能是由于正常终止，异常或取消 - 在所有这些情况下，此方法将返回true 。

结果

true如果这个任务完成

get

V get()
throws InterruptedException,
      ExecutionException

等待计算完成，然后检索其结果。

结果

计算结果

异常

CancellationException - 如果计算被取消

ExecutionException - 如果计算引发异常

InterruptedException - 如果当前线程在等待时中断

get

V get(long timeout,
      TimeUnit unit)
throws InterruptedException,
      ExecutionException,
      TimeoutException

如果需要等待最多在给定的时间计算完成，然后检索其结果（如果可用）。

参数

timeout - 等待的最长时间

unit - 超时参数的时间单位

结果

计算结果

异常

CancellationException - 如果计算被取消

ExecutionException - 如果计算抛出异常

InterruptedException - 如果当前线程在等待时中断

TimeoutException - if the wait timed out