net.jini.event
Interface PullEventMailbox

All Superinterfaces:

EventMailbox

public interface PullEventMailbox
extends EventMailbox

The PullEventMailbox interface allows clients to specify and use a third party for the purpose of storing and retrieving events. It extends EventMailbox by by adding the ability to synchronously retrieve events from the event mailbox service.

Since:

2.1

Author:

Sun Microsystems, Inc.

See Also:

MailboxRegistration

Method Summary

MailboxPullRegistration

pullRegister(long leaseDuration) Defines the interface to the event mailbox service.

Methods inherited from interface net.jini.event.EventMailbox

register

Method Detail

pullRegister

MailboxPullRegistration pullRegister(long leaseDuration)
                                     throws RemoteException,
                                            LeaseDeniedException

Defines the interface to the event mailbox service. Event mailbox clients utilize this service by invoking the pullRegister method to register themselves with the service.

Parameters:

leaseDuration - the requested lease duration in milliseconds

Returns:

A new MailboxPullRegistration

Throws:

IllegalArgumentException - if leaseDuration is not positive or Lease.ANY.

RemoteException - if there is a communication failure between the client and the service.

LeaseDeniedException - if the mailbox service is unable or unwilling to grant this registration request.