JavaTM Platform
Standard Ed. 6

javax.management.timer
인터페이스 TimerMBean

기존의 구현 클래스의 일람:
Timer


public interface TimerMBean

타이머 MBean 의 관리 인터페이스를 공개합니다.

도입된 버젼:
1.5

메소드의 개요
 Integer addNotification (String  type, String  message, Object  userData, Date  date)
          지정된 type,message, 및 userData 로 새로운 타이머 통지를 작성해, 이것을 지정의 일자, 간격 null, 및 발행수와 함께 통지 리스트에 삽입합니다.
 Integer addNotification (String  type, String  message, Object  userData, Date  date, long period)
          지정된 type,message, 및 userData 로 새로운 타이머 통지를 작성해, 이것을 지정의 일자, 간격, 및 발행수 null 와 함께 통지 리스트에 삽입합니다.
 Integer addNotification (String  type, String  message, Object  userData, Date  date, long period, long nbOccurences)
          지정된 type,message, 및 userData 로 새로운 타이머 통지를 작성해, 이것을 지정의 일자, 간격, 및 발행수와 함께 통지 리스트에 삽입합니다.
 Integer addNotification (String  type, String  message, Object  userData, Date  date, long period, long nbOccurences, boolean fixedRate)
          지정된 type,message, 및 userData 로 새로운 타이머 통지를 작성해, 이것을 지정의 일자, 간격, 및 발행수와 함께 통지 리스트에 삽입합니다.
 Vector <Integer > getAllNotificationIDs ()
          통지 리스트에 등록되어 모든 타이머 통지 식별자를 가져옵니다.
 Date getDate (Integer  id)
          타이머 통지에 관련지을 수 있었던 일자의 카피를 가져옵니다.
 Boolean getFixedRate (Integer  id)
          정기 통지를 fixed-delay 로 실행할까 fixed-rate 로 실행하는지를 나타내는 플래그의 카피를 가져옵니다.
 int getNbNotifications ()
          통지 리스트에 등록되어 있는 타이머 통지의 수를 가져옵니다.
 Long getNbOccurences (Integer  id)
          타이머 통지에 관련지을 수 있었던 나머지의 발행수의 카피를 가져옵니다.
 Vector <Integer > getNotificationIDs (String  type)
          지정된 형태에 대응하는 모든 타이머 통지 식별자를 가져옵니다.
 String getNotificationMessage (Integer  id)
          지정된 식별자에 대응하는 타이머 통지의 상세 메세지를 가져옵니다.
 String getNotificationType (Integer  id)
          지정된 식별자에 대응하는 타이머 통지형을 가져옵니다.
 Object getNotificationUserData (Integer  id)
          지정된 식별자에 대응하는 타이머 통지의 사용자 데이터 객체를 가져옵니다.
 Long getPeriod (Integer  id)
          타이머 통지에 관련지을 수 있었던 간격 (밀리 세컨드)의 카피를 가져옵니다.
 boolean getSendPastNotifications ()
          타이머가 과거의 통지를 송신할지 어떨지를 나타내는 플래그를 가져옵니다.
 boolean isActive ()
          타이머 MBean 가 액티브한가 어떤가를 테스트합니다.
 boolean isEmpty ()
          타이머 통지의 리스트가 빈 상태(empty)인가 어떤가를 판정합니다.
 void removeAllNotifications ()
          통지 리스트로부터 모든 타이머 통지를 삭제해, 타이머 통지 식별자를 갱신하기 위한 카운터를 리셋 합니다.
 void removeNotification (Integer  id)
          지정된 식별자에 대응하는 타이머 통지를 통지 리스트로부터 삭제합니다.
 void removeNotifications (String  type)
          지정된 형태에 대응하는 모든 타이머 통지를 통지 리스트로부터 삭제합니다.
 void setSendPastNotifications (boolean value)
          타이머가 과거의 통지를 송신할지 어떨지를 나타내는 플래그를 설정합니다.
 void start ()
          타이머를 기동합니다.
 void stop ()
          타이머를 정지합니다.
 

