Timer (Java 2 플랫폼 SE v1. 4.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2
Platform
Std. Ed. v1. 4.0

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | constructor | 메소드

상세: 필드 | constructor | 메소드

javax.swing
클래스 Timer

java.lang.Object 
  |
  +--javax.swing.Timer

모든 구현 인터페이스:: Serializable

public class Timer
extends Object
implements Serializable

1 kr 이상의 액션 이벤트를, 지정된 지연 시간의 경과후에 방아쇠 합니다. 예를 들어,Timer 는 애니메이션 오브젝트의 프레임을 표현 하는 방아쇠로서 사용할 수 있습니다.

타이머의 설정에는 Timer 오브젝트의 생성, 오브젝트에의 1 개 이상의 액션 청취자의 등록, 및 start 메소드를 사용한 타이머의 기동이 포함됩니다. 예를 들어, 다음에 나타내는 코드에서는 Timer constructor 에의 최초의 인수에 의해 지정된 것처럼, 액션 이벤트가 1 초간에 1 회생 이루어져 기동됩니다. Timer constructor 에의 2 번째의 인수에서는 타이머의 액션 이벤트를 수신하는 청취자를 지정하고 있습니다.

int delay = 1000; //milliseconds
ActionListener taskPerformer = new ActionListener() {
public void actionPerformed(ActionEvent evt) {
//...Perform a task...
      }
  };
new Timer(delay, taskPerformer). start();

각 Timer 는 1 kr 이상의 액션 청취자와delay (액션 이벤트간의 시간)를 가집니다. 밀리 세컨드 단위로 지정된 delay 의 시간이 경과하면(자),Timer 는 청취자에 대해서 액션 이벤트를 방아쇠 합니다. 디폴트에서는 이 사이클은 stop 메소드가 불려 갈 때까지 반복해집니다. 타이머의 방아쇠를 1 회인 만큼 하려면 , 타이머에 setRepeats(false) 를 호출합니다. 최초의 액션 이벤트가 방아쇠 될 때까지의 지연 시간을 액션 이벤트간의 지연 시간과는 다른 시간으로 설정하려면 ,setInitialDelay 메소드를 사용합니다.

모든 Timer 는 실행하는 최초의 Timer 오브젝트가 작성한 단일의 공유 thread를 사용해 대기 처리를 실행합니다만,Timer 의 액션 이벤트 핸들러는 그것과는 다른 이벤트디스팟치스렛드로 실행됩니다. 그 때문에,Timer 의 액션 이벤트 핸들러는 Swing 컴퍼넌트의 오퍼레이션을 안전하게 실행할 수 있습니다. 다만, 한편으로 Timer 의 액션 이벤트 핸들러는 GUI 의 응답을 유지할 수 있도록, 신속히 동작할 필요가 있습니다.

v 1.3 에서는 새로운 Timer 클래스 java.util.Timer 이 Java 플랫폼에 추가되고 있습니다. 이 클래스와 javax.swing.Timer 의 기본적인 기능은 같습니다만,java.util.Timer 는 보다 범용적이어보다 많은 기능을 가지고 있습니다. javax.swing.Timer 에는 GUI 에서의 사용을 용이하게 하는 2 개의 특징이 있습니다. 1 번째는 이벤트 처리 metaphor가 GUI 프로그래머에게 친숙함이 있어서 , 이벤트디스팟치스렛드의 취급이 간단하게 되어 있는 것입니다. 2 번째는 자동 공유 thread에 의해, 생성하는 thread의 수가 다대하게 되는 것을 회피하기 위한 특별한 순서가 불필요하게 되는 것입니다. 다만, 타이머는 커서의 점멸이나 툴 힌트의 표시등과 같은 thread를 사용합니다.

타이머의 상세와 사용예에 대해서는 「The Java Tutorial」의「How to Use Swing Timers」를 참조해 주세요. 이 Timer 클래스와 java.util.Timer 의 선택 기준이나 사용예에 대해서는 「The Swing Connection」의「Using Timers in Swing Applications」를 참조해 주세요.

경고: 이 클래스의 직렬화 된 오브젝트에는 Swing 의 향후의 릴리스와 호환성이 없습니다. 현재의 직렬화 서포트는 단기 기억과 같은 버젼의 Swing 를 실행하고 있는 어플리케이션간 RMI 에 유효합니다. 버젼 1.4 이후, 모든 JavaBeans^TM 의 장기 기억 서포트가 java.beans 패키지에 추가되고 있습니다. XMLEncoder 를 참조해 주세요.

관련 항목:: java.util.Timer

필드의 개요

protected EventListenerList listenerList


생성자의 개요

Timer (int delay, ActionListener listener)
          밀리 세컨드 단위의 delay 마다 청취자에게 통지하는 Timer 를 생성합니다.

메소드의 개요

void addActionListener (ActionListener listener)
          액션 청취자를 Timer 에 추가합니다.

protected void fireActionPerformed (ActionEvent e)
          통지의 전달 대상을, 지정된 이벤트 타입으로 등록한 모든 청취자에게 통지합니다.

ActionListener [] getActionListeners ()
          타이머에 등록된 모든 액션 청취자의 배열을 돌려줍니다.

int getDelay ()
          액션 이벤트의 방아쇠간의 지연 시간 (밀리 세컨드 단위)을 돌려줍니다.

int getInitialDelay ()
          Timer 의 초기 지연을 돌려줍니다.

EventListener [] getListeners (Class listenerType)
          FooListener 로서 현재 Timer 에 등록되어 모든 오브젝트의 배열을 돌려줍니다.

static boolean getLogTimers ()
          로그가 유효한 경우에 true 를 돌려줍니다.

boolean isCoalesce ()
          Timer 가 보류중의 복수의 액션 이벤트를 합체 하는 경우에 true 를 돌려줍니다.

boolean isRepeats ()
          Timer 가 액션 이벤트를 청취자에게 여러 차례 송신하는 경우, 디폴트의 true 를 돌려줍니다.

boolean isRunning ()
          Timer 가 실행중이면,true 를 돌려줍니다.

void removeActionListener (ActionListener listener)
          지정된 액션 청취자를 Timer 로부터 삭제합니다.

void restart ()
          Timer 를 재기동합니다.

void setCoalesce (boolean flag)
          Timer 가 보류중의 복수의 ActionEvent 방아쇠를 합체 시킬지 어떨지를 설정합니다.

void setDelay (int delay)
          연속하는 액션 이벤트간의 Timer 지연 시간을 밀리 세컨드 단위로 설정합니다.

void setInitialDelay (int initialDelay)
          Timer 의 초기 지연을 설정합니다.

static void setLogTimers (boolean flag)
          타이머의 로그를 유효 또는 무효로 합니다.

void setRepeats (boolean flag)
          flag 가 false 의 경우, 액션 이벤트를 1 개만 청취자에게 송신하도록(듯이) Timer 에 인스트럭션 합니다.

void start ()
          Timer 를 기동해, 청취자에게로의 액션 이벤트의 송신을 개시합니다.

void stop ()
          Timer 를 정지해, 청취자에게로의 액션 이벤트의 송신을 정지합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

listenerList

protected EventListenerList  listenerList

생성자의 상세

Timer

public Timer(int delay,
             ActionListener  listener)

밀리 세컨드 단위의 delay 마다 청취자에게 통지하는 Timer 를 생성합니다. delay 가 0 이하의 경우, 타이머는 기동과 동시에 방아쇠 합니다. listener 가 null 이외의 경우는 타이머의 액션 청취자로서 등록됩니다.
파라미터:: delay - 액션 이벤트간의 시간 (밀리 세컨드 단위); listener - 초기의 청취자. null 의 경우도 있어
관련 항목:: addActionListener(java.awt.event.ActionListener) , setInitialDelay(int) , setRepeats(boolean)

메소드의 상세

addActionListener

public void addActionListener(ActionListener  listener)

액션 청취자를 Timer 에 추가합니다.

파라미터:: listener - 추가하는 청취자
관련 항목:: Timer(int, java.awt.event.ActionListener)

removeActionListener

public void removeActionListener(ActionListener  listener)

지정된 액션 청취자를 Timer 로부터 삭제합니다.

파라미터:: listener - 삭제하는 청취자

getActionListeners

public ActionListener [] getActionListeners()

타이머에 등록된 모든 액션 청취자의 배열을 돌려줍니다.

반환값:: 타이머의 모든 ActionListener. 현재 등록되어 있는 액션 청취자가 없는 경우는 하늘의 배열
도입된 버젼:: 1.4
관련 항목:: addActionListener(java.awt.event.ActionListener) , removeActionListener(java.awt.event.ActionListener)

fireActionPerformed

protected void fireActionPerformed(ActionEvent  e)

통지의 전달 대상을, 지정된 이벤트 타입으로 등록한 모든 청취자에게 통지합니다.

파라미터:: e - 방아쇠 하는 액션 이벤트
관련 항목:: EventListenerList

getListeners

public EventListener [] getListeners(Class  listenerType)

FooListener 로서 현재 Timer 에 등록되어 모든 오브젝트의 배열을 돌려줍니다. FooListener 는 addFooListener 메소드를 사용해 등록됩니다.

FooListener.class 와 같이, 클래스 리터럴을 사용해 listenerType 인수를 지정할 수 있습니다. 예를 들어, 액션 청취자의 Timer 인스턴스 t 를 조회하려면 , 다음의 코드를 사용합니다.

ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));

