util.rmi
Interface RmiListener

All Superinterfaces:

Remote

All Known Subinterfaces:

RmiAcknowledgeListener, RmiCommandListener, RmiDataListener, RmiDoneListener, RmiErrorListener, RmiEventListener, RmiSerialListener, RmiUpdateListener, RmiWeatherListener, URLListener

All Known Implementing Classes:

AbstractErrorHandler, AbstractRmiCasterAndListener, AbstractRmiListener, AdapterCaster, AdapterMaster, AdapterSimulator, ApplicationJoiner, AuxiliaryCaster, AuxiliaryMaster, AuxiliarySimulator, CalibrationCaster, CalibrationMaster, CalibrationSimulator, CasterTorso, CCDCaster, DailyDump, DailyDumpRepository, DatabaseNow, DeviceSimulator, DistinctCaster, DomeMaster, DomeSimulator, EnvironmentCaster, EnvironmentMaster, EnvironmentSimulator, ErrorRelay, FieldSerializer, FileDump, FitsParameterStub, FitsRelay, FitsUpdateListener, GenericMaster, GenericMaster.Standalone, GenericSimulator, GregorTelescopeCaster, JAdapter, JEnvironment, JImageURLButton, JImageURLButton.ImageListener, JLaunchBox, JMasterFrame, JMessageListener, JPointingGrabber, JSwitcherStub, MasterErrorHandler, MasterListener, MessageListener, MyRmiListener, ParameterStub, PilarTelescopeCaster, PointingGrabber, ReadoutRepository, ReceiverTorso, RmiSystemErrListener, RmiSystemOutListener, SesMaster, SesSimulator, ShelterMaster, SpectrographCaster, StatusSerializer, SwitchRelay, SwitchStub, TargetChangeListener, TelescopeAuxiliaryCaster, TelescopeCaster, TelescopeMaster, TelescopeSimulator, TestCaster, TestReceiver, TransferListener, TriggerStub, ValueStub, WifsipCaster, WifsipMaster, WifsipSimulator, WifsipTelescopeCaster

public interface RmiListener
extends Remote

This is the base interface each rmi-listener should extend. It provides two methods. isConnected() gives the caster the possibility to check if the reference it has to the remote listener is still valid. Note that this method is not as necessary as the appropriate RmiCaster.isValid() method because a caster will always recognize that the appropriate listener has crashed once it tries to submitt an event to it.

The disconnect(util.rmi.RmiCaster) method allows the caster to signal to the listener that the reference will get invalid.

Method Summary

void	disconnect(RmiCaster from) Signals that the caster will get invalid.
boolean	isConnected() A method for the caster to check connection.

Method Detail

isConnected

boolean isConnected()
                    throws RemoteException

A method for the caster to check connection. Should immedeately return true. If the connection is lost a remote exception will be thrown. The caster catches this exception and though realizes that the connection is lost.

Throws:

RemoteException

disconnect

void disconnect(RmiCaster from)
                throws RemoteException

Signals that the caster will get invalid. Listeners should remove from the caster using the appropriate remove method. The method should return as soon as the listener has removed itself.

Throws:

RemoteException