메소드의 상세

start

void start()
타이머를 기동합니다.

통지 리스트내에, 그 시간보다 전에 발행된 타이머 통지가 1 개 이상 있는 경우, 이 통지는 sendPastNotifications 플래그에 따라 송신되어 간격과 나머지의 발행수에 따라 갱신됩니다. 타이머 통지의 일자가 현재의 일자보다 전의 경우, 이 통지는 통지 리스트로부터 삭제됩니다.


stop

void stop()
타이머를 정지합니다.


addNotification

Integer  addNotification(String  type,
                        String  message,
                        Object  userData,
                        Date  date,
                        long period,
                        long nbOccurences,
                        boolean fixedRate)
                        throws IllegalArgumentException 
지정된 type,message, 및 userData 로 새로운 타이머 통지를 작성해, 이것을 지정의 일자, 간격, 및 발행수와 함께 통지 리스트에 삽입합니다.

삽입되는 타이머 통지의 일자가 현재의 일자보다 전의 경우, 이 메소드는, 지정된 일자가 현재의 일자이다고 하여 동작합니다.
1 회만의 통지는, 즉시 전달됩니다.
정기적인 통지의 경우, 최초의 통지는 즉시 전달된 이후의 통지는 간격 파라미터로 지정된 간격으로 전달됩니다.

타이머 통지가 통지 리스트에 추가된 뒤, 관련지을 수 있었던 일자, 간격, 및 발행수를 갱신할 수 없습니다.

정기 통지의 경우,Timer 로 지정되고 있도록(듯이),fixedRate 파라미터의 값이 실행 schema의 지정에 사용됩니다.

파라미터:
type - 타이머 통지형
message - 타이머 통지의 상세 메세지
userData - 타이머 통지의 사용자 데이터 객체
date - 통지가 발행되는 일자
period - 타이머 통지의 간격 (밀리 세컨드)
nbOccurences - 발행되는 타이머 통지의 합계수
fixedRate - true 이며, 정기 통지인 경우, fixed-rate 실행 schema로 스케줄 된다. false 이며, 정기 통지인 경우, fixed-delay 실행 schema로 스케줄 된다. 정기 통지가 아닌 경우는 무시된다
반환값:
새롭게 작성된 타이머 통지의 식별자
예외:
IllegalArgumentException - 일자가 null 인지, 간격 또는 발행수가 0 보다 작은 값의 경우
관련 항목:
addNotification(String, String, Object, Date, long, long)

addNotification

Integer  addNotification(String  type,
                        String  message,
                        Object  userData,
                        Date  date,
                        long period,
                        long nbOccurences)
                        throws IllegalArgumentException 
지정된 type,message, 및 userData 로 새로운 타이머 통지를 작성해, 이것을 지정의 일자, 간격, 및 발행수와 함께 통지 리스트에 삽입합니다.

삽입되는 타이머 통지의 일자가 현재의 일자보다 전의 경우, 이 메소드는, 지정된 일자가 현재의 일자이다고 하여 동작합니다.
1 회만의 통지는, 즉시 전달됩니다.
정기적인 통지의 경우, 최초의 통지는 즉시 전달된 이후의 통지는 간격 파라미터로 지정된 간격으로 전달됩니다.

타이머 통지가 통지 리스트에 추가된 뒤, 관련지을 수 있었던 일자, 간격, 및 발행수를 갱신할 수 없습니다.

정기 통지의 경우,Timer 로 지정되고 있도록(듯이) fixed-delay 실행 schema를 사용합니다. fixed-rate 실행 schema를 사용하려면 , 대신에 addNotification(String, String, Object, Date, long, long, boolean) 를 사용합니다.

파라미터:
type - 타이머 통지형
message - 타이머 통지의 상세 메세지
userData - 타이머 통지의 사용자 데이터 객체
date - 통지가 발행되는 일자
period - 타이머 통지의 간격 (밀리 세컨드)
nbOccurences - 발행되는 타이머 통지의 합계수
반환값:
새롭게 작성된 타이머 통지의 식별자
예외:
IllegalArgumentException - 일자가 null 인지, 간격 또는 발행수가 0 보다 작은 값의 경우
관련 항목:
addNotification(String, String, Object, Date, long, long, boolean)

