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:

• Manage the lease for this registration.
• Obtain a RemoteEventListener reference that can be registered with event generators. This listener will then store any received events for this registration.
• Synchronously or asynchronously collect any event notifications stored by this particular registration.

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.