Package jmri.jmrit.operations

Class OperationsXml

java.lang.Object

jmri.jmrit.XmlFile

jmri.jmrit.operations.OperationsXml

Direct Known Subclasses:

CarManagerXml, EngineManagerXml, LocationManagerXml, OperationsSetupXml, RouteManagerXml, TrainManagerXml

public abstract class OperationsXml
extends XmlFile

Loads and stores the operation setup using xml files.

Nested Class Summary

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

XmlFile.Validate

Field Summary

Fields inherited from class jmri.jmrit.XmlFile

dtdLocation, xsltLocation

Constructor Summary

Constructors

Constructor	Description
OperationsXml()

Method Summary

Modifier and Type	Method	Description
static boolean	areFilesDirty()	Checks to see if any operations files are dirty
static boolean	checkFileName(String name)	Checks name for the file control characters:
protected File	createFile(String fullPathName, boolean backupFile)
String	getDefaultOperationsFilename()
static String	getFileLocation()	Absolute path to location of Operations files.
static String	getOperationsDirectoryName()
String	getOperationsFileName()
boolean	isDirty()
protected void	load()
abstract void	readFile(String filename)
static void	save()	Saves operation files that have been modified.
void	setDirty(boolean b)
static void	setFileLocation(String location)	Set path to location of Operations files.
static void	setOperationsDirectoryName(String name)
void	setOperationsFileName(String name)
protected void	writeFile(String filename)
void	writeFileIfDirty()
void	writeOperationsFile()	Store the all of the operation train objects in the default place, including making a backup if needed

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

Constructor Details

OperationsXml

public OperationsXml()

Method Details

writeOperationsFile

public void writeOperationsFile()

Store the all of the operation train objects in the default place, including making a backup if needed

load

protected void load()

createFile

protected File createFile(String fullPathName,
 boolean backupFile)

writeFile

protected void writeFile(String filename)
                  throws FileNotFoundException,
IOException

Throws:

FileNotFoundException

IOException

readFile

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

Parameters:

filename - The string file name.

Throws:

org.jdom2.JDOMException - Due to XML parsing error

IOException - Due to trouble accessing named file

setDirty

public void setDirty(boolean b)

isDirty

public boolean isDirty()

writeFileIfDirty

public void writeFileIfDirty()

getDefaultOperationsFilename

public String getDefaultOperationsFilename()

setOperationsDirectoryName

public static void setOperationsDirectoryName(String name)

getOperationsDirectoryName

public static String getOperationsDirectoryName()

setOperationsFileName

public void setOperationsFileName(String name)

getOperationsFileName

public String getOperationsFileName()

getFileLocation

public static String getFileLocation()

Absolute path to location of Operations files.

Default is in the user's files path, but can be set to anything.

Returns:

The string path name.

See Also:

• FileUtil.getUserFilesPath()

setFileLocation

public static void setFileLocation(String location)

Set path to location of Operations files.

Default is in the user's files path, but can be set to anything.

Parameters:

location - path to file, including trailing file separator.

checkFileName

public static boolean checkFileName(String name)

Checks name for the file control characters:

Parameters:

name - The string to check for a valid file name.

Returns:

true if name is okay, false if name contains a control character.

save

public static void save()

Saves operation files that have been modified.

areFilesDirty

public static boolean areFilesDirty()

Checks to see if any operations files are dirty

Returns:

True if any operations parameters have been modified.