Package jmri.jmrit.operations.routes

Class Route

java.lang.Object

jmri.beans.PropertyChangeSupport

jmri.jmrit.operations.routes.Route

All Implemented Interfaces:

PropertyChangeListener, EventListener, PropertyChangeFirer, PropertyChangeProvider

public class Route
extends PropertyChangeSupport
implements PropertyChangeListener

Represents a route on the layout

Field Summary

Fields

Modifier and Type	Field	Description
protected String	_comment
protected String	_id
protected int	_IdNumber
protected String	_name
protected Hashtable<String,RouteLocation>	_routeHashTable
protected int	_sequenceNum
static final String	DISPOSE
static final int	EAST
static final String	ERROR
static final String	LISTCHANGE_CHANGED_PROPERTY
static final String	NONE
static final int	NORTH
static final String	OKAY
static final String	ORPHAN
static final String	ROUTE_BLOCKING_CHANGED_PROPERTY
static final String	ROUTE_NAME_CHANGED_PROPERTY
static final String	ROUTE_STATUS_CHANGED_PROPERTY
static final int	SOUTH
static final int	START
static final String	TRAIN_BUILT
static final int	WEST

Fields inherited from class jmri.beans.PropertyChangeSupport

propertyChangeSupport

Constructor Summary

Constructors

Constructor	Description
Route(String id, String name)
Route(org.jdom2.Element e)	Construct this Entry from XML.

Method Summary

Modifier and Type	Method	Description
RouteLocation	addLocation(Location location)	Adds a location to the end of this route
RouteLocation	addLocation(Location location, int sequence)	Add a location at a specific place (sequence) in the route Allowable sequence numbers are 1 to max size of route. 1 = start of route, or Route.START
void	deleteLocation(RouteLocation rl)	Delete a RouteLocation
void	dispose()
RouteLocation	getBlockingLocationFrontOfTrain()
RouteLocation	getBlockingLocationRearOfTrain()
List<RouteLocation>	getBlockingOrder()
JComboBox<RouteLocation>	getComboBox()
String	getComment()
RouteLocation	getDepartsRouteLocation()	Get the first location in a route
String	getDepartureDirection()
String	getId()
RouteLocation	getLastLocationByName(String name)	Get location by name (gets last route location with name)
List<RouteLocation>	getLocationsBySequenceList()	Get a list of RouteLocations sorted by route order
String	getName()
RouteLocation	getNextRouteLocation(RouteLocation rl)	Gets the next route location in a route
RouteLocation	getRouteLocationById(String id)	Get a RouteLocation by id
RouteLocation	getRouteLocationBySequenceNumber(int sequence)	1st RouteLocation in a route starts at 1.
int	getRouteMaximumTrainLength()	Gets the longest train length specified in the route.
int	getRouteMinimumTrainLength()	Gets the shortest train length specified in the route.
String	getStatus()	Gets the status of the route: OKAY ORPHAN ERROR TRAIN_BUILT
RouteLocation	getTerminatesRouteLocation()	Get the last location in a route
boolean	isLocationNameInRoute(String name)	Used to determine if a "similar" location name is in the route.
void	moveLocationDown(RouteLocation rl)	Moves a RouteLocation later in the route.
void	moveLocationUp(RouteLocation rl)	Places a RouteLocation earlier in the route.
void	propertyChange(PropertyChangeEvent e)
void	register(RouteLocation rl)	Remember a NamedBean Object created outside the manager.
void	resetBlockingOrder()
void	setBlockingOrderDown(RouteLocation rl)
void	setBlockingOrderUp(RouteLocation rl)
void	setComment(String comment)
protected void	setDirtyAndFirePropertyChange(String p, Object old, Object n)
void	setName(String name)
int	size()
org.jdom2.Element	store()	Create an XML element to represent this Entry.
String	toString()
void	updateComboBox(JComboBox<RouteLocation> box)

Methods inherited from class jmri.beans.PropertyChangeSupport

addPropertyChangeListener, addPropertyChangeListener, fireIndexedPropertyChange, fireIndexedPropertyChange, fireIndexedPropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class java.lang.Object

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

Field Details

NONE

public static final String NONE

See Also:

• Constant Field Values

_id

protected String _id

_name

protected String _name

_comment

protected String _comment

_routeHashTable

protected Hashtable<String,RouteLocation> _routeHashTable

_IdNumber

protected int _IdNumber

_sequenceNum

protected int _sequenceNum

EAST

public static final int EAST

See Also:

• Constant Field Values

WEST

public static final int WEST

See Also:

• Constant Field Values

NORTH

public static final int NORTH

See Also:

• Constant Field Values

SOUTH

public static final int SOUTH

See Also:

• Constant Field Values

LISTCHANGE_CHANGED_PROPERTY

public static final String LISTCHANGE_CHANGED_PROPERTY

See Also:

• Constant Field Values

ROUTE_STATUS_CHANGED_PROPERTY

public static final String ROUTE_STATUS_CHANGED_PROPERTY

See Also:

• Constant Field Values

ROUTE_BLOCKING_CHANGED_PROPERTY

public static final String ROUTE_BLOCKING_CHANGED_PROPERTY

See Also:

