org.javarosa.core.services.storage

Class StorageManager

java.lang.Object

org.javarosa.core.services.storage.StorageManager

public class StorageManager
extends Object

Manages StorageProviders for JavaRosa, which maintain persistent data on a device. Largely derived from Cell Life's RMSManager

Author:

Clayton Sims

Constructor Summary

Constructors

Constructor and Description
StorageManager()

Method Summary

Modifier and Type	Method and Description
static IStorageUtility<? extends Externalizable>	getStorage(String key)
static void	halt()
static String[]	listRegisteredUtilities()
static void	registerStorage(String key, Class type)
static void	registerStorage(String key, IStorageUtility<? extends Externalizable> storage) It is strongly, strongly advised that you do not register storage in this way.
static void	registerStorage(String storageKey, String storageName, Class type)
static void	registerWrappedStorage(String key, String storeName, WrappingStorageUtility.SerializationWrapper wrapper)
static void	repairAll()
static void	setStorageFactory(IStorageFactory fact) Attempts to set the storage factory for the current environment.
static void	setStorageFactory(IStorageFactory fact, boolean mustWork) Attempts to set the storage factory for the current environment and fails and dies if there is already a storage factory set if specified.

Methods inherited from class java.lang.Object

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

Constructor Detail

StorageManager

public StorageManager()

Method Detail

setStorageFactory

public static void setStorageFactory(IStorageFactory fact)

Attempts to set the storage factory for the current environment. Will fail silently if a storage factory has already been set. Should be used by default environment.

Parameters:

fact - An available storage factory.

setStorageFactory

public static void setStorageFactory(IStorageFactory fact,
                                     boolean mustWork)

Attempts to set the storage factory for the current environment and fails and dies if there is already a storage factory set if specified. Should be used by actual applications who need to use a specific storage factory and shouldn't tolerate being pre-empted.

Parameters:

fact - An available storage factory.

mustWork - true if it is intolerable for another storage factory to have been set. False otherwise

registerStorage

public static void registerStorage(String key,
                                   Class type)

registerStorage

public static void registerStorage(String storageKey,
                                   String storageName,
                                   Class type)

registerStorage

public static void registerStorage(String key,
                                   IStorageUtility<? extends Externalizable> storage)

It is strongly, strongly advised that you do not register storage in this way.

Parameters:

key -

storage -

registerWrappedStorage

public static void registerWrappedStorage(String key,
                                          String storeName,
                                          WrappingStorageUtility.SerializationWrapper wrapper)

getStorage

public static IStorageUtility<? extends Externalizable> getStorage(String key)

repairAll

public static void repairAll()

listRegisteredUtilities

public static String[] listRegisteredUtilities()

halt

public static void halt()