util.rmi
Interface RmiCaster

All Superinterfaces:

Remote

All Known Subinterfaces:

RemoteFitsParameter, RemoteLight, RemoteParameter, RemoteSwitch, RemoteTrigger, RmiAcknowledgeCaster, RmiCommandCaster, RmiDataCaster, RmiDataDepositing, RmiDoneCaster, RmiErrorCaster, RmiLogCaster, RmiSerialCaster, RmiWeatherCaster, RmiWeatherReporting, URLCaster

All Known Implementing Classes:

AbstractCCDParameter, AbstractCCDValue, AbstractCommandLauncher, AbstractFitsParameter, AbstractFitsValue, AbstractRemoteParameter, AbstractRemoteSwitch, AbstractRemoteTrigger, AbstractRemoteValue, AbstractRmiCaster, AbstractRmiCasterAndListener, AbstractRmiDataSink, AbstractSensor, AbstractSequencer, AbstractWeatherSurveyor, AdapterCaster, AdapterMaster, AdapterSimulator, AdapterTelescopeCaster, AuxiliaryCaster, AuxiliaryMaster, AverageSensor, BadSensor, CalibrationCaster, CalibrationMaster, CalibrationSimulator, CasterClient, CasterTorso, CastingContainer, CastingRS485Server, CCDCaster, CCDLn2Temp, CCDRefTemp, CCDTemp, CommandReceiver, CumulativeSensor, DataSensor, DerivativeSensor, DeviceSimulator, DewPoint, DistinctCaster, DomeMaster, DomeSimulator, DummyRS485, DummySequencer, Efficiency, EnvironmentCaster, EnvironmentMaster, EnvironmentSimulator, ErrorReceiver, ErrorServer, ExposureCount, FakeSensor, FakeSolZSensor, FitsMoments, GenericMaster, GenericMaster.Standalone, GenericSimulator, HeadPressure, HealthSensor, JDataSink, JFrameParameter, JObjectDisplay.SubComponentHandler, JPhasePlot, JRS485Simulator, KeystrokeSensor, LoopingSequencer, MasterLauncher, MasterMind, MoxaSensor, NoiseSolZSensor, OneWireADSensor, OneWireRainSensor, OneWireSensor, ParameterRelay, ParameterSensor, ParameterServer, ParameterSkeleton, PilarLauncher, PilarTelescopeCaster, PollingRS485Server, PredictiveSensor, QuickDumpSensor, ReceiverServer, ReceiverTorso, RemoteLogServer, RoofTrigger, RS485RainSensor, RS485Sensor, SensorRepository, SesMaster, SesSimulator, ShelterMaster, ShelterTrigger, SignalToNoise, SimpleRemoteSwitch, SimpleRemoteTrigger, SimpleRemoteValue, SimulatorSequencer, SimulatorWeather, SmoothingSensor, SolHeightSensor, SolZSensor, SpectrographCaster, SubComponentNotify, SwitchRelay, SwitchSkeleton, TelescopeAuxiliaryCaster, TelescopeCaster, TelescopeClient, TelescopeMaster, TelescopeSimulator, TestCaster, TestCaster, TestReceiver, TestReceiver, TimerTaskSensor, TriggerSkeleton, Unique, Ups, UpsSensor, WatchdogRS485Server, WeatherRemainsBad, WeatherSensor, WeatherStation, WeatherTrigger, WeirdSolZSensor, WifsipCaster, WifsipMaster, WifsipSimulator, WifsipTelescopeCaster, XMLSequencer

public interface RmiCaster
extends Remote

The generic interface all rmi-enabled casters should extend. It defines the method isValid() which should immediately return true. It is designed for the listener side to allow it to test if the caster it listenes to is still a valid reference. Normally, implementing classes will also iomplement the Caster interface.

Method Summary

boolean	bindToRegistry() Iniates binding of this caster to the registry.
boolean	isValid() A handle for the listener to test if the reference to the caster it is listening to is still valid.
boolean	unbindFromRegistry() Unbinds the caster from the registry.

Method Detail

isValid

boolean isValid()
                throws RemoteException

A handle for the listener to test if the reference to the caster it is listening to is still valid. During its entrie lifetime, a listener should regularly call this method to test if the caster it is listening to is still connected. If the caster has ceased existance a call to this method will cause a remote exception to be thrown. The listener catches this exception and re-tries to register to the caster.

Throws:

RemoteException

bindToRegistry

boolean bindToRegistry()
                       throws RemoteException

Iniates binding of this caster to the registry. The cater always knows its binding name.

Returns:

True if successful.

Throws:

RemoteException

unbindFromRegistry

boolean unbindFromRegistry()
                           throws RemoteException

Unbinds the caster from the registry. Normally called during clean-up process, i.e. if the caster is also ExitCleaning

Returns:

True if successful.

Throws:

RemoteException