상기의 청취자가 존재하지 않는 경우, 이 메소드는 하늘의 배열을 돌려줍니다.

파라미터:: listenerType - 요구된 청취자의 타입. java.util.EventListener 의 하위의 인터페이스를 지정
반환값:: 타이머에 FooListener 로서 등록되어 모든 오브젝트의 배열. 그러한 청취자가 추가되어 있지 않은 경우는 하늘의 배열
예외:: ClassCastException - listenerType 가,java.util.EventListener 를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우
도입된 버젼:: 1.3
관련 항목:: getActionListeners() , addActionListener(java.awt.event.ActionListener) , removeActionListener(java.awt.event.ActionListener)

setLogTimers

public static void setLogTimers(boolean flag)

타이머의 로그를 유효 또는 무효로 합니다. 유효하게 하면(자), 타이머가 끊어졌을 때에 System.out 에 메세지가 보내집니다.

파라미터:: flag - 로그를 유효하게 하는 경우는 true
관련 항목:: getLogTimers()

getLogTimers

public static boolean getLogTimers()

로그가 유효한 경우에 true 를 돌려줍니다.

반환값:: 로그가 유효한 경우는 true, 그렇지 않은 경우는 false
관련 항목:: setLogTimers(boolean)

setDelay

public void setDelay(int delay)