addNotification

Integer  addNotification(String  type,
                        String  message,
                        Object  userData,
                        Date  date,
                        long period)
                        throws IllegalArgumentException 
지정된 type,message, 및 userData 로 새로운 타이머 통지를 작성해, 이것을 지정의 일자, 간격, 및 발행수 null 와 함께 통지 리스트에 삽입합니다.

타이머 통지는,Timer 로 지정되고 있도록(듯이),fixed-delay 실행 schema를 사용하는 타이머 간격으로 연속적으로 반복해집니다. fixed-rate 실행 schema를 사용하려면 , 대신에 addNotification(String, String, Object, Date, long, long, boolean) 를 사용합니다.

삽입되는 타이머 통지의 일자가 현재의 일자보다 전의 경우, 이 메소드는, 지정된 일자가 현재의 일자이다고 하여 동작합니다. 최초의 통지는 즉시 전달된 이후의 통지는 간격 파라미터로 지정된 간격으로 전달됩니다.

파라미터:
type - 타이머 통지형
message - 타이머 통지의 상세 메세지
userData - 타이머 통지의 사용자 데이터 객체
date - 통지가 발행되는 일자
period - 타이머 통지의 간격 (밀리 세컨드)
반환값:
새롭게 작성된 타이머 통지의 식별자
예외:
IllegalArgumentException - 일자가 null 인지, 간격이 0 보다 작은 값의 경우

addNotification

Integer  addNotification(String  type,
                        String  message,
                        Object  userData,
                        Date  date)
                        throws IllegalArgumentException 
지정된 type,message, 및 userData 로 새로운 타이머 통지를 작성해, 이것을 지정의 일자, 간격 null, 및 발행수와 함께 통지 리스트에 삽입합니다.

타이머 통지는 지정된 일자에 정리해 처리됩니다.

삽입되는 타이머 통지의 일자가 현재의 일자보다 전의 경우, 이 메소드는, 지정된 일자가 현재의 일자이다고 하여 동작합니다. 통지는 즉시 전달됩니다.

파라미터:
type - 타이머 통지형
message - 타이머 통지의 상세 메세지
userData - 타이머 통지의 사용자 데이터 객체
date - 통지가 발행되는 일자
반환값:
새롭게 작성된 타이머 통지의 식별자
예외:
IllegalArgumentException - 일자가 null 인 경우

removeNotification

void removeNotification(Integer  id)
                        throws InstanceNotFoundException 
지정된 식별자에 대응하는 타이머 통지를 통지 리스트로부터 삭제합니다.

파라미터:
id - 타이머 통지 식별자
예외:
InstanceNotFoundException - 이 타이머 MBean 의 통지 리스트내에, 지정된 식별자에 대응하는 타이머 통지가 존재하지 않는다

removeNotifications

void removeNotifications(String  type)
                         throws InstanceNotFoundException 
지정된 형태에 대응하는 모든 타이머 통지를 통지 리스트로부터 삭제합니다.

파라미터:
type - 타이머 통지형
예외:
InstanceNotFoundException - 이 타이머 MBean 의 통지 리스트내에, 지정된 형태에 대응하는 타이머 통지가 존재하지 않는다

removeAllNotifications

void removeAllNotifications()
통지 리스트로부터 모든 타이머 통지를 삭제해, 타이머 통지 식별자를 갱신하기 위한 카운터를 리셋 합니다.


getNbNotifications

int getNbNotifications()
통지 리스트에 등록되어 있는 타이머 통지의 수를 가져옵니다.

반환값:
타이머 통지의 수

getAllNotificationIDs

Vector <Integer > getAllNotificationIDs()
통지 리스트에 등록되어 모든 타이머 통지 식별자를 가져옵니다.

