FileSource (Trimble MAPS Maps SDK for Android 0.9.39 Reference)

java.lang.Object
- com.trimblemaps.mapsdk.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	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

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	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

Class FileSource

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getInstance

isExternalStorageReadable

initializeFileDirsPaths

getResourcesCachePath

getInternalCachePath

setResourcesCachePath

setResourcesCachePath

isActivated

activate

deactivate

setAccessToken

getAccessToken

setApiBaseUrl

setResourceTransform

finalize