java接口源码,java.util.concurrent.Future 接口 源码

线程池相关

源码：

package java.util.concurrent;

public interface Future {

//试图取消对此任务的执行

boolean cancel(boolean mayInterruptIfRunning);

//如果在任务正常完成前将其取消，则返回 true

boolean isCancelled();

//如果任务已完成，则返回 true

boolean isDone();

//如有必要，等待计算完成，然后获取其结果

V get() throws InterruptedException, ExecutionException;

//如有必要，最多等待为使计算完成所给定的时间之后，获取其结果(如果结果可用)

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

}

接口 Future

类型参数：

V - 此 Future 的 get 方法所返回的结果类型

所有已知子接口：

所有已知实现类：

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 future = executor.submit(new Callable() {

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 future = new FutureTask(new Callable() {

public String call() {

return searcher.search(target);

}

});

executor.execute(future);

cancel

boolean cancel(boolean mayInterruptIfRunning)

试图取消对此任务的执行。如果任务已完成、或已取消，或者由于某些其他原因而无法取消，则此尝试将失败。当调用 cancel 时，如果调用成功，而此任务尚未启动，则此任务将永不运行。如果任务已经启动，则 mayInterruptIfRunning 参数确定是否应该以试图停止任务的方式来中断执行此任务的线程。

此方法返回后，对isDone()的后续调用将始终返回 true。如果此方法返回 true，则对isCancelled()的后续调用将始终返回 true。

参数：

mayInterruptIfRunning - 如果应该中断执行此任务的线程，则为 true；否则允许正在运行的任务运行完成

返回：

如果无法取消任务，则返回 false，这通常是由于它已经正常完成；否则返回 true

isCancelled

boolean isCancelled()

如果在任务正常完成前将其取消，则返回 true。

返回：

如果任务完成前将其取消，则返回 true

isDone

boolean isDone()

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

返回：

如果任务已完成，则返回 true

get

如有必要，等待计算完成，然后获取其结果。

返回：

计算的结果

抛出：

get

如有必要，最多等待为使计算完成所给定的时间之后，获取其结果(如果结果可用)。

参数：

timeout - 等待的最大时间

unit - timeout 参数的时间单位

返回：

计算的结果

抛出：