org.transitime.ipc.rmi

Class AbstractServer

java.lang.Object

org.transitime.ipc.rmi.AbstractServer

Direct Known Subclasses:

CommandsServer, ConfigServer, HelloServer, PredictionsServer, ServerStatusServer, VehiclesServer

public abstract class AbstractServer
extends java.lang.Object

This class does all of the work on the server side for an RMI object. A server side RMI object should inherit/extend this class. The constructor automatically registers the RMI server object with the registry. It also periodically rebinds the object every 30 seconds so that if the rmiregistry gets restarted the RMI object will then automatically become available again. Sends an e-mail alert when rebinding if the rmiregistry is not available.

Once a AbstractServer superclass object is created it will continue to exist.

AbstractServer configures RMI to not use port 0, basically a random port, when establishing secondary communication. Instead, RMI is configured to use port 2098. In this way the firewalls for the servers can be configured to only allow traffic on the two ports 2099 & 2098 for RMI. If there are multiple systems running on a single server then need to use a separate secondary port for each system (such as 2097, 2096, etc). Using a specific port for secondary communication is much safer than having to completely open up network traffic.

If another agency is already using the secondary RMI port on the server then will get an exception and e-mail notification is sent out.

Author:

SkiBu Smith

Method Summary

Modifier and Type	Method and Description
java.lang.String	getAgencyId()
static java.lang.String	getBindName(java.lang.String agencyId, java.lang.String className) The name that the server object is bound to needs both the classname to identify the object but also the agencyId since multiple projects can be running on a machine that uses a single RMI registry.
boolean	isConstructed() Specifies if this object was successfully constructed and is ready for use.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getBindName

public static java.lang.String getBindName(java.lang.String agencyId,
                                           java.lang.String className)

The name that the server object is bound to needs both the classname to identify the object but also the agencyId since multiple projects can be running on a machine that uses a single RMI registry.

Parameters:

agencyId -

className -

Returns:

getAgencyId

public java.lang.String getAgencyId()

isConstructed

public boolean isConstructed()

Specifies if this object was successfully constructed and is ready for use.

Returns: