java.util.concurrent
클래스 FutureTask<V>

java.lang.Object 
  java.util.concurrent.FutureTask<V>

형태 파라미터:

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

모든 구현된 인터페이스:

Runnable, Future <V>

public class FutureTask<V>
extends Object 
implements Future <V>, Runnable 

취소해 가능한 비동기 계산. 이 클래스는 계산의 개시 및 취소해, 계산의 완료의 조회 및 계산 결과의 취득을 실시하는 메서드를 포함한 Future 기본 구현을 제공합니다. 결과는 계산의 완료시에게만 취득할 수 있습니다. 계산이 완료하고 있지 않는 경우, get 메서드에 의해 블록이 실행됩니다. 일단 계산이 완료하면, 계산을 재개시 하거나 취소하거나 할 수 없습니다.

FutureTask를 사용해, Callable 나 Runnable 객체를 랩 할 수 있습니다. FutureTask는 Runnable를 구현하기 위해, FutureTask를 Executor에 송신해 실행할 수 있습니다.

이 클래스는 스탠드얼론의 클래스로서 동작하는 것에 더해커스터마이즈 된 태스크 클래스의 작성시에 도움이 되는 protected 기능을 제공합니다.

도입된 버전 :

1.5

생성자 개요

FutureTask (Callable <V > callable)
실행시로 지정된 Callable를 실행하는 FutureTask를 작성합니다.

FutureTask (Runnable runnable, V result)
실행시로 지정된 Runnable를 실행해, 정상적으로 완료했을 경우에 get가 지정된 결과를 돌려주도록 결정하는 FutureTask를 작성합니다.

메서드 개요

boolean	cancel (boolean mayInterruptIfRunning) 이 태스크의 실행의 취소를 시도합니다.
protected void	done () 이 태스크가 (보통 의 방법 또는 취소해에 해) isDone 상태로 이행할 때에 호출되는 Protected 메서드.
V	get () 필요에 따라서 계산이 완료할 때까지 대기해, 그 후, 결과를 취득합니다.
V	get (long timeout, TimeUnit unit) 필요에 따라서, 계산이 완료하는 것을 지정된 시간까지 대기합니다.
boolean	isCancelled () 이 태스크가 보통 대로 완료하기 전에 삭제되었을 경우는 true를 리턴합니다.
boolean	isDone () 이 태스크가 완료했을 경우는 true를 리턴합니다.
void	run () 삭제되었으므로 없는 한, 이 Future를 계산 결과로 설정합니다.
protected boolean	runAndReset () 결과를 설정하지 않고 계산을 실행해, 이 Future를 초기 상태에 리셋 합니다.
protected void	set (V v) 이 future가 설정 또는 취소해가 끝난 상태가 아닌 한, 이 Future 결과가 지정된 값으로 설정합니다.
protected void	setException (Throwable t) 이 Future가 설정 또는 취소해가 끝난 상태가 아닌 한, 지정된 throwable를 원인으로 하는 ExecutionException을 future가 리포트하도록 합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

FutureTask

public FutureTask(Callable <V > callable)

실행시로 지정된 Callable를 실행하는 FutureTask를 작성합니다.

파라미터:

callable - 호출해 가능한 태스크

예외:

NullPointerException - callable가 null인 경우

FutureTask

public FutureTask(Runnable  runnable,
                  V  result)

실행시로 지정된 Runnable를 실행해, 정상적으로 완료했을 경우에 get가 지정된 결과를 돌려주도록 결정하는 FutureTask를 작성합니다.

파라미터:

runnable - 실행 가능한 태스크

result - 정상적으로 완료했을 경우에 돌려주는 결과. 특정의 결과가 필요없는 경우는 Future<? > f = new FutureTask<Object>(runnable, null) 형식의 사용을 고려한다

예외:

NullPointerException - runnable가 null인 경우

메서드의 상세

isCancelled

public boolean isCancelled()

인터페이스 Future 기술:

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

정의:

인터페이스 Future <V > 내의 isCancelled

반환값:

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

isDone

public boolean isDone()

인터페이스 Future 기술:

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

정의:

인터페이스 Future <V > 내의 isDone

반환값:

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

cancel

public boolean cancel(boolean mayInterruptIfRunning)

인터페이스 Future 기술:

이 태스크의 실행의 취소를 시도합니다. 태스크가 완료하고 있는지, 삭제되고 있는지, 다른 어떠한 이유로써 취소할 수가 없는 경우, 이 시도는 실패합니다. 실행의 취소가 성공해, cancel가 불려 갔을 때에 이 태스크가 시작되어 있지 않은 경우, 이 태스크는 결코 실행되지 않습니다. 태스크가 이미 시작하고 있는 경우, mayInterruptIfRunning 파라미터는 이 태스크를 정지하기 위해서 태스크를 실행중의 thread에 인터럽트를 실시할 필요가 있을지 어떨지를 판별합니다.

정의:

인터페이스 Future <V > 내의 cancel

파라미터:

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

반환값:

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

get

public V  get()
      throws InterruptedException,

             ExecutionException 

인터페이스 Future 기술:

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

정의:

인터페이스 Future <V > 내의 get

반환값:

계산 결과

예외:

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

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

get

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

             ExecutionException,

             TimeoutException 

인터페이스 Future 기술:

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

정의:

인터페이스 Future <V > 내의 get

파라미터:

timeout - 대기하는 최장 시간

unit - timeout 인수의 시간 단위

반환값:

계산 결과

예외:

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

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

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

done

protected void done()

이 태스크가 (보통 의 방법 또는 취소해에 해) isDone 상태로 이행할 때에 호출되는 Protected 메서드. 디폴트 구현은 아무것도 실시하지 않습니다. 서브 클래스는 이 메서드를 오버라이드(override) 해, 완료 콜백을 호출하는지, 등록 처리를 실행합니다. 이 메서드의 구현 내부 상태를 조회하는 것으로 이 태스크가 삭제되었는지 어떠했는지를 확인할 수 있습니다.

set

protected void set(V  v)

이 future가 설정 또는 취소해가 끝난 상태가 아닌 한, 이 Future 결과가 지정된 값으로 설정합니다.

파라미터:

v - 치

setException

protected void setException(Throwable  t)

이 Future가 설정 또는 취소해가 끝난 상태가 아닌 한, 지정된 throwable를 원인으로 하는 ExecutionException을 future가 리포트하도록 합니다.

파라미터:

t - 장해의 원인

run

public void run()

삭제되었으므로 없는 한, 이 Future를 계산 결과로 설정합니다.

정의:

인터페이스 Runnable 내의 run

관련 항목:

Thread.run()

runAndReset

protected boolean runAndReset()

결과를 설정하지 않고 계산을 실행해, 이 Future를 초기 상태에 리셋 합니다. 계산으로 예외가 발생할까 계산이 삭제되면, 이 처리가 실패합니다. 이것은 여러 차례의 실행이 삽입된 태스크로 사용하도록 설계되고 있습니다.

반환값:

실행 및 리셋가 성공했을 경우는 true