com.dingi.dingisdk.storage

Class FileSource

java.lang.Object

com.dingi.dingisdk.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.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 java.lang.String	getCachePath(android.content.Context context) Deprecated. Use getResourcesCachePath(Context) instead.
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 dingiMapAccessToken)
void	setApiBaseUrl(java.lang.String baseUrl)
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

getCachePath

@Nullable
 @Deprecated
public static java.lang.String getCachePath(@NonNull
                                                                   android.content.Context context)

Deprecated. Use getResourcesCachePath(Context) instead.

Get files directory path for a context.

Parameters:

context - the context to derive the files directory path from

Returns:

the files directory path

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

@Nullable
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

isActivated

public boolean isActivated()

activate

public void activate()

deactivate

public void deactivate()

setAccessToken

public void setAccessToken(@NonNull
                           java.lang.String dingiMapAccessToken)

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