javax.management.timer
클래스 Timer

java.lang.Object 
  javax.management.NotificationBroadcasterSupport 
      javax.management.timer.Timer

모든 구현된 인터페이스:

MBeanRegistration, NotificationBroadcaster, NotificationEmitter, TimerMBean

public class Timer
extends NotificationBroadcasterSupport 
implements TimerMBean,
 MBeanRegistration 

타이머 MBean 구현을 제공합니다. 타이머 MBean는 지정된 시간에 알람을 발신하는 것으로써, 타이머 통지를 수신하는 리스너로서 등록되어 모든 리스너를 시작합니다.

이 클래스는 날짜와 시간의 지정된 타이머 통지의 리스트를 관리합니다. 단일의 메서드로 필요한 수의 통지를 추가 또는 삭제할 수 있습니다. 타이머부터 발행된 타이머 통지는 낡아지면 자동적으로 타이머 통지 리스트로부터 삭제됩니다.
정기적으로 반복하는 통지로서 타이머 통지를 추가할 수 있습니다.

주:

1. sendPastNotifications 플래그 상태 (와)는 관계없는 것으로addNotification 메서드가 불려가기 전의 모든 통지가 무시됩니다.
2. 타이머 통지의 송신시, 타이머는 모든 통지형의 통지 순서 번호를 갱신합니다.
3. 타이머 서비스는 Timer 클래스가 로드 된 호스트의 시스템 시간에 존하고 있습니다. 호스트의 시스템 시간이 차이가 나면, 리스너가 올바른 시각에 통지를 납득할 수 없는 것이 있습니다. 이러한 문제를 피하려면, 타이밍의 필요한 모든 호스트 머신의 시스템 시간을 동기화합니다.
4. 정기 통지의 디폴트의 동작은, Timer 로 지정되고 있도록 fixed-delay 실행 schema입니다. fixed-rate 실행 schema를 사용하려면, overload 된 addNotification(String, String, Object, Date, long, long, boolean) 메서드를 사용합니다.
5. 통지 리스너 전부가 같은 thread로 실행될 가능성이 있습니다. 다른 리스너의 처리를 방해하거나 fixed-delay 실행의 규칙성을 어지럽히는 것이 없게, 이러한 리스너는 재빠르게 실행할 필요가 있습니다. NotificationBroadcasterSupport를 참조하십시오.

도입된 버전 :

1.5

필드 개요

static long	ONE_DAY 1 하나의 밀리 세컨드수.
static long	ONE_HOUR 1 시간의 밀리 세컨드수.
static long	ONE_MINUTE 1 분의 밀리 세컨드수.
static long	ONE_SECOND 1 초의 밀리 세컨드수.
static long	ONE_WEEK 1 주간의 밀리 세컨드수.

생성자 개요

Timer ()
디폴트의 생성자 입니다.

메서드 개요

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) 지정된 형태에 대응하는 모든 타이머 통지 식별자를 취득합니다.
MBeanNotificationInfo []	getNotificationInfo () 이 MBean가 통지를 송신할 때마다, 그 통지의 Java 클래스명과 통지형을 나타내는 배열을 리턴합니다.
String	getNotificationMessage (Integer id) 지정된 식별자에 대응하는 타이머 통지의 상세 메세지를 취득합니다.
String	getNotificationType (Integer id) 지정된 식별자에 대응하는 타이머 통지형을 취득합니다.
Object	getNotificationUserData (Integer id) 지정된 식별자에 대응하는 타이머 통지의 사용자 데이터 객체를 취득합니다.
Long	getPeriod (Integer id) 타이머 통지에 관련된 간격 (밀리 세컨드)의 복사본을 취득합니다.
boolean	getSendPastNotifications () 타이머가 과거의 통지를 송신할지 어떨지를 지정하는 플래그를 취득합니다.
boolean	isActive () 타이머 MBean가 활성화되었는가 어떤가를 테스트합니다.
boolean	isEmpty () 타이머 통지의 리스트가 비어있는지 판정합니다.
void	postDeregister () MBean 서버로부터 등록 해제한뒤 타이머 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
void	postRegister (Boolean registrationDone) MBean 서버에의 등록이 성공 또는 실패한뒤 타이머 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
void	preDeregister () MBean 서버로부터 등록 해제하기 전에 타이머 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
ObjectName	preRegister (MBeanServer server, ObjectName name) MBean 서버에 등록하기 전에 타이머 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
void	removeAllNotifications () 통지 리스트로부터 모든 타이머 통지를 삭제해, 타이머 통지 식별자를 갱신하기 위한 카운터를 리셋 합니다.
void	removeNotification (Integer id) 지정된 식별자에 대응하는 타이머 통지를 통지 리스트로부터 삭제합니다.
void	removeNotifications (String type) 지정된 형태에 대응하는 모든 타이머 통지를 통지 리스트로부터 삭제합니다.
void	setSendPastNotifications (boolean value) 타이머가 과거의 통지를 송신할지 어떨지를 지정하는 플래그를 설정합니다.
void	start () 타이머를 시작합니다.
void	stop () 타이머를 정지합니다.

