FileDocCategorySizeDatePackage
NotificationBuffer.javaAPI DocJava SE 5 API2445Fri Aug 26 14:55:00 BST 2005com.sun.jmx.remote.internal

NotificationBuffer

public interface NotificationBuffer
A buffer of notifications received from an MBean server.

Fields Summary
Constructors Summary
Methods Summary
public voiddispose()

Discard this buffer.

public javax.management.remote.NotificationResultfetchNotifications(java.util.Set listeners, long startSequenceNumber, long timeout, int maxNotifications)

Fetch notifications that match the given listeners.

The operation only considers notifications with a sequence number at least startSequenceNumber. It will take no longer than timeout, and will return no more than maxNotifications different notifications.

If there are no notifications matching the criteria, the operation will block until one arrives, subject to the timeout.

param
listeners a Set of {@link ListenerInfo} that reflects the filters to be applied to notifications. Accesses to this Set are synchronized on the Set object. The Set is consulted for selected notifications that are present when the method starts, and for selected notifications that arrive while it is executing. The contents of the Set can be modified, with appropriate synchronization, while the method is running.
param
startSequenceNumber the first sequence number to consider.
param
timeout the maximum time to wait. May be 0 to indicate not to wait if there are no notifications.
param
maxNotifications the maximum number of notifications to return. May be 0 to indicate a wait for eligible notifications that will return a usable nextSequenceNumber. The {@link TargetedNotification} array in the returned {@link NotificationResult} may contain more than this number of elements but will not contain more than this number of different notifications.