com.mbientlab.metawear.impl.platform

Interface IO

public interface IO

IO operations used by the API, must be implemented by the target platform to use the API.

Author:

Eric Tsai

Method Summary

Modifier and Type	Method and Description
Task<File>	downloadFileAsync(String srcUrl, String dest) Downloads a file from a URL and stores it locally on the device.
File	findDownloadedFile(String filename) Finds a downloaded file matching the name.
InputStream	localRetrieve(String key) Retrieves data saved locally to the device
void	localSave(String key, byte[] data) Save the data to the local device
void	logWarn(String tag, String message) Outputs a warn level message to the logger
void	logWarn(String tag, String message, Throwable tr) Outputs a warn level message to the logger with an exception or error associated with the message

Method Detail

localSave

void localSave(String key,
               byte[] data)
        throws IOException

Save the data to the local device

Parameters:

key - Key value identifying the data

data - Data to save

Throws:

IOException - If I/O error occurs

localRetrieve

InputStream localRetrieve(String key)
                   throws IOException

Retrieves data saved locally to the device

Parameters:

key - Key value identifying the data

Returns:

Stream to read the data

Throws:

IOException - If I/O error occurs

downloadFileAsync

Task<File> downloadFileAsync(String srcUrl,
                             String dest)

Downloads a file from a URL and stores it locally on the device. When downloaded, the file can be later retrieved using findDownloadedFile(String).

Parameters:

srcUrl - URL to retrieve the file from

dest - Where to store the downloaded file

Returns:

Task holding the downloaded file, if successful

findDownloadedFile

File findDownloadedFile(String filename)

Finds a downloaded file matching the name. Before using the returned object, check if the file exists by calling File.exists()

Parameters:

filename - File to search for

Returns:

File object representing the desired file

logWarn

void logWarn(String tag,
             String message)

Outputs a warn level message to the logger

Parameters:

tag - Value identifying the message

message - Message to log

logWarn

void logWarn(String tag,
             String message,
             Throwable tr)

Outputs a warn level message to the logger with an exception or error associated with the message

Parameters:

tag - Value identifying the message

message - Message to log

tr - Additional information to provide to the logger