클래스 javax.management. NotificationBroadcasterSupport 로부터 상속된 메서드

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

클래스 java.lang. Object 로부터 상속된 메서드

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

필드의 상세

ONE_SECOND

public static final long ONE_SECOND

1 초의 밀리 세컨드수. addNotification 메서드로 사용되는 정수

관련 항목:

정수 필드값

ONE_MINUTE

public static final long ONE_MINUTE

1 분의 밀리 세컨드수. addNotification 메서드로 사용되는 정수

관련 항목:

정수 필드값

ONE_HOUR

public static final long ONE_HOUR

1 시간의 밀리 세컨드수. addNotification 메서드로 사용되는 정수

관련 항목:

정수 필드값

ONE_DAY

public static final long ONE_DAY

1 하나의 밀리 세컨드수. addNotification 메서드로 사용되는 정수

관련 항목:

정수 필드값

ONE_WEEK

public static final long ONE_WEEK

1 주간의 밀리 세컨드수. addNotification 메서드로 사용되는 정수

관련 항목:

정수 필드값

생성자 상세

Timer

public Timer()

디폴트의 생성자 입니다.

메서드의 상세

preRegister

public ObjectName  preRegister(MBeanServer  server,
                              ObjectName  name)
                       throws Exception 

MBean 서버에 등록하기 전에 타이머 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.

이 컨텍스트에 서는 사용하지 않습니다.

정의:

인터페이스 MBeanRegistration 내의 preRegister

파라미터:

server - MBean 서버. 타이머 MBean는 여기에 등록되는

name - 타이머 MBean 객체명

반환값:

등록이 끝난 타이머 MBean 이름

예외:

Exception -

postRegister

public void postRegister(Boolean  registrationDone)

MBean 서버에의 등록이 성공 또는 실패한뒤 타이머 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.

이 컨텍스트에 서는 사용하지 않습니다.

정의:

인터페이스 MBeanRegistration 내의 postRegister

파라미터:

registrationDone - MBean가 MBean 서버에 정상적으로 등록되었는지 어떠했는지를 나타낸다. 등록에 실패했을 경우의 값은 false

preDeregister

public void preDeregister()
                   throws Exception 

MBean 서버로부터 등록 해제하기 전에 타이머 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.

타이머를 정지합니다.

정의:

인터페이스 MBeanRegistration 내의 preDeregister

예외:

Exception -

postDeregister

public void postDeregister()

MBean 서버로부터 등록 해제한뒤 타이머 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.

이 컨텍스트에 서는 사용하지 않습니다.

정의:

인터페이스 MBeanRegistration 내의 postDeregister

getNotificationInfo

public MBeanNotificationInfo [] getNotificationInfo()

인터페이스 NotificationBroadcaster 기술:

이 MBean가 통지를 송신할 때마다, 그 통지의 Java 클래스명과 통지형을 나타내는 배열을 리턴합니다.

MBean 가 이 배열에 기술되어 있지 않은 통지를 송신할 수 없습니다. 다만, 일부의 MBean 서버 클라이언트는 현재의 기능에 의해 완성하는 배열에 존하고 있는 경우가 있습니다.

