stella

Class CastingContainer

java.lang.Object

util.PropertyContainer

util.PropertyResources

util.rmi.RmiPropertyContainer

util.rmi.AbstractRmiCaster

stella.CastingContainer

All Implemented Interfaces:

Cloneable, Remote, ExitCleaning, Initializable, PropertySupplying, ResourceSupplying, RmiCaster, RmiPropertyBearing

Direct Known Subclasses:

AbstractCommandLauncher, AbstractSequencer, MasterMind, ReceiverServer

public abstract class CastingContainer
extends AbstractRmiCaster
implements Initializable

Extends an rmi caster to act additionally as an error caster. Error casting is a very common feature of STELLA objects therefore adding an extension to a property container that can additionally act as an error caster is useful. Note that this class neither implements the ErrorCaster interface nor the RmiErrorCaster interface, though all of the required subroutines are present.

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private List	errlist The vector containing local error listeners.
private List	rmilist The vector containing rmi error listeners.

Fields inherited from class util.rmi.AbstractRmiCaster

ALTERNATEHOST, ALTERNATEPORT, KEY_BINDNAME, KEY_EXPORTPORT, KEY_REGISTRYHOST, KEY_REGISTRYPORT

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_MODTIME, POSTFIX_URL

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.ResourceSupplying

KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CastingContainer(Map prop)

Method Summary

Modifier and Type	Method and Description
void	addErrorListener(ErrorListener ear) Registers an error event listener to this property container.
void	addRmiErrorListener(RmiErrorListener ear) Registers a rmi error event listener to this property container.
void	exit() Exits by signaling to all listeners that they should deregister.
void	init()
boolean	isValid() The method for listeners to check if the remote reference is still valid.
protected void	notifyErrorListener(ErrorEvent ee, List local, List remote) Notifies all registered ErrorListeners.
void	removeErrorListener(ErrorListener ear) Deregisters an error event listener from this property container.
void	removeRmiErrorListener(RmiErrorListener ear) Deregisters an rmi error event listener from this property container.
void	sendError(ErrorEvent ee) Sends the error message directly.
void	sendError(String mess) Wraps the argumental String into an error message and passes it to the error listeners.
void	sendError(Throwable thrown) Wraps the argumental THrowable into an error message and passes it to the error listeners.
void	sendStatus(ErrorEvent ee) Sends the status event back to registered listeners.
void	sendStatus(List stati) Processes an entire list of status messages that should be sent to the error listeners.
void	sendStatus(String mess) Wraps the argumental String into an error message and passes it to the error listeners.

Methods inherited from class util.rmi.AbstractRmiCaster

bindToRegistry, bindToRegistry, bindToRegistry, bindToRegistry, bindToRegistry, bindToRegistry, casterExit, casterExit, getBindName, getBindName, unbindFromRegistry, unbindFromRegistry

Methods inherited from class util.rmi.RmiPropertyContainer

containsRemoteProperty, getRemoteProperties, getRemoteProperty, setRemoteProperty

Methods inherited from class util.PropertyResources

clone, createFrom, createFrom, createFrom, createInstance, getApplet, getAsResources, getLocate, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, hasLocalURLs, initProperties, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

augment, augment, augment, augment, augment, defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsEnums, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, isNew, parseObject, parseObject, reload, removeProperty, requires, rescanned, setObject, setProperties, setProperty, stringProperties, toString

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface util.PropertySupplying

defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

Field Detail

errlist

private final List errlist

The vector containing local error listeners.

rmilist

private final List rmilist

The vector containing rmi error listeners.

Constructor Detail

CastingContainer

protected CastingContainer(Map prop)

Method Detail

exit

public void exit()

Exits by signaling to all listeners that they should deregister.

Specified by:

exit in interface ExitCleaning

Overrides:

exit in class AbstractRmiCaster

init

public void init()

Specified by:

init in interface Initializable

addErrorListener

public void addErrorListener(ErrorListener ear)

Registers an error event listener to this property container. This method is used for local listeners.

removeErrorListener

public void removeErrorListener(ErrorListener ear)

Deregisters an error event listener from this property container. This method is used for local listeners.

addRmiErrorListener

public void addRmiErrorListener(RmiErrorListener ear)
                         throws RemoteException

Registers a rmi error event listener to this property container. This method is used for non-local listeners running in a different VM.

Throws:

RemoteException

removeRmiErrorListener

public void removeRmiErrorListener(RmiErrorListener ear)
                            throws RemoteException

Deregisters an rmi error event listener from this property container. This method is used for non-local listeners running in a different VM.

Throws:

RemoteException

isValid

public boolean isValid()
                throws RemoteException

The method for listeners to check if the remote reference is still valid. Needed for rmi error-caster abilities. Returns true.

Specified by:

isValid in interface RmiCaster

Overrides:

isValid in class AbstractRmiCaster

Throws:

RemoteException

sendError

public void sendError(Throwable thrown)

Wraps the argumental THrowable into an error message and passes it to the error listeners.

sendError

public void sendError(String mess)

Wraps the argumental String into an error message and passes it to the error listeners.

sendError

public void sendError(ErrorEvent ee)

Sends the error message directly.

sendStatus

public void sendStatus(String mess)

Wraps the argumental String into an error message and passes it to the error listeners.

sendStatus

public void sendStatus(List stati)

Processes an entire list of status messages that should be sent to the error listeners.

sendStatus

public void sendStatus(ErrorEvent ee)

Sends the status event back to registered listeners. This method should be called within concrete implementations of the ReceiverTorso.processCommand(stella.CommandEvent, int) method.
Note that from the event type there is no difference between a status and an error event. This method therefore simply passes the argument to this classes notifyErrorListener(stella.ErrorEvent, java.util.List, java.util.List) method.

notifyErrorListener

protected void notifyErrorListener(ErrorEvent ee,
                                   List local,
                                   List remote)

Notifies all registered ErrorListeners. This method parses through the Vector of ErrorListeners and passes the argument to their errorOccured method. Registered listeners are local.

Parameters:

ee - The ErrorEvent to pass to the Listeners.