javax.swing
클래스 Timer

java.lang.Object 
  javax.swing.Timer

모든 구현된 인터페이스:

Serializable

public class Timer
extends Object 
implements Serializable 

1개 이상의 액션 이벤트를, 지정된 지연 시간의 경과후에 트리거 합니다. 예를 들어, Timer는 애니메이션 객체의 프레임을 렌더링 하는 트리거로서 사용할 수 있습니다. 타이머의 설정에는 Timer 객체의 생성, 객체에의 1개 이상의 액션 리스너의 등록 및 start 메서드를 사용한 타이머의 시작이 포함됩니다. 예를 들어 다음에 나타내는 코드에서는 Timer 생성자에의 최초의 인수에 의해 지정된 것처럼, 액션 이벤트가 1 초간에 1회 생 이루어져 시작됩니다. Timer 생성자에의 2번째의 인수에서는 타이머의 액션 이벤트를 수신하는 리스너를 지정하고 있습니다.

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

각 Timer는 1개 이상의 액션 리스너와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 Timers」를 참조하십시오. 이 Timer 클래스와 java.util.Timer 선택 기준이나 사용예에 대해서는 「The Swing Connection」의 「Using Timers in Swing Applications」를 참조하십시오.

경고: 이 클래스의 직렬화 된 객체는 향후의 Swing 릴리즈와 호환되지 않을 예정입니다. 현재의 직렬화의 지원은 단기간의 운용이나, 같은 버전의 Swing를 실행하는 어플리케이션간의 RMI에 적절하고 있습니다. JDK 버전 1.4 이후, 모든 JavaBeans^™ 장기간의 운용 지원은 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 초기 지연을 리턴합니다.
<T extends EventListener > T[]	getListeners (Class <T> 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 <T extends EventListener > T[] getListeners(Class <T> 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를 재시작합니다. 보류중의 트리거가 있으면 취소해, 초기 지연을 사용해 트리거 합니다.