정의:

인터페이스 NotificationBroadcaster 내의 getNotificationInfo

오버라이드(override):

클래스 NotificationBroadcasterSupport 내의 getNotificationInfo

반환값:

통지의 배열

start

public void start()

타이머를 시작합니다.

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

정의:

인터페이스 TimerMBean 내의 start

stop

public void stop()

타이머를 정지합니다.

정의:

인터페이스 TimerMBean 내의 stop

addNotification

public 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의 지정에 사용됩니다.

정의:

인터페이스 TimerMBean 내의 addNotification

파라미터:

type - 타이머 통지형

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

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

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

period - 타이머 통지의 간격 (밀리 세컨드)

nbOccurences - 발행되는 타이머 통지의 합계수

fixedRate - true 이며, 정기 통지인 경우, fixed-rate 실행 schema로 스케줄 된다. false 이며, 정기 통지인 경우, fixed-delay 실행 schema로 스케줄 된다. 정기 통지가 아닌 경우는 무시된다

반환값:

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

예외:

IllegalArgumentException - 간격 또는 발행수가 잘못된 값 의 경우

관련 항목:

addNotification(String, String, Object, Date, long, long)

addNotification

public 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)를 사용합니다.

정의:

인터페이스 TimerMBean 내의 addNotification

파라미터:

type - 타이머 통지형

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

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

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

period - 타이머 통지의 간격 (밀리 세컨드)

nbOccurences - 발행되는 타이머 통지의 합계수

반환값:

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

예외:

IllegalArgumentException - 간격 또는 발행수가 잘못된 값 의 경우

관련 항목:

addNotification(String, String, Object, Date, long, long, boolean)

addNotification

public 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)를 사용합니다.

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

정의:

인터페이스 TimerMBean 내의 addNotification

파라미터:

type - 타이머 통지형

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

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

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

period - 타이머 통지의 간격 (밀리 세컨드)

반환값:

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

예외:

IllegalArgumentException - 날짜와 시간가 잘못된 값 인가 통지의 날짜와 시간가 현재의 날짜와 시간보다 전

addNotification

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

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

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

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

정의:

인터페이스 TimerMBean 내의 addNotification

파라미터:

type - 타이머 통지형

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

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

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

반환값:

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

예외:

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

removeNotification

public void removeNotification(Integer  id)
                        throws InstanceNotFoundException 

지정된 식별자에 대응하는 타이머 통지를 통지 리스트로부터 삭제합니다.

정의:

인터페이스 TimerMBean 내의 removeNotification

파라미터:

id - 타이머 통지 식별자

예외:

InstanceNotFoundException - 이 타이머 MBean 통지 리스트내에 지정된 식별자에 대응하는 타이머 통지가 존재하지 않는다

removeNotifications

public void removeNotifications(String  type)
                         throws InstanceNotFoundException 

지정된 형태에 대응하는 모든 타이머 통지를 통지 리스트로부터 삭제합니다.

정의:

인터페이스 TimerMBean 내의 removeNotifications

파라미터:

type - 타이머 통지형

예외:

InstanceNotFoundException - 이 타이머 MBean 통지 리스트내에 지정된 형태에 대응하는 타이머 통지가 존재하지 않는다

removeAllNotifications

public void removeAllNotifications()

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

정의:

인터페이스 TimerMBean 내의 removeAllNotifications

getNbNotifications

public int getNbNotifications()

통지 리스트에 등록되어 있는 타이머 통지의 수를 취득합니다.

정의:

인터페이스 TimerMBean 내의 getNbNotifications

반환값:

타이머 통지의 수

getAllNotificationIDs

public Vector  getAllNotificationIDs()

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

정의:

인터페이스 TimerMBean 내의 getAllNotificationIDs

반환값:

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

getNotificationIDs

public Vector  getNotificationIDs(String  type)

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

정의:

인터페이스 TimerMBean 내의 getNotificationIDs

파라미터:

type - 타이머 통지형

반환값:

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

getNotificationType

public String  getNotificationType(Integer  id)

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

정의:

