java.util
Class Timer

java.lang.Object
  |
  +--java.util.Timer

public class Timer

extends Object

스레드가 백그라운드 스레드에서 나중에 실행할 작업을 예약할 수 있는 기능입니다. 작업은 한 번 실행되거나 정기적인 간격으로 반복 실행되도록 예약할 수 있습니다.

각 Timer 객체에는 모든 타이머 작업을 순차적으로 실행하는 데 사용되는 단일 백그라운드 스레드가 있습니다. 타이머 작업은 신속하게 완료해야 합니다. 타이머 작업을 완료하는 데 시간이 너무 오래 걸리면 이 타이머의 작업 실행 스레드가 "호그"됩니다. 이 경우 이후 작업의 실행도 지연되므로 위반 작업이 최종적으로 완료되면 모든 작업이 "쌓여서" 연속적으로 빠르게 실행될 수도 있습니다.

Timer 객체에 대한 마지막 라이브 참조가 사라지고 아직 해결되지 않은 모든 작업의 실행이 완료되면 타이머의 작업 실행 스레드가 정상적으로 종료되고 가비지 컬렉션이 적용됩니다. 하지만 이렇게 되기까지 오랜 시간이 걸릴 수 있습니다. 기본적으로 작업 실행 스레드는 데몬 스레드로 실행되지 않으므로 응용 프로그램이 종료되지 않도록 방지할 수 있습니다. 타이머의 작업 실행 스레드를 신속하게 종료하려면 호출자는 타이머의 cancel 메소드를 호출해야 합니다.

타이머의 작업 실행 스레드가 예상치 않게 종료된 경우 이후에 타이머에서 작업을 예약하려고 시도하면 타이머의 cancel 메소드를 호출한 것처럼 IllegalStateException이 발생합니다.

이 클래스는 스레드 안정성이 높으므로 다수의 스레드가 외부 동기화 없이도 단일 Timer 객체를 공유할 수 있습니다.

또한 이 클래스는 실시간 보증을 제공하지 않으므로 Object.wait(long) 메소드를 사용하여 작업을 예약합니다. 타이머는 구현 및 장치별로 다르게 결정됩니다.

타이머는 단일 가상 머신 내에서만 작동하며 가상 머신을 종료하면 취소됩니다. 가상 머신을 시작할 때 타이머가 없으면 응용 프로그램 요청에 의해서만 만들어집니다.

Since:

MIDP 1.0

See Also:

TimerTask, Object.wait(long)

Constructor Summary

Timer()
새로운 타이머를 만듭니다.

Method Summary

void	cancel() 이 타이머를 종료하고 현재 예약된 모든 작업을 삭제합니다.
void	schedule(TimerTask task, Date time) 지정된 시간에 지정된 작업이 실행되도록 예약합니다.
void	schedule(TimerTask task, Date firstTime, long period) 지정된 시간부터 지정된 작업이 고정 지연 실행을 반복하도록 예약합니다.
void	schedule(TimerTask task, long delay) 지정된 지연 후에 지정된 작업이 실행되도록 예약합니다.
void	schedule(TimerTask task, long delay, long period) 지정된 지연 후부터 지정된 작업이 고정 지연 실행을 반복하도록 예약합니다.
void	scheduleAtFixedRate(TimerTask task, Date firstTime, long period) 지정된 시간부터 지정된 작업이 고정 속도 실행을 반복하도록 예약합니다.
void	scheduleAtFixedRate(TimerTask task, long delay, long period) 지정한 지연 후부터 지정한 작업이 고정 속도 실행을 반복하도록 예약합니다.

Methods inherited from class java.lang.Object

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

Constructor Detail

Timer

public Timer()

새로운 타이머를 만듭니다. 연결된 스레드는 데몬 스레드로 실행되지 않으므로 응용 프로그램이 종료되지 않도록 방지할 수 있습니다.

See Also:

Thread, cancel()

Method Detail

schedule

public void schedule(TimerTask task,
                     long delay)

지정된 지연 후에 지정된 작업이 실행되도록 예약합니다.

Parameters:

task - 예약되는 작업

delay - 작업이 실행되기 전의 지연(밀리초) 타이머는 구현 및 장치별로 다르게 결정되기 때문에 실제 지연은 요청된 시간과 다를 수도 있습니다.

Throws:

