net.jini.event

Interface EventMailbox

All Known Subinterfaces:

PullEventMailbox

public interface EventMailbox

The EventMailbox interface allows clients to specify and use a third party for the purpose of storing and retrieving events.

Since:

1.1

Author:

Sun Microsystems, Inc.

See Also:

MailboxRegistration

Method Summary

Modifier and Type	Method and Description
MailboxRegistration	register(long leaseDuration) Defines the interface to the event mailbox service.

Method Detail

register

MailboxRegistration register(long leaseDuration)
                      throws RemoteException,
                             LeaseDeniedException

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

Parameters:

leaseDuration - the requested lease duration in milliseconds

Returns:

A new MailboxRegistration

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.