java.util.concurrent
인터페이스 ScheduledExecutorService

모든 슈퍼 인터페이스:

Executor, ExecutorService

알려진 구현 클래스 목록:

ScheduledThreadPoolExecutor

public interface ScheduledExecutorService
extends ExecutorService 

지정된 지연 시간 후, 또는 주기적으로 커멘드의 실행을 스케줄 가능한 ExecutorService .

schedule 메서드는 다양한 지연을 가지는 태스크를 작성해, 실행의 취소나 체크에 사용 가능한 태스크 객체를 리턴합니다. scheduleAtFixedRate 및 scheduleWithFixedDelay 메서드는 삭제될 때까지 주기적으로 실행되는 태스크를 작성 및 실행합니다.

Executor.execute(java.lang.Runnable) 및 ExecutorService submit 메서드를 사용해 송신되는 커멘드는 요구된 지연 제로로 스케줄링 됩니다. 값이 제로 및 부의 지연 (피리어드는 없음)도 schedule 메서드로 허가 및 처리되어 즉시 실행됩니다.

모든 schedule 메서드는 인수로서 절대 시간이나 날짜와 시간가 아니고 「상대적인」지연 및 기간을 받아들입니다. Date 로 나타내지는 절대 시간이 요구된 형식으로 변환하는 것은 간단합니다. 예를 들어 장래의 특정의 date에 스케줄을 설정하는 경우는 schedule(task, date.getTime() - System.currentTimeMillis(), TimeUnit.MILLISECONDS)를 사용할 수 있습니다. 다만, 상대 지연의 유효기간이 현재의 Date (이 시점에서 네트워크 시각 동기 프로토콜, 클락 어긋나 또는 다른 요인을 위해서 태스크가 유효하게 된다)에 일치할 필요는 없는 것에 유의해 주세요. Executors 클래스는 이 패키지로 제공되는 ScheduledExecutorService 구현용의 편리성의 높은 팩토리 메서드를 제공합니다.

사용예

다음에 나타내는 클래스에는 1 시간 beep음을 10 초 마다 울리도록 ScheduledExecutorService를 설정하는 메서드가 포함됩니다.

 import static java.util.concurrent.TimeUnit. *;
 class BeeperControl {
    private final ScheduledExecutorService scheduler = 
       Executors.newScheduledThreadPool(1);

    public void beepForAnHour() {
        final Runnable beeper = new Runnable() {
                public void run() { System.out.println("beep"); }
            };
        final ScheduledFuture<? > beeperHandle = 
            scheduler.scheduleAtFixedRate(beeper, 10, 10, SECONDS);
        scheduler.schedule(new Runnable() {
                public void run() { beeperHandle.cancel(true); }
            }, 60 * 60, SECONDS);
    }
 }
 

도입된 버전 :

1.5

메서드 개요

<V> ScheduledFuture <V>	schedule (Callable <V> callable, long delay, TimeUnit unit) 지정된 지연 후에 유효하게 되는 ScheduledFuture를 작성 및 실행합니다.
ScheduledFuture <? >	schedule (Runnable command, long delay, TimeUnit unit) 지정된 지연 후에 유효하게 되는 단발적인 액션을 작성 및 실행합니다.
ScheduledFuture <? >	scheduleAtFixedRate (Runnable command, long initialDelay, long period, TimeUnit unit) 지정된 초기 지연 후에 최초로 유효하게 되어, 그 뒤로는 지정된 기간 후에 유효하게 되는 주기적인 액션을 작성 및 실행합니다.
ScheduledFuture <? >	scheduleWithFixedDelay (Runnable command, long initialDelay, long delay, TimeUnit unit) 지정된 초기 지연 후에 최초로 유효하게 되어, 그 뒤로는 실행 종료로부터 다음의 실행 개시까지의 지정 지연 후에 유효하게 되는 주기적인 액션을 작성 및 실행합니다.

인터페이스 java.util.concurrent. ExecutorService 로부터 상속된 메서드

