FileDocCategorySizeDatePackage
NotificationBuffer.javaAPI DocJava SE 6 API2141Tue Jun 10 00:22:04 BST 2008com.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(com.sun.jmx.remote.internal.NotificationBufferFilter filter, 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
filter an object that will add notifications to a {@code List} if they match the current listeners with their filters.
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.