com.mapbox.mapboxsdk.storage

Class FileSource

java.lang.Object

com.mapbox.mapboxsdk.storage.FileSource

public class FileSource
extends java.lang.Object

Holds a central reference to the core's DefaultFileSource for as long as there are active mapviews / offline managers

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	FileSource.ResourcesCachePathChangeCallback This callback receives an asynchronous response containing the new path of the resources cache database.
static interface	FileSource.ResourceTransformCallback This callback allows implementors to transform URLs before they are requested from the internet.

Method Summary

Modifier and Type	Method and Description
void	activate()
void	deactivate()
protected void	finalize()
java.lang.String	getAccessToken()
static FileSource	getInstance(android.content.Context context) Get the single instance of FileSource.
static java.lang.String	getInternalCachePath(android.content.Context context) Get internal cache path for a context.
static java.lang.String	getResourcesCachePath(android.content.Context context) Get files directory path for a context.
static void	initializeFileDirsPaths(android.content.Context context) Initializes file directories paths.
boolean	isActivated()
static boolean	isExternalStorageReadable() Checks if external storage is available to at least read.
void	setAccessToken(java.lang.String accessToken)
void	setApiBaseUrl(java.lang.String baseUrl)
static void	setResourcesCachePath(android.content.Context context, java.lang.String path, FileSource.ResourcesCachePathChangeCallback callback) Deprecated. Use setResourcesCachePath(String, ResourcesCachePathChangeCallback)
static void	setResourcesCachePath(java.lang.String path, FileSource.ResourcesCachePathChangeCallback callback) Changes the path of the resources cache database.
void	setResourceTransform(FileSource.ResourceTransformCallback callback) Sets a callback for transforming URLs requested from the internet

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

@UiThread
public static FileSource getInstance(@NonNull
                                               android.content.Context context)

Get the single instance of FileSource.

Parameters:

context - the context to derive the cache path from

Returns:

the single instance of FileSource

isExternalStorageReadable

public static boolean isExternalStorageReadable()

Checks if external storage is available to at least read. In order for this to work, make sure you include <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> (or WRITE_EXTERNAL_STORAGE) for API level < 18 in your app Manifest.

Code from https://developer.android.com/guide/topics/data/data-storage.html#filesExternal

Returns:

true if external storage is readable

initializeFileDirsPaths

@UiThread
public static void initializeFileDirsPaths(android.content.Context context)

Initializes file directories paths.

Parameters:

context - the context to derive paths from

getResourcesCachePath

@NonNull
public static java.lang.String getResourcesCachePath(@NonNull
                                                              android.content.Context context)

Get files directory path for a context.

Parameters:

context - the context to derive the files directory path from

Returns:

the files directory path

getInternalCachePath

public static java.lang.String getInternalCachePath(@NonNull
                                                    android.content.Context context)

Get internal cache path for a context.

Parameters:

context - the context to derive the internal cache path from

Returns:

the internal cache path

setResourcesCachePath

@Deprecated
public static void setResourcesCachePath(@NonNull
                                                     android.content.Context context,
                                                     @NonNull
                                                     java.lang.String path,
                                                     @NonNull
                                                     FileSource.ResourcesCachePathChangeCallback callback)

Deprecated. Use setResourcesCachePath(String, ResourcesCachePathChangeCallback)

Changes the path of the resources cache database.

The callback reference is strongly kept throughout the process, so it needs to be wrapped in a weak reference or released on the client side if necessary.

Parameters:

context - the context of the path

path - the new database path

callback - the callback to obtain the result

setResourcesCachePath

public static void setResourcesCachePath(@NonNull
                                         java.lang.String path,
                                         @NonNull
                                         FileSource.ResourcesCachePathChangeCallback callback)

Changes the path of the resources cache database.

The callback reference is strongly kept throughout the process, so it needs to be wrapped in a weak reference or released on the client side if necessary.

Parameters:

path - the new database path

callback - the callback to obtain the result

isActivated

public boolean isActivated()

activate

public void activate()

deactivate

public void deactivate()

setAccessToken

public void setAccessToken(java.lang.String accessToken)

getAccessToken

@NonNull
public java.lang.String getAccessToken()

setApiBaseUrl

public void setApiBaseUrl(java.lang.String baseUrl)

setResourceTransform

public void setResourceTransform(FileSource.ResourceTransformCallback callback)

Sets a callback for transforming URLs requested from the internet

The callback will be executed on the main thread once for every requested URL.

Parameters:

callback - the callback to be invoked or null to reset

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable