casa.JION.event
Class RemoteEventListener

java.lang.Object
  extended by 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.

Constructor Summary
RemoteEventListener()
           
 
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
 

Constructor Detail

RemoteEventListener

public RemoteEventListener()
Method Detail

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