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. 타이머 통지의 송신시, 타이머는, 모든 통지형의 통지 순서 번호를 갱신합니다.
2. 타이머 서비스는,Timer 클래스가 로드 된 호스트의 시스템 시간에 의존하고 있습니다. 호스트의 시스템 시간이 차이가 나면(자), 청취자가 올바른 시각에 통지를 납득할 수 없는 것이 있습니다. 이러한 문제를 피하려면 , 타이밍의 필요한 모든 호스트 머신의 시스템 시간을 동기화합니다.
3. 정기 통지의 디폴트의 동작은,Timer 로 지정되고 있도록(듯이) fixed-delay 실행 schema입니다. fixed-rate 실행 schema를 사용하려면 , overload 된 addNotification(String, String, Object, Date, long, long, boolean) 메소드를 사용합니다.
4. 통지 청취자 전부가 같은 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 <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) 지정된 형태에 대응하는 모든 타이머 통지 식별자를 가져옵니다.
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 () 타이머 통지의 리스트가 빈 상태(empty)인가 어떤가를 판정합니다.
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 - 일자가 null 인지, 간격 또는 발행수가 0 보다 작은 값의 경우

관련 항목:

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 - 일자가 null 인지, 간격 또는 발행수가 0 보다 작은 값의 경우

관련 항목:

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 - 일자가 null 인지, 간격이 0 보다 작은 값의 경우

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 - 일자가 null 인 경우

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

통지 리스트에 등록되어 모든 타이머 통지 식별자를 가져옵니다.

정의:

인터페이스 TimerMBean 내의 getAllNotificationIDs

반환값:

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

getNotificationIDs

public Vector <Integer > getNotificationIDs(String  type)

지정된 형태에 대응하는 모든 타이머 통지 식별자를 가져옵니다.

정의:

인터페이스 TimerMBean 내의 getNotificationIDs

파라미터:

type - 타이머 통지형

반환값:

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

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

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

정의:

인터페이스 TimerMBean 내의 isEmpty

반환값:

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