Package jmri.jmrit.operations.trains

Class TrainManagerXml

java.lang.Object

jmri.jmrit.XmlFile

jmri.jmrit.operations.OperationsXml

jmri.jmrit.operations.trains.TrainManagerXml

All Implemented Interfaces:

InstanceManagerAutoDefault, InstanceManagerAutoInitialize

public class TrainManagerXml
extends OperationsXml
implements InstanceManagerAutoDefault, InstanceManagerAutoInitialize

Loads and stores trains using xml files. Also stores various train parameters managed by the TrainManager.

Nested Class Summary

Nested classes/interfaces inherited from class jmri.jmrit.XmlFile

XmlFile.Validate

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final String	BUILD_STATUS
(package private) static final String	BUILD_STATUS_BACKUPS
static final String	CSV_MANIFESTS
static final String	CSV_SWITCH_LISTS
(package private) static final String	JSON_MANIFESTS
(package private) static final String	MANIFESTS
(package private) static final String	MANIFESTS_BACKUPS
(package private) static final String	SWITCH_LISTS
(package private) static final String	SWITCH_LISTS_BACKUPS

Fields inherited from class jmri.jmrit.XmlFile

dtdLocation, xsltLocation

Constructor Summary

Constructors

Constructor	Description
TrainManagerXml()

Method Summary

Modifier and Type	Method	Description
File	createCsvSwitchListFile(String name)	Store the CSV switch list for a location
void	createDefaultCsvManifestDirectory()
void	createDefaultCsvSwitchListDirectory()
File	createManifestFile(String name, String ext)	Store the Json manifest for a train
File	createSwitchListFile(String name)	Store the switch list for a location
File	createTrainBuildReportFile(String name)	Store the train's build report
File	createTrainCsvManifestFile(String name)	Store the CSV train manifest
File	createTrainManifestFile(String name)	Creates the train's manifest file.
String	defaultBuildReportFileName(String name)
void	dispose()
String	getBackupBuildStatusDirectoryName()
String	getBackupBuildStatusDirectoryName(String name)
String	getBackupBuildStatusFileName(String name, String lastModified)
String	getBackupManifestDirectoryName()
String	getBackupManifestDirectoryName(String name)
String	getBackupManifestFileName(String name, String lastModified)
String	getBackupSwitchListDirectoryName()
String	getBackupSwitchListDirectoryName(String name)
String	getBackupSwitchListFileName(String name, String lastModified)
File	getCsvSwitchListFile(String name)
String	getDefaultCsvManifestFileName(String name)
String	getDefaultCsvSwitchListDirectoryName()
String	getDefaultCsvSwitchListFileName(String name)
String	getDefaultManifestFileName(String name)
String	getDefaultSwitchListName(String name)
File	getManifestFile(String name, String ext)
String	getOperationsFileName()
File	getSwitchListFile(String name)
File	getTrainBuildReportFile(String name)
File	getTrainCsvManifestFile(String name)
File	getTrainManifestFile(String name)
void	initialize()	Perform any initialization that occurs after this object has been constructed and made available by the InstanceManager.
boolean	isTrainFileLoaded()
void	readFile(String name)	Read the contents of a roster XML file into this object.
void	savePreviousBuildStatusFile(String name)	Save previous train build status file in a separate directory called BuildStatusBackups.
void	setOperationsFileName(String name)
void	writeFile(String name)

Methods inherited from class jmri.jmrit.operations.OperationsXml

areFilesDirty, checkFileName, createFile, getDefaultOperationsFilename, getFileLocation, getOperationsDirectoryName, isDirty, load, save, setDirty, setFileLocation, setOperationsDirectoryName, writeFileIfDirty, writeOperationsFile

Methods inherited from class jmri.jmrit.XmlFile

addDefaultInfo, backupFileName, checkFile, createFileNameWithDate, dumpElement, findFile, getBuilder, getDefaultDtdLocation, getDefaultValidate, getDtdLocation, getProcessingInstructionHRef, getProcessingInstructionType, getRoot, getValidate, makeBackupFile, makeBackupFile, newDocument, newDocument, revertBackupFile, rootFromFile, rootFromInputStream, rootFromName, rootFromURL, setDefaultDtdLocation, setDefaultValidate, setDtdLocation, setValidate, userFileChooser, userFileChooser, writeXML, xmlDir

Methods inherited from class java.lang.Object

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

Field Details

BUILD_STATUS

static final String BUILD_STATUS

See Also:

• Constant Field Values

MANIFESTS

static final String MANIFESTS

See Also:

• Constant Field Values

SWITCH_LISTS

static final String SWITCH_LISTS

See Also:

• Constant Field Values

CSV_MANIFESTS

public static final String CSV_MANIFESTS

See Also:

• Constant Field Values

CSV_SWITCH_LISTS

public static final String CSV_SWITCH_LISTS

See Also:

• Constant Field Values

JSON_MANIFESTS

