Package jmri.jmris

Class AbstractOperationsServer

java.lang.Object

jmri.jmris.AbstractOperationsServer

All Implemented Interfaces:

PropertyChangeListener, EventListener

Direct Known Subclasses:

SimpleOperationsServer

public abstract class AbstractOperationsServer
extends Object
implements PropertyChangeListener

Abstract interface between the JMRI operations and a network connection

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	AbstractOperationsServer.TrainListener

Field Summary

Fields

Modifier and Type	Field	Description
protected final LocationManager	lm
protected final TrainManager	tm
protected final HashMap<String,AbstractOperationsServer.TrainListener>	trains

Constructor Summary

Constructors

Constructor	Description
AbstractOperationsServer()

Method Summary

Modifier and Type	Method	Description
protected void	addTrainToList(String trainId)
String	constructTrainCaboose(String trainName)	constructs a String containing the caboose on a train
String	constructTrainLeadLoco(String trainName)	Constructs a String containing the road and number of lead loco, if there's one assigned to the train.
String	constructTrainLength(String trainName)	constructs a String containing the length of a train
String	constructTrainLocation(String trainName)	constructs a String containing the location of a train
String	constructTrainNumberOfCars(String trainName)	constructs a String containing the number of cars in a train
String	constructTrainStatus(String trainName)	constructs a String containing the status of a train
String	constructTrainWeight(String trainName)	constructs a String containing the tonnage of a train
void	dispose()
protected AbstractOperationsServer.TrainListener	getListener(String trainId)
static boolean	isExactLoationNameEnabled()
abstract void	parseStatus(String statusString)
abstract void	propertyChange(PropertyChangeEvent e)
protected void	removeTrainFromList(String trainId)
abstract void	sendErrorStatus(String errorStatus)
abstract void	sendFullStatus(Train train)	sends the full status for a train to a client
abstract void	sendLocationList()
abstract void	sendMessage(ArrayList<Attribute> contents)
abstract void	sendTrainList()
static void	setExactLocationName(boolean enabled)
String	setTrainLocation(String trainName, String locationName)	constructs a String containing the location of a train
String	terminateTrain(String trainName)	tells Operations that a train has terminated.

Methods inherited from class java.lang.Object

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

Field Details

tm

protected final TrainManager tm

lm

protected final LocationManager lm

trains

protected final HashMap<String,AbstractOperationsServer.TrainListener> trains

Constructor Details

AbstractOperationsServer

public AbstractOperationsServer()

Method Details

sendTrainList

public abstract void sendTrainList()

sendLocationList

public abstract void sendLocationList()

constructTrainStatus

public String constructTrainStatus(String trainName)
                            throws IOException

constructs a String containing the status of a train

Parameters:

trainName - is the name of the train. If not found in Operations, an error message is sent to the client.

Returns:

the train's status as known by Operations

Throws:

IOException - on failure to send an error message to the client

constructTrainLocation

public String constructTrainLocation(String trainName)
                              throws IOException

constructs a String containing the location of a train

Parameters:

trainName - is the name of the desired train. If not found in Operations, an error message is sent to the client

Returns:

the train's location, as known by Operations

Throws:

IOException - on failure to send an error message to the client

setTrainLocation

public String setTrainLocation(String trainName,
 String locationName)
                        throws IOException

constructs a String containing the location of a train

Parameters:

trainName - is the name of the desired train. If not found in Operations, an error message is sent to the client

locationName - is the name of the desired location.

Returns:

the train's location, as known by Operations

Throws:

IOException - on failure to send an error message to the client

setExactLocationName

public static void setExactLocationName(boolean enabled)

isExactLoationNameEnabled

public static boolean isExactLoationNameEnabled()

constructTrainLength

public String constructTrainLength(String trainName)
                            throws IOException

constructs a String containing the length of a train

Parameters:

trainName - is the name of the desired train. If not found in Operations, an error message is sent to the client

Returns:

the train's length, as known by Operations

Throws:

IOException - on failure to send an error message to the client

constructTrainWeight

public String constructTrainWeight(String trainName)
                            throws IOException

constructs a String containing the tonnage of a train

Parameters:

trainName - is the name of the desired train. If not found in Operations, an error message is sent to the client

Returns:

the train's tonnage, as known by Operations

Throws:

IOException - on failure to send an error message to the client

constructTrainNumberOfCars

public String constructTrainNumberOfCars(String trainName)
                                  throws IOException

constructs a String containing the number of cars in a train

Parameters:

trainName - is the name of the desired train. If not found in Operations, an error message is sent to the client

Returns:

the number of cars in a train, as known by Operations

Throws:

IOException - on failure to send an error message to the client

constructTrainLeadLoco

public String constructTrainLeadLoco(String trainName)
                              throws IOException

Constructs a String containing the road and number of lead loco, if there's one assigned to the train.

Parameters:

trainName - is the name of the desired train. If not found in Operations, an error message is sent to the client

Returns:

the lead loco

Throws:

IOException - on failure to send an error message to the client

constructTrainCaboose

public String constructTrainCaboose(String trainName)
                             throws IOException

constructs a String containing the caboose on a train

Parameters:

trainName - is the name of the desired train. If not found in Operations, an error message is sent to the client

Returns:

the caboose on a train, as known by Operations

Throws:

IOException - on failure to send an error message to the client

terminateTrain

public String terminateTrain(String trainName)
                      throws IOException

tells Operations that a train has terminated. If not found in Operations, an error message is sent to the client

Parameters:

trainName - is the name of the train

Returns:

the termination String

Throws:

IOException - on failure to send an error message to the client

sendFullStatus

public abstract void sendFullStatus(Train train)
                             throws IOException

sends the full status for a train to a client

Parameters:

train - is the Train object we are sending information about.

Throws:

IOException - on failure to send an error message

propertyChange

public abstract void propertyChange(PropertyChangeEvent e)

Specified by:

propertyChange in interface PropertyChangeListener

addTrainToList

protected void addTrainToList(String trainId)

removeTrainFromList

protected void removeTrainFromList(String trainId)

getListener

protected AbstractOperationsServer.TrainListener getListener(String trainId)

dispose

public void dispose()

sendMessage

public abstract void sendMessage(ArrayList<Attribute> contents)
                          throws IOException

Throws:

IOException

sendErrorStatus

public abstract void sendErrorStatus(String errorStatus)
                              throws IOException

Throws:

IOException

parseStatus

public abstract void parseStatus(String statusString)
                          throws JmriException,
IOException

Throws:

JmriException

IOException