compact1, compact2, compact3

java.util.concurrent

Interface ScheduledExecutorService

All Superinterfaces:

Executor， ExecutorService

所有已知实现类：

ScheduledThreadPoolExecutor

public interface ScheduledExecutorService
extends ExecutorService

一个 ExecutorService可以调度命令后运行一个给定的延迟，或定期执行。

的schedule方法创造不同的延迟任务和返回一个对象，可以用来取消或检查执行。的scheduleAtFixedRate和scheduleWithFixedDelay方法创建和执行，定期运行直至取消任务。

命令提交使用Executor.execute(Runnable)和ExecutorService submit方法是安排一个请求的延迟为零。零和负延迟（而不是时间）也在schedule方法允许，并视为立即执行的请求。

所有的schedule方法接受相对延迟和时间作为参数，而不是绝对的时间或日期。它是将绝对时间表示为一个Date需要形成一个简单的事。例如，计划在将来的某个date，你可以使用：schedule(task, date.getTime() - System.currentTimeMillis(), TimeUnit.MILLISECONDS)。但是要小心，一个相对延迟到期不符合当前的任务是使Date由于网络时间同步协议的时钟漂移，或其他因素。

的Executors类提供了这个包提供ScheduledExecutorService实现方便工厂方法。

使用示例

这里提供一种方法，建立了一个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);
   }
 }

哔哔声

从以下版本开始：

一点五

方法摘要

Modifier and Type	Method and Description
<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) 创建和执行一个周期的动作变成了使后先给定的初始延迟，随后与给定的时期；这是执行将开始 initialDelay然后 initialDelay+period，然后 initialDelay + 2 * period，等等。
ScheduledFuture<?>	scheduleWithFixedDelay(Runnable command, long initialDelay, long delay, TimeUnit unit) 创建和执行一个周期性的行动，使第一次后，给定的初始延迟，并随后与给定的一个执行之间的终止和下一个开始的开始。

Methods inherited from interface java.util.concurrent.ExecutorService

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

Methods inherited from interface java.util.concurrent.Executor

execute

方法详细信息

schedule

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

创建并执行在给定的延迟后启用的一一个射击动作。

参数

command -任务执行

delay -时间从现在到延迟执行

unit -延迟参数的时间单位

结果

一个scheduledfuture表示待完成的任务，其 get()方法将返回 null完成后

异常

RejectedExecutionException如果任务不能按计划执行

NullPointerException如果命令是无效的

schedule

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

创建和执行一个scheduledfuture成为给定的延迟后启用。

参数类型

V -可调用的结果的类型

参数

callable -函数的执行

delay -时间从现在到延迟执行

unit -延迟参数的时间单位

结果

一个scheduledfuture可以用来提取结果或取消

异常

RejectedExecutionException如果任务不能按计划执行

NullPointerException如果赎回是空的

scheduleAtFixedRate

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

创建和执行一个周期的动作变成了使后先给定的初始延迟，随后与给定的时期；这是执行将开始 initialDelay然后 initialDelay+period，然后 initialDelay + 2 * period，等等。如果任务的任何执行遇到异常，则抑制后续的执行。否则，任务只会通过执行器的取消或终止而终止。如果这个任务的执行时间比它的周期长，那么随后的处决可能会开始晚，但不会同时执行。

参数

command -任务执行

initialDelay -时间延迟第一次执行

period之间连续执行期

unit -时间单位的initialdelay和周期参数

结果

一个scheduledfuture表示待完成的任务，其 get()方法将抛出一个异常后取消

异常

RejectedExecutionException如果任务不能按计划执行

NullPointerException如果命令是无效的

IllegalArgumentException -如果时间小于或等于零

scheduleWithFixedDelay

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

创建和执行一个周期性的行动，使第一次后，给定的初始延迟，并随后与给定的一个执行之间的终止和下一个开始的开始。如果任务的任何执行遇到异常，则抑制后续的执行。否则，任务只会通过执行器的取消或终止而终止。

参数

command -任务执行

initialDelay -时间延迟第一次执行

delay -一个执行和下一个开始的结束之间的延迟

unit的initialdelay和延迟参数的时间单位

结果

一个scheduledfuture表示待完成的任务，其 get()方法将抛出一个异常后取消

异常

RejectedExecutionException如果任务不能按计划执行

NullPointerException如果命令是无效的

IllegalArgumentException如果延迟小于或等于零