org.jboss.aerogear.android

Class DataManager

java.lang.Object

org.jboss.aerogear.android.DataManager

public class DataManager
extends Object

Represents an abstraction layer for a storage system. As a note, you should NOT extend this class for production or application purposes. This class is made non-final ONLY for testing/mocking/academic purposes.

Constructor Summary

Constructors

Constructor and Description
DataManager() Creates a new DataManager using DefaultIdGenerator and DefaultStoreFactory
DataManager(IdGenerator idGenerator) Creates a new DataManager using the idGenerator parameter and DefaultStoreFactory
DataManager(IdGenerator idGenerator, StoreFactory storeFactory) Creates a DataManager using the supplied parameters
DataManager(StoreFactory storeFactory) Creates a new DataManager using the storeFactory parameter and DefaultIdGenerator

Method Summary

Methods

Modifier and Type	Method and Description
Store	encryptedStore(String storeName, StoreConfig config, String passphrase, Class modelClass) Creates a new Store implementation.
Store	encryptedStore(String storeName, String passphrase, Class modelClass) Creates a new default encrypted (in memory) Store implementation.
Store	get(String storeName) Loads a given Store implementation, based on the given storeName argument.
Store	remove(String storeName) Removes a Store implementation from the DataManager.
Store	store(String storeName) Deprecated. use store(java.lang.String, java.lang.Class)
Store	store(String storeName, Class modelClass) Creates a new default (in memory) Store implementation.
Store	store(String storeName, StoreConfig config) Creates a new Store implementation.

Methods inherited from class java.lang.Object

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

Constructor Detail

DataManager

public DataManager()

Creates a new DataManager using DefaultIdGenerator and DefaultStoreFactory

DataManager

public DataManager(IdGenerator idGenerator)

Creates a new DataManager using the idGenerator parameter and DefaultStoreFactory

Parameters:

idGenerator - an idGenerator

Throws:

IllegalArgumentException - if idGenerator is null

DataManager

public DataManager(StoreFactory storeFactory)

Creates a new DataManager using the storeFactory parameter and DefaultIdGenerator

Parameters:

storeFactory - a store factory

Throws:

IllegalArgumentException - if storeFactory is null

DataManager

public DataManager(IdGenerator idGenerator,
           StoreFactory storeFactory)

Creates a DataManager using the supplied parameters

Parameters:

idGenerator - an idGenerator

storeFactory - a store factory

Throws:

IllegalArgumentException - if idGenerator is null

IllegalArgumentException - if storeFactory is null

Method Detail

store

@Deprecated
public Store store(String storeName)

Deprecated. use store(java.lang.String, java.lang.Class)

Creates a new default (in memory) Store implementation.

Parameters:

storeName - The name of the actual data store object.

Returns:

a default in MemoryStore

store

public Store store(String storeName,
          Class modelClass)

Creates a new default (in memory) Store implementation.

Parameters:

storeName - The name of the actual data store object.

modelClass - The class for the Store

Returns:

a default in MemoryStore

store

public Store store(String storeName,
          StoreConfig config)

Creates a new Store implementation. The actual type is determined by the type argument.

Parameters:

storeName - The name of the actual data store object.

config - The config object used to build the store

Returns:

a store configured by the config param

encryptedStore

public Store encryptedStore(String storeName,
                   String passphrase,
                   Class modelClass)
                     throws InvalidKeySpecException

Creates a new default encrypted (in memory) Store implementation.

Parameters:

storeName - The name of the actual data store object.

passphrase - The passphrase used to create a KeyStore

modelClass - The model class will be encrypted

Returns:

a default encrypted in memory store

Throws:

InvalidKeySpecException - if the key spec is invalid

encryptedStore

public Store encryptedStore(String storeName,
                   StoreConfig config,
                   String passphrase,
                   Class modelClass)
                     throws InvalidKeySpecException

Creates a new Store implementation. The actual type is determined by the type argument.

Parameters:

storeName - The name of the actual data store object.

config - The config object used to build the store

passphrase - The passphrase used to create a KeyStore

modelClass - The model class will be encrypted

Returns:

a default encrypted in memory store

Throws:

InvalidKeySpecException - if encryption is used, this method will throw an exception if the keys provided on the config object are malformed.

remove

public Store remove(String storeName)

Removes a Store implementation from the DataManager. The store to be removed is determined by the storeName argument.

Parameters:

storeName - The name of the actual data store object.

Returns:

the store removed or null

get

public Store get(String storeName)

Loads a given Store implementation, based on the given storeName argument.

Parameters:

storeName - The name of the actual data store object.

Returns:

the store stored at storeName