• Constant Field Values

ROUTE_NAME_CHANGED_PROPERTY

public static final String ROUTE_NAME_CHANGED_PROPERTY

See Also:

• Constant Field Values

DISPOSE

public static final String DISPOSE

See Also:

• Constant Field Values

OKAY

public static final String OKAY

TRAIN_BUILT

public static final String TRAIN_BUILT

ORPHAN

public static final String ORPHAN

ERROR

public static final String ERROR

START

public static final int START

See Also:

• Constant Field Values

Constructor Details

Route

public Route(String id,
 String name)

Route

public Route(org.jdom2.Element e)

Construct this Entry from XML. This member has to remain synchronized with the detailed DTD in operations-config.xml

Parameters:

e - Consist XML element

Method Details

getId

public String getId()

setName

public void setName(String name)

toString

public String toString()

Overrides:

toString in class Object

getName

public String getName()

setComment

public void setComment(String comment)

getComment

public String getComment()

dispose

public void dispose()

addLocation

public RouteLocation addLocation(Location location)

Adds a location to the end of this route

Parameters:

location - The Location.

Returns:

RouteLocation created for the location added

addLocation

public RouteLocation addLocation(Location location,
 int sequence)

Add a location at a specific place (sequence) in the route Allowable sequence numbers are 1 to max size of route. 1 = start of route, or Route.START

Parameters:

location - The Location to add.

sequence - Where in the route to add the location.

Returns:

route location

register

public void register(RouteLocation rl)

Remember a NamedBean Object created outside the manager.

Parameters:

rl - The RouteLocation to add to this route.

deleteLocation

public void deleteLocation(RouteLocation rl)

Delete a RouteLocation

Parameters:

rl - The RouteLocation to remove from the route.

size

public int size()

getDepartsRouteLocation

public RouteLocation getDepartsRouteLocation()

Get the first location in a route

Returns:

the first route location

getDepartureDirection

public String getDepartureDirection()

getTerminatesRouteLocation

public RouteLocation getTerminatesRouteLocation()

Get the last location in a route

Returns:

the last route location

getNextRouteLocation

public RouteLocation getNextRouteLocation(RouteLocation rl)

Gets the next route location in a route

Parameters:

rl - the current route location

Returns:

the next route location, null if rl is the last location in a route.

getLastLocationByName

public RouteLocation getLastLocationByName(String name)

Get location by name (gets last route location with name)

Parameters:

name - The string location name.

Returns:

route location

isLocationNameInRoute

public boolean isLocationNameInRoute(String name)

Used to determine if a "similar" location name is in the route. Note that a similar name might not actually be part of the route.

Parameters:

name - the name of the location

Returns:

true if a "similar" name was found

getRouteLocationById

public RouteLocation getRouteLocationById(String id)

Get a RouteLocation by id

Parameters:

id - The string id.

Returns:

route location

getLocationsBySequenceList

public List<RouteLocation> getLocationsBySequenceList()

Get a list of RouteLocations sorted by route order

Returns:

list of RouteLocations ordered by sequence

getBlockingOrder

public List<RouteLocation> getBlockingOrder()

getBlockingLocationFrontOfTrain

public RouteLocation getBlockingLocationFrontOfTrain()

getBlockingLocationRearOfTrain

public RouteLocation getBlockingLocationRearOfTrain()

setBlockingOrderUp

public void setBlockingOrderUp(RouteLocation rl)

setBlockingOrderDown

public void setBlockingOrderDown(RouteLocation rl)

resetBlockingOrder

public void resetBlockingOrder()

moveLocationUp

public void moveLocationUp(RouteLocation rl)

Places a RouteLocation earlier in the route.

Parameters:

rl - The RouteLocation to move.

moveLocationDown

public void moveLocationDown(RouteLocation rl)

Moves a RouteLocation later in the route.

Parameters:

rl - The RouteLocation to move.

getRouteLocationBySequenceNumber

public RouteLocation getRouteLocationBySequenceNumber(int sequence)

1st RouteLocation in a route starts at 1.

Parameters:

sequence - selects which RouteLocation is to be returned

Returns:

RouteLocation selected

getStatus

public String getStatus()

Gets the status of the route: OKAY ORPHAN ERROR TRAIN_BUILT

Returns:

string with status of route.

getRouteMinimumTrainLength

public int getRouteMinimumTrainLength()

Gets the shortest train length specified in the route.

Returns:

the minimum scale train length for this route.

getRouteMaximumTrainLength

public int getRouteMaximumTrainLength()

Gets the longest train length specified in the route.

Returns:

the maximum scale train length for this route.

getComboBox

public JComboBox<RouteLocation> getComboBox()

updateComboBox

public void updateComboBox(JComboBox<RouteLocation> box)

store

public org.jdom2.Element store()

Create an XML element to represent this Entry. This member has to remain synchronized with the detailed DTD in operations-config.xml.

Returns:

Contents in a JDOM Element

propertyChange

public void propertyChange(PropertyChangeEvent e)

Specified by:

propertyChange in interface PropertyChangeListener

setDirtyAndFirePropertyChange

protected void setDirtyAndFirePropertyChange(String p,
 Object old,
 Object n)