인터페이스 TimerMBean 내의 getNotificationType

파라미터:

id - 타이머 통지 식별자

반환값:

타이머 통지형. 식별자가 이 타이머 MBean에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getNotificationMessage

public String  getNotificationMessage(Integer  id)

지정된 식별자에 대응하는 타이머 통지의 상세 메세지를 취득합니다.

정의:

인터페이스 TimerMBean 내의 getNotificationMessage

파라미터:

id - 타이머 통지 식별자

반환값:

타이머 통지의 상세 메세지. 식별자가 이 타이머 MBean에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getNotificationUserData

public Object  getNotificationUserData(Integer  id)

지정된 식별자에 대응하는 타이머 통지의 사용자 데이터 객체를 취득합니다.

정의:

인터페이스 TimerMBean 내의 getNotificationUserData

파라미터:

id - 타이머 통지 식별자

반환값:

타이머 통지의 사용자 데이터 객체. 식별자가 이 타이머 MBean에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getDate

public Date  getDate(Integer  id)

타이머 통지에 관련된 날짜와 시간의 복사본을 취득합니다.

정의:

인터페이스 TimerMBean 내의 getDate

파라미터:

id - 타이머 통지 식별자

반환값:

일자의 카피. 식별자가 이 타이머 MBean에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getPeriod

public Long  getPeriod(Integer  id)

타이머 통지에 관련된 간격 (밀리 세컨드)의 복사본을 취득합니다.

정의:

인터페이스 TimerMBean 내의 getPeriod

파라미터:

id - 타이머 통지 식별자

반환값:

간격의 카피. 식별자가 이 타이머 MBean에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getNbOccurences

public Long  getNbOccurences(Integer  id)

타이머 통지에 관련된 나머지의 발행수의 복사본을 취득합니다.

정의:

인터페이스 TimerMBean 내의 getNbOccurences

파라미터:

id - 타이머 통지 식별자

반환값:

나머지의 발행수의 카피. 식별자가 이 타이머 MBean에 등록된 타이머 통지에 대응하고 있지 않는 경우는 null

getFixedRate

public Boolean  getFixedRate(Integer  id)

정기 통지를 fixed-delay 로 실행할까 fixed-rate 로 실행하는지를 나타내는 플래그의 복사본을 취득합니다.

정의:

인터페이스 TimerMBean 내의 getFixedRate

파라미터:

id - 타이머 통지 식별자

반환값:

정기 통지를 fixed-delay 로 실행할까 fixed-rate 로 실행하는지를 나타내는 플래그의 카피

getSendPastNotifications

public boolean getSendPastNotifications()

타이머가 과거의 통지를 송신할지 어떨지를 지정하는 플래그를 취득합니다.
과거의 통지를 송신할지 어떨지를 지정하는 플래그의 기본값는 false 입니다.

정의:

인터페이스 TimerMBean 내의 getSendPastNotifications

반환값:

과거의 통지를 송신할지 어떨지를 지정하는 플래그치

관련 항목:

setSendPastNotifications(boolean)

setSendPastNotifications

public void setSendPastNotifications(boolean value)

타이머가 과거의 통지를 송신할지 어떨지를 지정하는 플래그를 설정합니다.
과거의 통지를 송신할지 어떨지를 지정하는 플래그의 기본값는 false 입니다.

정의:

인터페이스 TimerMBean 내의 setSendPastNotifications

파라미터:

value - 과거의 통지를 송신할지 어떨지를 지정하는 플래그치

관련 항목:

getSendPastNotifications()

isActive

public boolean isActive()

타이머 MBean가 활성화되었는가 어떤가를 테스트합니다. 타이머 MBean는 start 메서드가 불려가 면 활성화 되어, stop 메서드가 불려가 면 비활성화 됩니다.
액티브와 비액티브의 변환 플래그의 기본값는 false 입니다.

정의:

인터페이스 TimerMBean 내의 isActive

반환값:

타이머 MBean가 활성화된 경우는 true, 그렇지 않은 경우는 false

isEmpty

public boolean isEmpty()

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

정의:

인터페이스 TimerMBean 내의 isEmpty

반환값:

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