Spec-Zone .ru
спецификации, руководства, описания, API
Please note that the specifications and other information contained herein are not final and are subject to change. The information is being made available to you solely for purpose of evaluation.

Java™ Platform
Standard Ed. 7

DRAFT ea-b118

javax.management.remote
Class NotificationResult

java.lang.Object
  extended by javax.management.remote.NotificationResult
All Implemented Interfaces:
Serializable

public class NotificationResult
extends Object
implements Serializable

Result of a query for buffered notifications. Notifications in a notification buffer have positive, monotonically increasing sequence numbers. The result of a notification query contains the following elements:

It is possible for the nextSequenceNumber to be less than the earliestSequenceNumber. This signifies that notifications between the two might have been lost.

Since:
1.5
See Also:
Serialized Form

Constructor Summary
Constructor and Description
NotificationResult(long earliestSequenceNumber, long nextSequenceNumber, TargetedNotification[] targetedNotifications)
          Constructs a notification query result.
 
Method Summary
Modifier and Type Method and Description
 long getEarliestSequenceNumber()
          Returns the sequence number of the earliest notification still in the buffer.
 long getNextSequenceNumber()
          Returns the sequence number of the next notification available for querying.
 TargetedNotification[] getTargetedNotifications()
          Returns the notifications resulting from the query, and the listeners they correspond to.
 String toString()
          Returns a string representation of the object.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

NotificationResult

public NotificationResult(long earliestSequenceNumber,
                          long nextSequenceNumber,
                          TargetedNotification[] targetedNotifications)

Constructs a notification query result.

Parameters:
earliestSequenceNumber - the sequence number of the earliest notification still in the buffer.
nextSequenceNumber - the sequence number of the next notification available for querying.
targetedNotifications - the notifications resulting from the query, and the listeners they correspond to. This array can be empty.
Throws:
IllegalArgumentException - if targetedNotifications is null or if earliestSequenceNumber or nextSequenceNumber is negative.
Method Detail

getEarliestSequenceNumber

public long getEarliestSequenceNumber()
Returns the sequence number of the earliest notification still in the buffer.

Returns:
the sequence number of the earliest notification still in the buffer.

getNextSequenceNumber

public long getNextSequenceNumber()
Returns the sequence number of the next notification available for querying.

Returns:
the sequence number of the next notification available for querying.

getTargetedNotifications

public TargetedNotification[] getTargetedNotifications()
Returns the notifications resulting from the query, and the listeners they correspond to.

Returns:
the notifications resulting from the query, and the listeners they correspond to. This array can be empty.

toString

public String toString()
Returns a string representation of the object. The result should be a concise but informative representation that is easy for a person to read.

Overrides:
toString in class Object
Returns:
a string representation of the object.

Java™ Platform
Standard Ed. 7

DRAFT ea-b118

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2010, Oracle Corporation. All rights reserved.
DRAFT ea-b118

Scripting on this page tracks web page traffic, but does not change the content in any way.