mobi.mtld.da.datafile

Class DataFileManager

java.lang.Object

mobi.mtld.da.datafile.DataFileManager

public class DataFileManager
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
DataFileManager(DeviceAtlasApi deviceAtlasApi, DataFile dataFile)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getDownloadedDataFilePath() If the temporary data file exists on the system return the temporary file path.
void	persistDataFile() The data file is downloaded into a temporary file.
void	scheduleDownloadAndReloadTask() Schedule a task to download the data file and load it into the API.

Methods inherited from class java.lang.Object

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

Constructor Detail

DataFileManager

public DataFileManager(DeviceAtlasApi deviceAtlasApi,
                       DataFile dataFile)

Method Detail

getDownloadedDataFilePath

public java.lang.String getDownloadedDataFilePath()
                                           throws DataFileException

If the temporary data file exists on the system return the temporary file path. If the data file exists return the file path. If the data file does not exist download it and return the temporary path the data file was saved to.

Returns:

Throws:

DataFileException

persistDataFile

public void persistDataFile()
                     throws DataFileException

The data file is downloaded into a temporary file. After the temporary file has been loaded by the API without exception this method will replace the existing data file with the temporary file.

Throws:

DataFileException

scheduleDownloadAndReloadTask

public void scheduleDownloadAndReloadTask()

Schedule a task to download the data file and load it into the API. This is ignored if the data file config has disabled scheduling of the data file download and load. If the current data file on the system is stale the task is scheduled to run immediately. If the current data file on the system is not stale then the task is scheduled to run in the configured days in the future. Note: If the user has configured the download/load task to run at a specific time then this will be honoured even if the file is stale.