org.wegra.util.Timer
|
|||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Object
주어진 시간마다 작업을 할 수 있도록 하기 위한 Timer 클래스.
일단 실행시키면 미리 정해진 시간만큼 실행된다.
스레드들에 비해 비교적 높은 우선 순위에서 실행되며
하나 이상의 일반 스레드들은 Timer가 만료되기를 기다린다.
"one shot" 모드는 한번만 실행된 후 만료된다.
다시 실행될 수도 있지만 보통 그럴 필요가 없는 경우에만 사용한다.
"multi shot" 모드는 다시 실행되는 경우에 주로 사용한다
이 점만 빼면 두 모드는 완전히 동일하다.
명시적으로 stop() 메소드를 호출해야만 종료된다.
"continuous" 모드는 계속해서 실행되어야 하는 경우에 사용한다.
Timer가 완료되었을 경우에는 자동적으로 다시 Timer를 시작해준다.
"multi shot" 모드와 마찬가지로 명시적으로 stop() 을 호출해야한다.
모든 Timer 모드는 실행중이라도 재시작될 수 있다.
(시간 간격을 원래대로 되돌리는 기능)
주의>
1. "multi shot" Timer 혹은 "continuous" Timer에 대하 stop()을
사용해서 종료해주는 것을 잊는 경우가 종종 생긴다. 이는 곧바로 메모리 누수로
이어진다.
(VM은 내부적으로 활성 상태나 대기 상태의 스레드 객체애 대한 참조를 유지한다.
따라서, 외부에 명시적인 참조가 없을 경우라도 종료된 스레드가 아니면 가비지
콜렉트 되지 않는다).
종결자를 사용하여 이러 ㄴ경우에 대한 보고를 하도록 해 놓았지만 종결자는
호출되지 않을 가능성이 있기에 완벽한 해결책으로 보기엔 무리가 있다.
2. Timer에 대해 Thread.wait() 를 호출하는 것은 가능하지만
이 호출은 오직 "continuous" Timer에만 유효할 것이다.
모든 Timer에 유효하기 위해서는 대신 await() 메소드를 사용해야만 한다.
wait() 가 필요한 경우는 오직 InterruptedException의 발생에 대해 알고 싶은
경우인데, await() 의 경우에는 InterruptedException을 단순히 무시해버리기
때문이다.
| Nested Class Summary | |
static class |
Timer.Test
테스트용 클래스 |
| Field Summary | |
static java.lang.String |
COMMAND_EXPIRED
Timer가 만료되었거나 "ticked" 되었을 때 ActinsListener에게로 보내지는 "액션 커맨드"이다. |
static java.lang.String |
COMMAND_STOPPED
Timer가 사용자에 의해 종료되었을 때 ActionListener에게로 보내지는 "액션 커맨드" 이다. |
static java.lang.Object |
MODE_CONTINUOUS
MODE_CONTINUOUS Timer는 일정한 시간 간격마다 블록킹 된 스레드들을 놓아주면서 계속 실행된다(강제로 멈출 수 있다). |
static java.lang.Object |
MODE_MULTI_SHOT
MODE_MULTI_SHOT Timer는 stop() 메소드가 호출되어 강제로 멈춰지기 전까지 계속해서 사용할 수 있다. |
static java.lang.Object |
MODE_ONE_SHOT
MODE_ONE_SHOT Timer는 한 번만 수행된 후 자동으로 멈춘다. |
static int |
REQUEST_LIMIT
addActionListener()를 사용해서 Timer의 통지를 받을 대상을 추가해줄 수 있다. |
| Constructor Summary | |
Timer(int delay)
계속적으로 수행되는 CONTINUOUS Timer를 만든다. |
|
Timer(int delay,
java.lang.Object mode,
boolean keepAlive)
밀리초 단위로 주어지는 지연 시간 후에 만료되는 Timer를 생성한다. |
|
| Method Summary | |
void |
addActionListener(java.awt.event.ActionListener observer)
다음번 Timer 의 통지를 받아볼 리스너를 추가한다. |
boolean |
await()
Long.MAX_VALUE 만큼의 시간 후에 만료된다 |
boolean |
await(long timeout)
Timer가 만료될 때까지 기다린다. |
void |
finalized()
이 메소드가 호출될 때 MODE_CONTINUOUS Timer나 MODE_MULTI_SHOT Timer가 아직 멈춰져 있지 않다면 버그가 있는 것이다. |
void |
removeActionListener(java.awt.event.ActionListener observer)
리스너를 제거한다. |
void |
start()
만료된 Timer를 재시작하거나 새롭게 Timer를 시작한다. |
void |
stop()
현재 Timer를 강제로 종료한다. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
public static final int REQUEST_LIMIT
public static final java.lang.Object MODE_CONTINUOUS
public static final java.lang.Object MODE_ONE_SHOT
public static final java.lang.Object MODE_MULTI_SHOT
public static final java.lang.String COMMAND_STOPPED
public static final java.lang.String COMMAND_EXPIRED
| Constructor Detail |
public Timer(int delay)
public Timer(int delay,
java.lang.Object mode,
boolean keepAlive)
delay - 밀리초 단위의 만료 시간mode - 다음의 상수 중 하나
Timer.MODE_OCNTINUOUS Timer는 계속적으로 실행된다.
만약 종료하고자 할 때에는 명시적으로 stop()을 호출해야 한다.
Timer.MODE_ONE_SHOT Timer가 한 번만 실행된 후 멈춘다.
이 모드의 Timer는 명시적으로 종료할 필요가 없다.
Timer.MODE_MULTI_SHOT 기본적으로 ONE_SHOT Timer와
같지만 좀 더 효율적으로 재시작할 수 있다.
만약 종료하고자 할 때엔 명시적으로 stop()를 호출해야 한다.keepAlive - 기본적으로 Timer의 시간 관리 스레드는 데몬
스레드이다.
이는 Timer가 작동중이라도 프로그램은 종료될 수
있음을 뜻한다. 이런 특성으로 인해 싱클 스레드
애플리케이션에서 어떤 일을 클럭 틱이 발생햇을 때 하고자
한다면 문제가 발생할 수 있다. 이 값을 true로 주면
Timer의 시간 관리 스레드를 데몬으로 설정하지 않는다.
따라서, Timer를 종료하기 위해서는 명시적으로 stop()
을 호출하거나 System.exit()를 호출해야 한다.
만료된 MODE_ONE_SHOT Timer나 MODE_MULTI_SHOT
Timer는 프로세스를 유지시키도록 하지 않는다.| Method Detail |
public void addActionListener(java.awt.event.ActionListener observer)
public boolean await()
public boolean await(long timeout)
public void finalized()
public void removeActionListener(java.awt.event.ActionListener observer)
public void start()
public void stop()
|
|||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||