static final String JSON_MANIFESTS

See Also:

• Constant Field Values

MANIFESTS_BACKUPS

static final String MANIFESTS_BACKUPS

See Also:

• Constant Field Values

SWITCH_LISTS_BACKUPS

static final String SWITCH_LISTS_BACKUPS

See Also:

• Constant Field Values

BUILD_STATUS_BACKUPS

static final String BUILD_STATUS_BACKUPS

See Also:

• Constant Field Values

Constructor Details

TrainManagerXml

public TrainManagerXml()

Method Details

writeFile

public void writeFile(String name)
               throws FileNotFoundException,
IOException

Overrides:

writeFile in class OperationsXml

Throws:

FileNotFoundException

IOException

readFile

public void readFile(String name)
              throws org.jdom2.JDOMException,
IOException

Read the contents of a roster XML file into this object. Note that this does not clear any existing entries.

Specified by:

readFile in class OperationsXml

Parameters:

name - The string file name.

Throws:

org.jdom2.JDOMException - Due to XML parsing error

IOException - Due to trouble accessing named file

isTrainFileLoaded

public boolean isTrainFileLoaded()

createTrainBuildReportFile

public File createTrainBuildReportFile(String name)

Store the train's build report

Parameters:

name - Full path name for train build report

Returns:

Build report File.

getTrainBuildReportFile

public File getTrainBuildReportFile(String name)

defaultBuildReportFileName

public String defaultBuildReportFileName(String name)

createTrainManifestFile

public File createTrainManifestFile(String name)

Creates the train's manifest file.

Parameters:

name - Full path name for manifest file.

Returns:

Manifest File.

getTrainManifestFile

public File getTrainManifestFile(String name)

getDefaultManifestFileName

public String getDefaultManifestFileName(String name)

getBackupManifestFileName

public String getBackupManifestFileName(String name,
 String lastModified)

getBackupManifestDirectoryName

public String getBackupManifestDirectoryName()

getBackupManifestDirectoryName

public String getBackupManifestDirectoryName(String name)

getBackupSwitchListFileName

public String getBackupSwitchListFileName(String name,
 String lastModified)

getBackupSwitchListDirectoryName

public String getBackupSwitchListDirectoryName()

getBackupSwitchListDirectoryName

public String getBackupSwitchListDirectoryName(String name)

getBackupBuildStatusFileName

public String getBackupBuildStatusFileName(String name,
 String lastModified)

getBackupBuildStatusDirectoryName

public String getBackupBuildStatusDirectoryName()

getBackupBuildStatusDirectoryName

public String getBackupBuildStatusDirectoryName(String name)

createTrainCsvManifestFile

public File createTrainCsvManifestFile(String name)

Store the CSV train manifest

Parameters:

name - Full path name to CSV train manifest file.

Returns:

Train CSV manifest File.

getTrainCsvManifestFile

public File getTrainCsvManifestFile(String name)

getDefaultCsvManifestFileName

public String getDefaultCsvManifestFileName(String name)

createDefaultCsvManifestDirectory

public void createDefaultCsvManifestDirectory()

createManifestFile

public File createManifestFile(String name,
 String ext)

Store the Json manifest for a train

Parameters:

name - file name

ext - file extension to use

Returns:

Json manifest File

getManifestFile

public File getManifestFile(String name,
 String ext)

createSwitchListFile

public File createSwitchListFile(String name)

Store the switch list for a location

Parameters:

name - The location's name, to become file name.

Returns:

Switch list File.

getSwitchListFile

public File getSwitchListFile(String name)

getDefaultSwitchListName

public String getDefaultSwitchListName(String name)

createCsvSwitchListFile

public File createCsvSwitchListFile(String name)

Store the CSV switch list for a location

Parameters:

name - Location's name, to become file name.

Returns:

CSV switch list File.

getCsvSwitchListFile

public File getCsvSwitchListFile(String name)

getDefaultCsvSwitchListFileName

public String getDefaultCsvSwitchListFileName(String name)

getDefaultCsvSwitchListDirectoryName

public String getDefaultCsvSwitchListDirectoryName()

createDefaultCsvSwitchListDirectory

public void createDefaultCsvSwitchListDirectory()

setOperationsFileName

public void setOperationsFileName(String name)

Overrides:

setOperationsFileName in class OperationsXml

getOperationsFileName

public String getOperationsFileName()

Overrides:

getOperationsFileName in class OperationsXml

savePreviousBuildStatusFile

public void savePreviousBuildStatusFile(String name)

Save previous train build status file in a separate directory called BuildStatusBackups. Each build status is saved in a unique directory using the train's name.

Parameters:

name - train's name

dispose

public void dispose()

initialize

public void initialize()

Description copied from interface: InstanceManagerAutoInitialize

Perform any initialization that occurs after this object has been constructed and made available by the InstanceManager.

Specified by:

initialize in interface InstanceManagerAutoInitialize