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	getAllNotificationIDs () 통지 리스트에 등록되어 모든 타이머 통지 식별자를 취득합니다.
Date	getDate (Integer id) 타이머 통지에 관련된 날짜와 시간의 복사본을 취득합니다.
Boolean	getFixedRate (Integer id) 정기 통지를 fixed-delay 로 실행할까 fixed-rate 로 실행하는지를 나타내는 플래그의 복사본을 취득합니다.
int	getNbNotifications () 통지 리스트에 등록되어 있는 타이머 통지의 수를 취득합니다.
Long	getNbOccurences (Integer id) 타이머 통지에 관련된 나머지의 발행수의 복사본을 취득합니다.
Vector	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 () 타이머 통지의 리스트가 비어있는지 판정합니다.
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 - 간격 또는 발행수가 잘못된 값 의 경우

관련 항목:

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 - 간격 또는 발행수가 잘못된 값 의 경우

관련 항목:

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 - 날짜와 시간가 잘못된 값 인가 통지의 날짜와 시간가 현재의 날짜와 시간보다 전

addNotification

Integer  addNotification(String  type,
                        String  message,
                        Object  userData,
                        Date  date)
                        throws IllegalArgumentException 

지정된 type, message 및 userData 로 새로운 타이머 통지를 작성해, 이것을 지정의 날짜와 시간, 간격 null 및 발행수와 함께 통지 리스트에 삽입합니다.

타이머 통지는 지정된 날짜와 시간에 정리해 처리됩니다.

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

파라미터:

type - 타이머 통지형

message - 타이머 통지의 상세 메세지

userData - 타이머 통지의 사용자 데이터 객체

date - 통지가 발행되는 날짜와 시간

반환값:

새롭게 작성된 타이머 통지의 식별자

예외:

IllegalArgumentException - 통지의 날짜와 시간가 현재의 날짜와 시간보다 전

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  getAllNotificationIDs()

통지 리스트에 등록되어 모든 타이머 통지 식별자를 취득합니다.

반환값:

모든 타이머 통지 식별자를 포함한 Integer 객체 벡터.
이 타이머 MBean에 타이머 통지가 등록되지 않은 경우는 공백

getNotificationIDs

Vector  getNotificationIDs(String  type)

지정된 형태에 대응하는 모든 타이머 통지 식별자를 취득합니다.

파라미터:

type - 타이머 통지형

반환값:

지정된 type 모든 타이머 통지 식별자를 포함한 Integer 객체 벡터.
이 타이머 MBean 로 지정된 type 타이머 통지가 등록되지 않은 경우는 비어있음

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()

타이머 통지의 리스트가 비어있는지 판정합니다.

반환값:

타이머 통지의 리스트가 비어있는 경우는 true, 그렇지 않은 경우는 false