awaitTermination, invokeAll, invokeAll, invokeAny, invokeAny, isShutdown, isTerminated, shutdown, shutdownNow, submit, submit, submit

인터페이스 java.util.concurrent. Executor 로부터 상속된 메서드

execute

메서드의 상세

schedule

ScheduledFuture <? > schedule(Runnable  command,
                            long delay,
                            TimeUnit  unit)

지정된 지연 후에 유효하게 되는 단발적인 액션을 작성 및 실행합니다.

파라미터:

command - 실행하는 태스크

delay - 현재부터의 실행 지연 시간

unit - 지연 파라미터의 시간 단위

반환값:

보류 상태의 태스크 완료를 나타내는 Future. 그 get() 메서드는 완료시에 null을 돌려준다

예외:

RejectedExecutionException - 태스크의 실행을 스케줄 할 수 없는 경우

NullPointerException - 커멘드가 null인 경우

schedule

<V> ScheduledFuture <V> schedule(Callable <V> callable,
                                long delay,
                                TimeUnit  unit)

지정된 지연 후에 유효하게 되는 ScheduledFuture를 작성 및 실행합니다.

파라미터:

callable - 실행하는 함수

delay - 현재부터의 실행 지연 시간

unit - 지연 파라미터의 시간 단위

반환값:

결과의 추출 또는 취소해에 사용 가능한 ScheduledFuture

예외:

RejectedExecutionException - 태스크의 실행을 스케줄 할 수 없는 경우

NullPointerException - callable가 null인 경우

scheduleAtFixedRate

ScheduledFuture <? > scheduleAtFixedRate(Runnable  command,
                                       long initialDelay,
                                       long period,
                                       TimeUnit  unit)

지정된 초기 지연 후에 최초로 유효하게 되어, 그 뒤로는 지정된 기간 후에 유효하게 되는 주기적인 액션을 작성 및 실행합니다. 즉, initialDelay 후에 실행이 시작되어 initialDelay+period 후, initialDelay + 2 * period 후, 라고 하는 상태에 실행되어 갑니다. 몇개의 태스크 실행이 예외에 조우하면, 후속의 실행은 억제됩니다. 그 이외로 태스크가 종료하는 것은 executor가 삭제되는지 종료하는 경우만입니다.

파라미터:

command - 실행하는 태스크

initialDelay - 최초의 실행의 지연 시간

period - 후속의 실행 간격

unit - initialDelay 및 period 파라미터의 시간 단위

반환값:

태스크의 보류 완료를 나타내는 Future. 그 get() 메서드는 취소시에 예외를 Throw 한다

예외:

RejectedExecutionException - 태스크의 실행을 스케줄 할 수 없는 경우

NullPointerException - 커멘드가 null인 경우

IllegalArgumentException - 기간이 제로 아래의 경우

scheduleWithFixedDelay

ScheduledFuture <? > scheduleWithFixedDelay(Runnable  command,
                                          long initialDelay,
                                          long delay,
                                          TimeUnit  unit)

지정된 초기 지연 후에 최초로 유효하게 되어, 그 뒤로는 실행 종료로부터 다음의 실행 개시까지의 지정 지연 후에 유효하게 되는 주기적인 액션을 작성 및 실행합니다. 몇개의 태스크 실행이 예외에 조우하면, 후속의 실행은 억제됩니다. 그 이외로 태스크가 종료하는 것은 executor가 삭제되는지 종료하는 경우만입니다.

파라미터:

command - 실행하는 태스크

initialDelay - 최초의 실행의 지연 시간

delay - 실행 종료로부터 다음의 실행 개시까지의 지연

unit - initialDelay 및 delay 파라미터의 시간 단위

반환값:

태스크의 보류 완료를 나타내는 Future. 그 get() 메서드는 취소시에 예외를 Throw 한다

예외:

RejectedExecutionException - 태스크의 실행을 스케줄 할 수 없는 경우

NullPointerException - 커멘드가 null인 경우

IllegalArgumentException - 지연이 제로 아래의 경우