GigaSpaces XAP 9.1 API

net.jini.event
Interface MailboxPullRegistration

All Superinterfaces:
MailboxRegistration

public interface MailboxPullRegistration
extends MailboxRegistration

The MailboxPullRegistration defines the interface through which a client manages its registration and its notification processing. Event mailbox clients use this interface to:

Since:
2.1
Author:
Sun Microsystems, Inc.

Method Summary
 void addUnknownEvents(Collection unknownEvents)
          Adds the provided collection of unknown events to this registration.
 RemoteEventIterator getRemoteEvents()
          Retrieves stored notifications, if any.
 
Methods inherited from interface net.jini.event.MailboxRegistration
disableDelivery, enableDelivery, getLease, getListener
 

Method Detail

getRemoteEvents

RemoteEventIterator getRemoteEvents()
                                    throws RemoteException
Retrieves stored notifications, if any.

Returns:
A RemoteEventIterator that can be used to retrieve event notifications from the mailbox service.
Throws:
RemoteException - if there is a communication failure between the client and the service.

addUnknownEvents

void addUnknownEvents(Collection unknownEvents)
                      throws RemoteException
Adds the provided collection of unknown events to this registration. The mailbox will then propagate an UnknownEventException back to any event generator that attempts to deliver an event with an identifier-source combination held in a registration's unknown exception list.

Parameters:
unknownEvents - A Collection of unknown events to be associated with this registration.
Throws:
RemoteException - if there is a communication failure between the client and the service.

GigaSpaces XAP 9.1 API

Copyright © GigaSpaces.