연속하는 액션 이벤트간의 Timer 지연 시간을 밀리 세컨드 단위로 설정합니다.

파라미터:: delay - 지연 시간 (밀리 세컨드 단위)
관련 항목:: setInitialDelay(int)

getDelay

public int getDelay()

액션 이벤트의 방아쇠간의 지연 시간 (밀리 세컨드 단위)을 돌려줍니다.

관련 항목:: setDelay(int) , getInitialDelay()

setInitialDelay

public void setInitialDelay(int initialDelay)

Timer 의 초기 지연을 설정합니다. 디폴트에서는 이벤트간의 지연 시간과 같은 값입니다. 이 값은 최초의 액션 이벤트인 만큼 사용됩니다. 2 번째 이후의 액션 이벤트에는 delay 프로퍼티가 사용됩니다.

파라미터:: initialDelay - start 메소드의 호출로부터, 타이머가 방아쇠 하는 최초의 액션 이벤트까지의 지연 시간 (밀리 세컨드 단위)
관련 항목:: setDelay(int)

getInitialDelay

public int getInitialDelay()

Timer 의 초기 지연을 돌려줍니다.

관련 항목:: setInitialDelay(int) , setDelay(int)

setRepeats

public void setRepeats(boolean flag)

flag 가 false 의 경우, 액션 이벤트를 1 개만 청취자에게 송신하도록(듯이) Timer 에 인스트럭션 합니다.

파라미터:: flag - 최초의 액션 이벤트의 송신 후 타이머를 정지시키는 경우는 false

isRepeats

public boolean isRepeats()

Timer 가 액션 이벤트를 청취자에게 여러 차례 송신하는 경우, 디폴트의 true 를 돌려줍니다.

관련 항목:: setRepeats(boolean)

setCoalesce

public void setCoalesce(boolean flag)

Timer 가 보류중의 복수의 ActionEvent 방아쇠를 합체 시킬지 어떨지를 설정합니다. Busy 어플리케이션은 Timer 의 이벤트 생성을 따라 잡을 수 없는 경우가 있어, 결과적으로 복수의 액션 이벤트가 큐에 들어갑니다. 처리를 하면(자), 어플리케이션은 이러한 이벤트를 차례차례로 보내므로,Timer 의 청취자는 지연 없게 일련의 이벤트를 받습니다. 보류중의 복수 이벤트를 1 개의 이벤트에 합체 하면 이 상황을 피할 수 있습니다. Timer 는 그러한 이벤트를 디폴트로 1 개에 합체 합니다.

파라미터:: flag - 합체를 오프로 하는 경우는 false

isCoalesce

public boolean isCoalesce()

Timer 가 보류중의 복수의 액션 이벤트를 합체 하는 경우에 true 를 돌려줍니다.

관련 항목:: setCoalesce(boolean)

start

public void start()

Timer 를 기동해, 청취자에게로의 액션 이벤트의 송신을 개시합니다.

관련 항목:: stop()

isRunning

public boolean isRunning()

Timer 가 실행중이면,true 를 돌려줍니다.

관련 항목:: start()

stop

public void stop()

Timer 를 정지해, 청취자에게로의 액션 이벤트의 송신을 정지합니다.

관련 항목:: start()

restart

public void restart()

Timer 를 재기동합니다. 보류중의 방아쇠가 있으면 취소해, 초기 지연을 사용해 방아쇠 합니다.

개요