IllegalArgumentException - delay가 음수이거나 delay + System.currentTimeMillis()가 음수인 경우

IllegalStateException - 작업이 이미 예약 또는 취소되었거나 타이머가 취소된 경우

schedule

public void schedule(TimerTask task,
                     Date time)

지정된 시간에 지정된 작업이 실행되도록 예약합니다. 시간이 이미 지났으면 작업은 즉시 실행되도록 예약됩니다.

Parameters:

task - 예약되는 작업

time - 작업이 실행되는 시간

Throws:

IllegalArgumentException - time.getTime()이 음수인 경우

IllegalStateException - 작업이 이미 예약 또는 취소되었거나 타이머가 취소되었거나 타이머 스레드가 종료된 경우

schedule

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

지정된 지연 후부터 지정된 작업이 고정 지연 실행을 반복하도록 예약합니다. 후속 실행은 지정된 시간으로 구분되어 대략 정기적인 간격으로 발생합니다. 타이머는 구현 및 장치별로 다르게 결정되기 때문에 실제 지연은 요청된 시간과 다를 수도 있습니다.

고정 지연 실행 시 각 실행은 이전 실행의 실제 실행 시간에 상대적으로 예약됩니다. 가비지 컬렉션이나 기타 백그라운드 작업 등 어떤 이유로든 실행이 지연되면 이후 실행도 지연됩니다. 결국 시스템 시계 기본 Object.wait(long)가 정확하다고 가정할 경우 일반적으로 실행 빈도는 지정된 기간에 해당하는 값에 반비례 값보다 다소 적습니다.

고정 지연 실행은 "원활하게" 실행해야 하는 반복 작업에 적합합니다. 즉, 장기적인 측면보다 단기적인 측면에서 빈도를 정확하게 유지하는 것이 보다 중요한 작업에 바람직합니다. 여기에는 정기적인 간격으로 깜박이는 커서와 같은 대부분의 애니메이션 작업이 포함됩니다. 키를 누르고 있는 동안 자동으로 한 문자를 반복하는 작업과 같이 사용자 입력에 응답하여 정기적인 동작을 수행하는 작업도 여기에 포함됩니다.

Parameters:

task - 예약되는 작업

delay - 작업이 실행되기 전의 지연(밀리초) 타이머는 구현 및 장치별로 다르게 결정되기 때문에 실제 지연은 요청된 시간과 다를 수도 있습니다.

period - 연속 작업 실행 사이의 시간(밀리초)

Throws:

IllegalArgumentException - delay가 음수이거나 delay + System.currentTimeMillis()가 음수인 경우

IllegalStateException - 작업이 이미 예약 또는 취소되었거나 타이머가 취소되었거나 타이머 스레드가 종료된 경우

schedule

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

지정된 시간부터 지정된 작업이 고정 지연 실행을 반복하도록 예약합니다. 후속 실행은 지정된 시간으로 구분되어 대략 정기적인 간격으로 발생합니다.

고정 지연 실행 시 각 실행은 이전 실행의 실제 실행 시간에 상대적으로 예약됩니다. 가비지 컬렉션이나 기타 백그라운드 작업 등 어떤 이유로든 실행이 지연되면 이후 실행도 지연됩니다. 결국 시스템 시계 기본 Object.wait(long)가 정확하다고 가정할 경우 일반적으로 실행 빈도는 지정된 기간에 해당하는 값에 비해 다소 적습니다.

고정 지연 실행은 "원활하게" 실행해야 하는 반복 작업에 적합합니다. 즉, 장기적인 측면보다 단기적인 측면에서 빈도를 정확하게 유지하는 것이 보다 중요한 작업에 바람직합니다. 여기에는 정기적인 간격으로 깜박이는 커서와 같은 대부분의 애니메이션 작업이 포함됩니다. 키를 누르고 있는 동안 자동으로 한 문자를 반복하는 작업과 같이 사용자 입력에 응답하여 정기적인 동작을 수행하는 작업도 여기에 포함됩니다.

Parameters:

task - 예약되는 작업

firstTime - 작업이 처음 실행되는 시간

period - 연속 작업 실행 사이의 시간(밀리초)

Throws:

IllegalArgumentException - time.getTime()이 음수인 경우

IllegalStateException - 작업이 이미 예약 또는 취소되었거나 타이머가 취소되었거나 타이머 스레드가 종료된 경우

