加载中...
The Wayback Machine - https://sup1a9wrlpyh5li9ro.vcoronado.top/web/20090218033556/http://developer.android.com:80/reference/java/util/Timer.html
public class

Timer

extends Object
java.lang.Object
   ↳ java.util.Timer

Class Overview

Timers are used to schedule jobs for execution in a background process. A single thread is used for the scheduling and this thread has the option of being a daemon thread. By calling cancel you can terminate a timer and it's associated thread. All tasks which are scheduled to run after this point are cancelled. Tasks are executed sequentially but are subject to the delays from other tasks run methods. If a specific task takes an excessive amount of time to run it may impact the time at which subsequent tasks may run.

The Timer task does not offer any guarantees about the real-time nature of scheduling tasks as it's underlying implementation relies on the Object.wait(long) method.

Multiple threads can share a single Timer without the need for their own synchronization.

See Also

Summary

Public Constructors
Timer(boolean isDaemon)
Creates a new Timer which may be specified to be run as a Daemon Thread.
Timer()
Creates a new non-daemon Timer.
Timer(String name, boolean isDaemon)
Timer(String name)
Public Methods
void cancel()
Cancels the Timer and removed any scheduled tasks.
int purge()
void schedule(TimerTask task, Date when)
Schedule a task for single execution.
void schedule(TimerTask task, long delay, long period)
Schedule a task for repeated fix-delay execution after a specific delay.
void schedule(TimerTask task, long delay)
Schedule a task for single execution after a specific delay.
void schedule(TimerTask task, Date when, long period)
Schedule a task for repeated fix-delay execution after a specific time has been reached.
void scheduleAtFixedRate(TimerTask task, Date when, long period)
Schedule a task for repeated fixed-rate execution after a specific time has been reached.
void scheduleAtFixedRate(TimerTask task, long delay, long period)
Schedule a task for repeated fixed-rate execution after a specific delay has been happened.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public Timer (boolean isDaemon)

Creates a new Timer which may be specified to be run as a Daemon Thread.

Parameters
isDaemon true if Timers thread should be a daemon thread.

public Timer ()

Creates a new non-daemon Timer.

public Timer (String name, boolean isDaemon)

public Timer (String name)

Public Methods

public void cancel ()

Cancels the Timer and removed any scheduled tasks. If there is a currently running task it is not effected. No more tasks may be scheduled on this Timer. Subsequent calls do nothing.

public int purge ()

public void schedule (TimerTask task, Date when)

Schedule a task for single execution. If when is less than the current time, it will be scheduled to executed as soon as possible.

Parameters
task The task to schedule
when Time of execution
Throws
IllegalArgumentException if when.getTime() < 0
IllegalStateException if the timer has been cancelled, the task has been scheduled or cancelled.

public void schedule (TimerTask task, long delay, long period)

Schedule a task for repeated fix-delay execution after a specific delay.

Parameters
task The task to schedule
delay Amount of time before first execution
period Amount of time between subsequent executions
Throws
IllegalArgumentException if delay < 0 or period < 0
IllegalStateException if the timer has been cancelled, the task has been scheduled or cancelled.

public void schedule (TimerTask task, long delay)

Schedule a task for single execution after a specific delay.

Parameters
task The task to schedule
delay Amount of time before execution
Throws
IllegalArgumentException if delay < 0
IllegalStateException if the timer has been cancelled, the task has been scheduled or cancelled.

public void schedule (TimerTask task, Date when, long period)

Schedule a task for repeated fix-delay execution after a specific time has been reached.

Parameters
task The task to schedule
when Time of first execution
period Amount of time between subsequent executions
Throws
IllegalArgumentException if when.getTime() < 0 or period < 0
IllegalStateException if the timer has been cancelled, the task has been scheduled or cancelled.

public void scheduleAtFixedRate (TimerTask task, Date when, long period)

Schedule a task for repeated fixed-rate execution after a specific time has been reached. The difference of fixed-rate is that it may bunch up subsequent task runs to try to get the task repeating at it's desired time.

Parameters
task The task to schedule
when Time of first execution
period Amount of time between subsequent executions
Throws
IllegalArgumentException if when.getTime() < 0 or period < 0
IllegalStateException if the timer has been cancelled, the task has been scheduled or cancelled.

public void scheduleAtFixedRate (TimerTask task, long delay, long period)

Schedule a task for repeated fixed-rate execution after a specific delay has been happened. The difference of fixed-rate is that it may bunch up subsequent task runs to try to get the task repeating at it's desired time.

Parameters
task The task to schedule
delay Amount of time before first execution
period Amount of time between subsequent executions
Throws
IllegalArgumentException if delay < 0 or period < 0
IllegalStateException if the timer has been cancelled, the task has been scheduled or cancelled.