java.util.concurrent
인터페이스 Future<V>

형태 파라미터:

V - 이 Future get 메서드에 의해 리턴된 결과의 형태

알려진 서브 인터페이스 목록 :

ScheduledFuture <V>

알려진 구현 클래스 목록:

FutureTask

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 클래스는 Runnable를 구현하는 Future 구현이기 때문에 Executor에 의해 실행 가능합니다. 예를 들어, submit를 사용하는 상기의 구성은 이하로 옮겨놓을 수가 있습니다.

FutureTask<String> future =
new FutureTask<String>(new Callable<String>() {
public String call() {
return searcher.search(target);
}});
executor.execute(future);

도입된 버전 :

1.5

관련 항목:

FutureTask, Executor

메서드 개요

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 파라미터는 이 태스크를 정지하기 위해서 태스크를 실행중의 thread에 인터럽트를 실시할 필요가 있을지 어떨지를 판별합니다.

파라미터:

mayInterruptIfRunning - 이 태스크를 실행중의 thread에 인터럽트를 실시할 필요가 있는 경우는 true, 그렇지 않은 경우는 진행중의 태스크가 완료하는 것이 허가된다

반환값:

태스크는 이미 정상적으로 완료하고 있는 등의 이유로써 태스크를 취소할 수가 없는 경우는 false, 그렇지 않은 경우는 true

isCancelled

boolean isCancelled()

이 태스크가 보통 대로 완료하기 전에 삭제되었을 경우는 true를 리턴합니다.

반환값:

태스크가 완료하기 전에 삭제되었을 경우는 true

isDone

boolean isDone()

이 태스크가 완료했을 경우는 true를 리턴합니다. 완료의 원인에는 정상 종료, 예외, 또는 취소가 있습니다. 이러한 어느 경우에서도, 이 메서드는 true를 리턴합니다.

반환값:

이 태스크가 완료했을 경우는 true

get

V  get()
      throws InterruptedException,

             ExecutionException 

필요에 따라서 계산이 완료할 때까지 대기해, 그 후, 결과를 취득합니다.

반환값:

계산 결과

예외:

CancellationException - 계산이 삭제되었을 경우

ExecutionException - 계산에 의해 예외가 Throw 되었을 경우

InterruptedException - 대기중에 현재의 thread로 인터럽트가 발생했을 경우

get

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

             ExecutionException,

             TimeoutException 

필요에 따라서, 계산이 완료하는 것을 지정된 시간까지 대기합니다. 그 후, 가능하면 결과를 취득합니다.

파라미터:

timeout - 대기하는 최장 시간

unit - timeout 인수의 시간 단위

반환값:

계산 결과

예외:

CancellationException - 계산이 삭제되었을 경우

ExecutionException - 계산에 의해 예외가 Throw 되었을 경우

InterruptedException - 대기중에 현재의 thread로 인터럽트가 발생했을 경우

TimeoutException - 지정된 대기 시간이 경과했을 경우