scheduleAtFixedRate

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

지정한 지연 후부터 지정한 작업이 고정 속도 실행을 반복하도록 예약합니다. 후속 실행은 지정된 시간으로 구분되어 대략 정기적인 간격으로 발생합니다.

고정 속도 실행 시 각 실행은 예약된 초기 실행 시간에 상대적으로 예약됩니다. 가비지 컬렉션이나 기타 백그라운드 작업 등 어떤 이유로든 실행이 지연되면 속도에 "맞추기" 위해 두 개 이상의 실행이 연속해서 빠르게 수행됩니다. 결국 시스템 시계 기본 Object.wait(long)가 정확하다고 가정할 경우 일반적으로 실행 빈도는 지정된 기간에 해당하는 값과 같습니다.

고정 속도 실행은 정시마다 벨을 울리거나 매일 특정 시간에 예약된 유지 보수를 실행하는 작업과 같이 절대적 시간이 중요한 반복 작업에 적합합니다. 10초 동안 매초마다 한 번 시간을 알리는 카운트다운 타이머와 같이 고정된 횟수의 실행을 수행하는 총 시간이 중요한 반복 작업에도 바람직합니다. 마지막으로 고정 속도 실행은 상대적으로 동기화를 유지해야 하는 여러 개의 반복 타이머 작업을 예약하는 데 적합합니다.

Parameters:

task - 예약되는 작업

delay - 작업이 실행되기 전의 지연(밀리초) 타이머는 구현 및 장치별로 다르게 결정되기 때문에 실제 지연은 요청된 시간과 다를 수도 있습니다.

period - 연속 작업 실행 사이의 시간(밀리초)

Throws:

IllegalArgumentException - delay가 음수이거나 delay + System.currentTimeMillis()가 음수인 경우

IllegalStateException - 작업이 이미 예약 또는 취소되었거나 타이머가 취소되었거나 타이머 스레드가 종료된 경우

scheduleAtFixedRate

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

지정된 시간부터 지정된 작업이 고정 속도 실행을 반복하도록 예약합니다. 후속 실행은 지정된 시간으로 구분되어 대략 정기적인 간격으로 발생합니다.

고정 속도 실행 시 각 실행은 예약된 초기 실행 시간에 상대적으로 예약됩니다. 가비지 컬렉션이나 기타 백그라운드 작업 등 어떤 이유로든 실행이 지연되면 속도에 "맞추기" 위해 두 개 이상의 실행이 연속해서 빠르게 수행됩니다. 결국 시스템 시계 기본 Object.wait(long)가 정확하다고 가정할 경우 일반적으로 실행 빈도는 지정된 기간에 해당하는 값과 같습니다.

고정 속도 실행은 정시마다 벨을 울리거나 매일 특정 시간에 예약된 유지 보수를 실행하는 작업과 같이 절대적 시간이 중요한 반복 작업에 적합합니다. 10초 동안 매초마다 한 번 시간을 알리는 카운트다운 타이머와 같이 고정된 횟수의 실행을 수행하는 총 시간이 중요한 반복 작업에도 바람직합니다. 마지막으로 고정 속도 실행은 상대적으로 동기화를 유지해야 하는 여러 개의 반복 타이머 작업을 예약하는 데 적합합니다.

Parameters:

task - 예약되는 작업

firstTime - 작업이 처음 실행되는 시간

period - 연속 작업 실행 사이의 시간(밀리초)

Throws:

IllegalArgumentException - time.getTime()이 음수인 경우

IllegalStateException - 작업이 이미 예약 또는 취소되었거나 타이머가 취소되었거나 타이머 스레드가 종료된 경우

cancel

public void cancel()

이 타이머를 종료하고 현재 예약된 모든 작업을 삭제합니다. 현재 실행 중인 작업은 중단하지 않습니다. 타이머가 종료되면 해당 실행 스레드도 함께 종료되어 더 이상 작업을 예약할 수 없습니다.

이 타이머에서 호출한 타이머 작업의 run 메소드 내에서 이 메소드를 호출하면 현재 실행 중인 작업이 이 타이머에서 실행되는 마지막 작업이 됩니다.

이 메소드는 반복해서 호출할 수 있지만 두 번째 및 이후 호출 시에는 어떤 변화도 없습니다.