com.atakmap.android.model.viewer.io

Class FileStorageService

java.lang.Object

com.atakmap.android.model.viewer.io.FileStorageService

public final class FileStorageService
extends java.lang.Object

Service for reading/writing files to persistence

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FileStorageService.FileMetadata Represents the metadata of a file

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	MODEL_EXTENSION
static java.lang.String	STORAGE_PATH

Method Summary

Modifier and Type	Method and Description
static byte[]	getBytes(android.net.Uri uri) Read raw bytes from a given uri
static java.io.File	getFile(android.net.Uri uri) Gets a file handle based off a uri
static FileStorageService.FileMetadata	getFileMetadata(android.net.Uri uri) Retrieves file metadata
static FileStorageService.FileMetadata	getFileMetadata(android.net.Uri uri, android.content.ContentResolver contentResolver) Retrieves file metadata
static java.util.List<java.io.File>	write(java.util.List<FileDto> fileDtos) Writes a list of FileDtos to external storage

Methods inherited from class java.lang.Object

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

Field Detail

MODEL_EXTENSION

public static final java.lang.String MODEL_EXTENSION

See Also:

Constant Field Values

STORAGE_PATH

public static final java.lang.String STORAGE_PATH

Method Detail

write

public static java.util.List<java.io.File> write(java.util.List<FileDto> fileDtos)
                                          throws java.io.IOException

Writes a list of FileDtos to external storage

Parameters:

fileDtos - the file data transfer objects to serialize; may not be null

Returns:

the list of files that were successfully written; never null; may be empty

Throws:

java.lang.NullPointerException - if fileDtos is null

java.io.IOException - if an error occurred while trying to serialize the data

getFileMetadata

public static FileStorageService.FileMetadata getFileMetadata(android.net.Uri uri)
                                                       throws java.io.IOException

Retrieves file metadata

Parameters:

uri - the uri of the file; may not be null

Returns:

the file metadata; never null

Throws:

java.io.IOException - if an error occurred while accessing the file

java.lang.NullPointerException - if uri was null

getFileMetadata

public static FileStorageService.FileMetadata getFileMetadata(android.net.Uri uri,
                                                              android.content.ContentResolver contentResolver)
                                                       throws java.io.IOException

Retrieves file metadata

Parameters:

uri - the uri of the file; may not be null

contentResolver - the ContentResolver used to retrieve the metadata; may not be null

Returns:

the file metadata; never null

Throws:

java.lang.NullPointerException - if uri or contentResolver is null

java.io.IOException - if an error occurred while accessing the file

getFile

public static java.io.File getFile(android.net.Uri uri)
                            throws java.io.IOException

Gets a file handle based off a uri

Parameters:

uri - the uri of the file; may not be null

Returns:

the file; may be null if unable to construct the file from the given uri

Throws:

java.lang.NullPointerException - if uri was null

java.io.IOException - if unable to construct the file object

getBytes

public static byte[] getBytes(android.net.Uri uri)
                       throws java.io.IOException

Read raw bytes from a given uri

Parameters:

uri - the uri of a resource to read; may not be null

Returns:

the raw bytes of the uri

Throws:

java.io.IOException - if unable to read the uri

java.lang.NullPointerException - if uri was null