반환값:
모든 타이머 통지 식별자를 포함한 Integer 객체 말하고 쿠톨.
이 타이머 MBean 에 타이머 통지가 등록되지 않은 경우는 빈 상태(empty)

getNotificationIDs

Vector <Integer > getNotificationIDs(String  type)
지정된 형태에 대응하는 모든 타이머 통지 식별자를 가져옵니다.

파라미터:
type - 타이머 통지형
반환값:
지정된 type 의 모든 타이머 통지 식별자를 포함한 Integer 객체 말하고 쿠톨.
이 타이머 MBean 로 지정된 type 의 타이머 통지가 등록되지 않은 경우는 빈 상태(empty)

getNotificationType

String  getNotificationType(Integer  id)
지정된 식별자에 대응하는 타이머 통지형을 가져옵니다.

파라미터:
id - 타이머 통지 식별자
반환값:
타이머 통지형. 식별자가 이 타이머 MBean 에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getNotificationMessage

String  getNotificationMessage(Integer  id)
지정된 식별자에 대응하는 타이머 통지의 상세 메세지를 가져옵니다.

파라미터:
id - 타이머 통지 식별자
반환값:
타이머 통지의 상세 메세지. 식별자가 이 타이머 MBean 에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getNotificationUserData

Object  getNotificationUserData(Integer  id)
지정된 식별자에 대응하는 타이머 통지의 사용자 데이터 객체를 가져옵니다.

파라미터:
id - 타이머 통지 식별자
반환값:
타이머 통지의 사용자 데이터 객체. 식별자가 이 타이머 MBean 에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getDate

Date  getDate(Integer  id)
타이머 통지에 관련지을 수 있었던 일자의 카피를 가져옵니다.

파라미터:
id - 타이머 통지 식별자
반환값:
일자의 카피. 식별자가 이 타이머 MBean 에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getPeriod

Long  getPeriod(Integer  id)
타이머 통지에 관련지을 수 있었던 간격 (밀리 세컨드)의 카피를 가져옵니다.

파라미터:
id - 타이머 통지 식별자
반환값:
간격의 카피. 식별자가 이 타이머 MBean 에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getNbOccurences

Long  getNbOccurences(Integer  id)
타이머 통지에 관련지을 수 있었던 나머지의 발행수의 카피를 가져옵니다.

파라미터:
id - 타이머 통지 식별자
반환값:
나머지의 발행수의 카피. 식별자가 이 타이머 MBean 에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getFixedRate

Boolean  getFixedRate(Integer  id)
정기 통지를 fixed-delay 로 실행할까 fixed-rate 로 실행하는지를 나타내는 플래그의 카피를 가져옵니다.

파라미터:
id - 타이머 통지 식별자
반환값:
정기 통지를 fixed-delay 로 실행할까 fixed-rate 로 실행하는지를 나타내는 플래그의 카피

getSendPastNotifications

boolean getSendPastNotifications()
타이머가 과거의 통지를 송신할지 어떨지를 나타내는 플래그를 가져옵니다.

반환값:
과거의 통지를 송신할지 어떨지를 지정하는 플래그치
관련 항목:
setSendPastNotifications(boolean)

setSendPastNotifications

void setSendPastNotifications(boolean value)
타이머가 과거의 통지를 송신할지 어떨지를 나타내는 플래그를 설정합니다.

파라미터:
value - 과거의 통지를 송신할지 어떨지를 지정하는 플래그치
관련 항목:
getSendPastNotifications()

isActive

boolean isActive()
타이머 MBean 가 액티브한가 어떤가를 테스트합니다. 타이머 MBean 는,start 메소드가 불려 가면(자) 액티브하게 되어,stop 메소드가 불려 가면(자) 비액티브하게 됩니다.

반환값:
타이머 MBean 가 액티브한 경우는 true, 그렇지 않은 경우는 false

isEmpty

boolean isEmpty()
타이머 통지의 리스트가 빈 상태(empty)인가 어떤가를 판정합니다.

반환값:
타이머 통지의 리스트가 빈 상태(empty)의 경우는 true, 그렇지 않은 경우는 false

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.