casa.JION.event
Class RemoteEventListener
java.lang.Object
casa.JION.event.RemoteEventListener
- All Implemented Interfaces:
- java.rmi.Remote, java.util.EventListener, net.jini.core.event.RemoteEventListener
public class RemoteEventListener
- extends java.lang.Object
- implements net.jini.core.event.RemoteEventListener
The RemoteEventListener interface needs to be implemented by any object
that wants to receive a notification of a remote event from some other
object.
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.
- Since:
- 1.0
- Author:
- Sun Microsystems, Inc.
Method Summary |
void |
notify(net.jini.core.event.RemoteEvent theEvent)
Notify the listener about an event. |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
RemoteEventListener
public RemoteEventListener()
notify
public void notify(net.jini.core.event.RemoteEvent theEvent)
throws net.jini.core.event.UnknownEventException,
java.rmi.RemoteException
- Notify the listener about an event.
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.
- Specified by:
notify
in interface net.jini.core.event.RemoteEventListener
- Parameters:
theEvent
- the remote event that occurred
- Throws:
net.jini.core.event.UnknownEventException
- the recipient does not recognize the
combination of event identifier and event source
java.rmi.RemoteException