java.lang.Object | |
↳ | java.util.Timer |
Timers schedule one-shot or recurring tasks
for execution.
Prefer ScheduledThreadPoolExecutor
for new code.
Each timer has one thread on which tasks are executed sequentially. When this thread is busy running a task, runnable tasks may be subject to delays.
One-shot are scheduled to run at an absolute time or after a relative delay.
Recurring tasks are scheduled with either a fixed period or a fixed rate:
period
.
When a timer is no longer needed, users should call cancel()
, which
releases the timer's thread and other resources. Timers not explicitly
cancelled may hold resources indefinitely.
This class does not offer guarantees about the real-time nature of task scheduling. Multiple threads can share a single timer without synchronization.
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates a new named
Timer which may be specified to be run as a
daemon thread.
| |||||||||||
Creates a new named
Timer which does not run as a daemon thread.
| |||||||||||
Creates a new
Timer which may be specified to be run as a daemon thread.
| |||||||||||
Creates a new non-daemon
Timer .
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Cancels the
Timer and all scheduled tasks.
| |||||||||||
Removes all canceled tasks from the task queue.
| |||||||||||
Schedule a task for repeated fixed-delay execution after a specific time
has been reached.
| |||||||||||
Schedule a task for repeated fixed-delay execution after a specific delay.
| |||||||||||
Schedule a task for single execution.
| |||||||||||
Schedule a task for single execution after a specified delay.
| |||||||||||
Schedule a task for repeated fixed-rate execution after a specific delay
has passed.
| |||||||||||
Schedule a task for repeated fixed-rate execution after a specific time
has been reached.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
Creates a new named Timer
which may be specified to be run as a
daemon thread.
NullPointerException | if name == null
|
---|
Creates a new named Timer
which does not run as a daemon thread.
NullPointerException | if name == null
|
---|
Creates a new Timer
which may be specified to be run as a daemon thread.
isDaemon | true if the Timer 's thread should be a daemon thread.
|
---|
Cancels the Timer
and all scheduled tasks. If there is a
currently running task it is not affected. No more tasks may be scheduled
on this Timer
. Subsequent calls do nothing.
Removes all canceled tasks from the task queue. If there are no other references on the tasks, then after this call they are free to be garbage collected.
Schedule a task for repeated fixed-delay execution after a specific time has been reached.
task | the task to schedule. |
---|---|
when | time of first execution. |
period | amount of time in milliseconds between subsequent executions. |
IllegalArgumentException | if when.getTime() < 0 or period <= 0 . |
---|---|
IllegalStateException | if the Timer has been canceled, or if the task has been
scheduled or canceled.
|
Schedule a task for repeated fixed-delay execution after a specific delay.
task | the task to schedule. |
---|---|
delay | amount of time in milliseconds before first execution. |
period | amount of time in milliseconds between subsequent executions. |
IllegalArgumentException | if delay < 0 or period <= 0 . |
---|---|
IllegalStateException | if the Timer has been canceled, or if the task has been
scheduled or canceled.
|
Schedule a task for single execution. If when
is less than the
current time, it will be scheduled to be executed as soon as possible.
task | the task to schedule. |
---|---|
when | time of execution. |
IllegalArgumentException | if when.getTime() < 0 . |
---|---|
IllegalStateException | if the Timer has been canceled, or if the task has been
scheduled or canceled.
|
Schedule a task for single execution after a specified delay.
task | the task to schedule. |
---|---|
delay | amount of time in milliseconds before execution. |
IllegalArgumentException | if delay < 0 . |
---|---|
IllegalStateException | if the Timer has been canceled, or if the task has been
scheduled or canceled.
|
Schedule a task for repeated fixed-rate execution after a specific delay has passed.
task | the task to schedule. |
---|---|
delay | amount of time in milliseconds before first execution. |
period | amount of time in milliseconds between subsequent executions. |
IllegalArgumentException | if delay < 0 or period <= 0 . |
---|---|
IllegalStateException | if the Timer has been canceled, or if the task has been
scheduled or canceled.
|
Schedule a task for repeated fixed-rate execution after a specific time has been reached.
task | the task to schedule. |
---|---|
when | time of first execution. |
period | amount of time in milliseconds between subsequent executions. |
IllegalArgumentException | if when.getTime() < 0 or period <= 0 . |
---|---|
IllegalStateException | if the Timer has been canceled, or if the task has been
scheduled or canceled.
|