public interface RemoteEventListener extends Remote, EventListener
The object implementing this interface does not need to be the object that originally registered interest in the occurrence of an event. To allow the notification of an event's occurrence to be sent to an entity other than the one that made the interest registration, the registration call needs to accept a destination parameter, which indicates the object to which the notification should be sent. This parameter must be an object which supports the RemoteEventListener interface.
Modifier and Type | Method and Description |
---|---|
void |
notify(RemoteEvent theEvent)
Notify the listener about an event.
|
void notify(RemoteEvent theEvent) throws UnknownEventException, RemoteException
The call to notify is synchronous to allow the party making the call to know if the call succeeded. However, it is not part of the semantics of the call that the notification return can be delayed while the recipient of the call reacts to the occurrence of the event. Simply put, the best strategy on the part of the recipient is to note the occurrence in some way and then return from the notify method as quickly as possible.
UnknownEventException is thrown when the recipient does not recognize the combination of the event identifier and the event source as something in which it is interested. Throwing this exception has the effect of asking the sender to not send further notifications of this kind of event from this source in the future.
theEvent
- the remote event that occurredUnknownEventException
- the recipient does not recognize the
combination of event identifier and event sourceRemoteException
- if a connection problem occurs.Copyright 2007-2013, multiple authors.
Licensed under the Apache License, Version 2.0, see the NOTICE file for attributions.