Home » openjdk-7 » javax » management » timer » [javadoc | source]
javax.management.timer
public interface: TimerMBean [javadoc | source]

All Known Implementing Classes:
    Timer

Exposes the management interface of the timer MBean.
Method from javax.management.timer.TimerMBean Summary:
addNotification,   addNotification,   addNotification,   addNotification,   getAllNotificationIDs,   getDate,   getFixedRate,   getNbNotifications,   getNbOccurences,   getNotificationIDs,   getNotificationMessage,   getNotificationType,   getNotificationUserData,   getPeriod,   getSendPastNotifications,   isActive,   isEmpty,   removeAllNotifications,   removeNotification,   removeNotifications,   setSendPastNotifications,   start,   stop
Method from javax.management.timer.TimerMBean Detail:
 public Integer addNotification(String type,
    String message,
    Object userData,
    Date date) throws IllegalArgumentException
    Creates a new timer notification with the specified type, message and userData and inserts it into the list of notifications with a given date and a null period and number of occurrences.

    The timer notification will be handled once at the specified date.

    If the timer notification to be inserted has a date that is before the current date, the method behaves as if the specified date were the current date and the notification is delivered immediately.

 public Integer addNotification(String type,
    String message,
    Object userData,
    Date date,
    long period) throws IllegalArgumentException
    Creates a new timer notification with the specified type, message and userData and inserts it into the list of notifications with a given date and period and a null number of occurrences.

    The timer notification will repeat continuously using the timer period using a fixed-delay execution scheme, as specified in java.util.Timer . In order to use a fixed-rate execution scheme, use #addNotification(String, String, Object, Date, long, long, boolean) instead.

    If the timer notification to be inserted has a date that is before the current date, the method behaves as if the specified date were the current date. The first notification is delivered immediately and the subsequent ones are spaced as specified by the period parameter.

 public Integer addNotification(String type,
    String message,
    Object userData,
    Date date,
    long period,
    long nbOccurences) throws IllegalArgumentException
    Creates a new timer notification with the specified type, message and userData and inserts it into the list of notifications with a given date, period and number of occurrences.

    If the timer notification to be inserted has a date that is before the current date, the method behaves as if the specified date were the current date.
    For once-off notifications, the notification is delivered immediately.
    For periodic notifications, the first notification is delivered immediately and the subsequent ones are spaced as specified by the period parameter.

    Note that once the timer notification has been added into the list of notifications, its associated date, period and number of occurrences cannot be updated.

    In the case of a periodic notification, uses a fixed-delay execution scheme, as specified in java.util.Timer . In order to use a fixed-rate execution scheme, use #addNotification(String, String, Object, Date, long, long, boolean) instead.

 public Integer addNotification(String type,
    String message,
    Object userData,
    Date date,
    long period,
    long nbOccurences,
    boolean fixedRate) throws IllegalArgumentException
    Creates a new timer notification with the specified type, message and userData and inserts it into the list of notifications with a given date, period and number of occurrences.

    If the timer notification to be inserted has a date that is before the current date, the method behaves as if the specified date were the current date.
    For once-off notifications, the notification is delivered immediately.
    For periodic notifications, the first notification is delivered immediately and the subsequent ones are spaced as specified by the period parameter.

    Note that once the timer notification has been added into the list of notifications, its associated date, period and number of occurrences cannot be updated.

    In the case of a periodic notification, the value of parameter fixedRate is used to specify the execution scheme, as specified in java.util.Timer .

 public Vector<Integer> getAllNotificationIDs()
    Gets all timer notification identifiers registered into the list of notifications.
 public Date getDate(Integer id)
    Gets a copy of the date associated to a timer notification.
 public Boolean getFixedRate(Integer id)
    Gets a copy of the flag indicating whether a periodic notification is executed at fixed-delay or at fixed-rate.
 public int getNbNotifications()
    Gets the number of timer notifications registered into the list of notifications.
 public Long getNbOccurences(Integer id)
    Gets a copy of the remaining number of occurrences associated to a timer notification.
 public Vector<Integer> getNotificationIDs(String type)
    Gets all the identifiers of timer notifications corresponding to the specified type.
 public String getNotificationMessage(Integer id)
    Gets the timer notification detailed message corresponding to the specified identifier.
 public String getNotificationType(Integer id)
    Gets the timer notification type corresponding to the specified identifier.
 public Object getNotificationUserData(Integer id)
    Gets the timer notification user data object corresponding to the specified identifier.
 public Long getPeriod(Integer id)
    Gets a copy of the period (in milliseconds) associated to a timer notification.
 public boolean getSendPastNotifications()
    Gets the flag indicating whether or not the timer sends past notifications.
 public boolean isActive()
    Tests whether the timer MBean is active. A timer MBean is marked active when the start method is called. It becomes inactive when the stop method is called.
 public boolean isEmpty()
    Tests whether the list of timer notifications is empty.
 public  void removeAllNotifications()
    Removes all the timer notifications from the list of notifications and resets the counter used to update the timer notification identifiers.
 public  void removeNotification(Integer id) throws InstanceNotFoundException
    Removes the timer notification corresponding to the specified identifier from the list of notifications.
 public  void removeNotifications(String type) throws InstanceNotFoundException
    Removes all the timer notifications corresponding to the specified type from the list of notifications.
 public  void setSendPastNotifications(boolean value)
    Sets the flag indicating whether the timer sends past notifications or not.
 public  void start()
    Starts the timer.

    If there is one or more timer notifications before the time in the list of notifications, the notification is sent according to the sendPastNotifications flag and then, updated according to its period and remaining number of occurrences. If the timer notification date remains earlier than the current date, this notification is just removed from the list of notifications.

 public  void stop()
    Stops the timer.