Future (Java Platform SE 8 )

参数类型

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

Interface Future<V>

方法摘要

方法详细信息

cancel

isCancelled

isDone

get

get