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.

Method Summary

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

Method Detail

localSave

void localSave(java.lang.String key,
               byte[] data)
        throws java.io.IOException

Save the data to the local device

Parameters:

key - Key value identifying the data

data - Data to save

Throws:

java.io.IOException - If I/O error occurs

localRetrieve

java.io.InputStream localRetrieve(java.lang.String key)
                           throws java.io.IOException

Retrieves data saved locally to the device

Parameters:

key - Key value identifying the data

Returns:

Stream to read the data

Throws:

java.io.IOException - If I/O error occurs

downloadFileAsync

bolts.Task<java.io.File> downloadFileAsync(java.lang.String srcUrl,
                                           java.lang.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

java.io.File findDownloadedFile(java.lang.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(java.lang.String tag,
             java.lang.String message)

Outputs a warn level message to the logger

Parameters:

tag - Value identifying the message

message - Message to log

logWarn

void logWarn(java.lang.String tag,
             java.lang.String message,
             java.lang.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