com.pega.mobile.filesystem

Class FileSystemPathResolverImpl

java.lang.Object

com.pega.mobile.filesystem.FileSystemPathResolverImpl

@Singleton
public class FileSystemPathResolverImpl
extends Object

The native path are as follows: PRIVATE FOR USER AND WEBAPP [native_root]/filesystem/user/[username]/private/[webAppID]/localstorage/[relative_path_from_JS_root] PRIVATE FOR USER AND SHARED BETWEEN WEBAPPS [native_root]/filesystem/user/[username]/shared/localstorage/[relative_path_from_JS_root] SHARED BETWEEN USERS BUT PRIVATE FOR WEBAPP [native_root]/filesystem/shared/private/[webAppID]/localstorage/[relative_path_from_JS_root] SHARED BETWEEN USERS AND WEBAPPS [native_root]/filesystem/shared/shared/localstorage/[relative_path_from_JS_root] EXTERNAL [external_root]/[relative_path_from_JS_root] The JS path is as follows: content://contentProviderName/[js_root_type]/[optional hash]/[relative_path_from_JS_root] where js_root_type is one of: persistent, temporary, shared_persistent, shared_temporary, multiuser_persistent, multiuser_temporary, multiuser_shared_persistent, multiuser_shared_temporary, external

Constructor Summary

Constructors

Constructor and Description
FileSystemPathResolverImpl(Context context, AccountManagerServiceImpl accountManagerService, FileSystemHashGenerator hashGenerator)

Method Summary

Methods

Modifier and Type	Method and Description
Uri	getJavaScriptPath(Uri nativePath) Converts a native path URL to a JavaScript File API path URI.
Uri	getNativeCacheSharedPath() Returns root for shared cache for web application.
List<Uri>	getNativeCompleteMultiUserRootsForWebApp(String appId) Returns a list of complete roots for files shared between users for given application.
List<Uri>	getNativeCompleteUserRootsForWebApp(String appId) Returns a list of complete roots for currently opened user.
List<Uri>	getNativeFileSystemRoots() Returns list of native filesystem roots - temporary and persistent.
List<Uri>	getNativeFileSystemUserRoots(String userIdentifier) Returns list of native filesystem roots for specified user.
Uri	getNativePath(Uri jsPath) Converts a JavaScript File API URL path to a native path URL.
Uri	getNativeRootPath(String jsRootType, String appIdentifier) Returns a native path for a specified JS root type and given application.
Uri	getNativeRootPath(Uri nativePath) Returns a native root path for a specified native path.
List<Uri>	getNativeWebAppsRoots(String appId) Returns a list of roots for given web application.
protected String	getScheme()
static boolean	isJsPath(Uri jsPath) Checks if the given path starts with JS-specific schemes.
boolean	isPathExternal(Uri jsPath) Returns whether the jsPath refers to external storage on the device

Methods inherited from class java.lang.Object

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

Constructor Detail

FileSystemPathResolverImpl

@Inject
public FileSystemPathResolverImpl(Context context,
                                 AccountManagerServiceImpl accountManagerService,
                                 FileSystemHashGenerator hashGenerator)

Method Detail

getNativeRootPath

public Uri getNativeRootPath(String jsRootType,
                    String appIdentifier)
                      throws Exception

Returns a native path for a specified JS root type and given application.

Parameters:

jsRootType - On of the js root types defined in the class description.

appIdentifier - Web application identifier.

Returns:

A native path for a specified JS root type and given application or null

Throws:

Exception

getNativeRootPath

public Uri getNativeRootPath(Uri nativePath)
                      throws Exception

Returns a native root path for a specified native path.

Parameters:

nativePath - A native URI to be converted.

Returns:

A native root path URI.

Throws:

Exception

getNativePath

public Uri getNativePath(Uri jsPath)
                  throws Exception

Converts a JavaScript File API URL path to a native path URL. Web ContainerApplication and account identifiers are automatically resolved.

Parameters:

jsPath - A JavaScript File API URI to be converted.

Returns:

A native file path URL or null in case of invalid Uri provided.

Throws:

Exception

getJavaScriptPath

public Uri getJavaScriptPath(Uri nativePath)
                      throws Exception

Converts a native path URL to a JavaScript File API path URI. Web ContainerApplication identifier is hidden with a random hash.

Parameters:

nativePath - A native URI to be converted.

Returns:

A JavaScript file path URL or null in case of invalid Uri provided.

Throws:

Exception

getScheme

protected String getScheme()

getNativeFileSystemRoots

public List<Uri> getNativeFileSystemRoots()

Returns list of native filesystem roots - temporary and persistent. /filesystem

getNativeFileSystemUserRoots

public List<Uri> getNativeFileSystemUserRoots(String userIdentifier)

Returns list of native filesystem roots for specified user. /filesystem/user/

getNativeCompleteUserRootsForWebApp

public List<Uri> getNativeCompleteUserRootsForWebApp(String appId)

Returns a list of complete roots for currently opened user. /filesystem/user//private//localstorage /shared/localstorage

getNativeCompleteMultiUserRootsForWebApp

public List<Uri> getNativeCompleteMultiUserRootsForWebApp(String appId)

Returns a list of complete roots for files shared between users for given application. /filesystem/shared/private//localstorage /filesystem/shared/shared/localstorage

getNativeWebAppsRoots

public List<Uri> getNativeWebAppsRoots(String appId)

Returns a list of roots for given web application.

getNativeCacheSharedPath

public Uri getNativeCacheSharedPath()

Returns root for shared cache for web application.

isPathExternal

public boolean isPathExternal(Uri jsPath)

Returns whether the jsPath refers to external storage on the device

isJsPath

public static boolean isJsPath(Uri jsPath)

Checks if the given path starts with JS-specific schemes.

Parameters:

jsPath -

Returns:

true if the path is considered JS-path