com.pega.mobile.accountmanager

Class AccountManagerServiceImpl

java.lang.Object

com.pega.mobile.accountmanager.AccountManagerServiceImpl

@Singleton
public class AccountManagerServiceImpl
extends Object

Handles and manages accounts.

Constructor Summary

Constructors

Constructor and Description
AccountManagerServiceImpl(Context context, ContainerConfiguration configuration, AccountPublicDbSQLHelper publicDb, AccountPrivateDbSQLHelperFactory accountPrivateDbSQLHelperFactory)

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(AccountManagerListener listener) Registers a listener that will be called whenever an account is opened or closed.
String	generateAndSaveKeyForField(String fieldName, boolean isPublic) Generates random key.
String	getCurrentAccountIdentifier() Returns Id of currently authenticated user or null if not authenticated.
String	getCurrentAccountSecretServiceKey(String fieldName) Returns the internal key for a given service name.
String	getCurrentAccountSecretServiceKeyIfExists(String fieldName) Returns the internal key for a given service name, if the key exists.
String	getEncryptionKeyInit()
String	getPassword()
Map<String,String>	getPrivateAccountData() Returns custom, private data associated with currently open account.
boolean	isOpen()
void	moveField(String oldFieldName, String newFieldName, boolean isPublic) Moves value from one field to another.
void	removeField(String key, boolean isPublic) Removes a given key (with associated value) from a custom fields map defined by scope.
void	removeListener(AccountManagerListener listener) Removes the listener added by addListener
String	setField(String key, String value, boolean isPublic) Sets given value for a given key in one of the custom fields map defined by scope.

Methods inherited from class java.lang.Object

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

Constructor Detail

AccountManagerServiceImpl

@Inject
public AccountManagerServiceImpl(Context context,
                                ContainerConfiguration configuration,
                                AccountPublicDbSQLHelper publicDb,
                                AccountPrivateDbSQLHelperFactory accountPrivateDbSQLHelperFactory)

Method Detail

getEncryptionKeyInit

public String getEncryptionKeyInit()

getCurrentAccountIdentifier

public String getCurrentAccountIdentifier()

Returns Id of currently authenticated user or null if not authenticated.

Returns:

Id of currently authenticated user or null if not authenticated

getPassword

public String getPassword()

getPrivateAccountData

public Map<String,String> getPrivateAccountData()
                                         throws AccountManagerException

Returns custom, private data associated with currently open account.

Returns:

Custom, private data associated with currently open account

Throws:

AccountManagerException

setField

public String setField(String key,
              String value,
              boolean isPublic)
                throws AccountManagerException

Sets given value for a given key in one of the custom fields map defined by scope. If a value exists under provided key, it is overwritten. Neither key nor value can be nil. Value must be serializable to a JSON string.

Parameters:

key - A string key under which value is persisted.

value - Custom value to be set. Must be serializable to JSON string.

isPublic - Flag determining whether field should be public or not

Returns:

Field value if added successfully, null otherwise.

Throws:

AccountManagerException

removeField

public void removeField(String key,
               boolean isPublic)
                 throws AccountManagerException

Removes a given key (with associated value) from a custom fields map defined by scope.

Parameters:

key - A string key to be removed.

isPublic - Flag determining whether field is public or not

Throws:

AccountManagerException

isOpen

public boolean isOpen()

getCurrentAccountSecretServiceKey

public String getCurrentAccountSecretServiceKey(String fieldName)
                                         throws AccountManagerException

Returns the internal key for a given service name. The key is generated and stored in an encrypted form, so subsequent requests return always the same key. There is no API to modify/remove this key, because it's supposed to be constant throughout the application lifetime on a device.

Parameters:

fieldName - Name of field.

Returns:

An internal key to be used for encryption purposes.

Throws:

AccountManagerException

getCurrentAccountSecretServiceKeyIfExists

public String getCurrentAccountSecretServiceKeyIfExists(String fieldName)
                                                 throws AccountManagerException

Returns the internal key for a given service name, if the key exists. If you want to generate a key if it does not exist use getCurrentAccountSecretServiceKey There is no API to modify/remove this key, because it's supposed to be constant throughout the application lifetime on a device.

Parameters:

fieldName - Name of field.

Returns:

An internal key to be used for encryption purposes.

Throws:

AccountManagerException

generateAndSaveKeyForField

public String generateAndSaveKeyForField(String fieldName,
                                boolean isPublic)
                                  throws AccountManagerException

Generates random key. Saves the key under the given field name.

Parameters:

fieldName - Name of field.

Throws:

AccountManagerException

moveField

public void moveField(String oldFieldName,
             String newFieldName,
             boolean isPublic)
               throws AccountManagerException

Moves value from one field to another. The old field is deleted.

Throws:

AccountManagerException

addListener

public void addListener(AccountManagerListener listener)

Registers a listener that will be called whenever an account is opened or closed. It will also be called immediately to give back the current state.

Parameters:

listener - Listener object

removeListener

public void removeListener(AccountManagerListener listener)

Removes the listener added by addListener

Parameters:

listener - Listener object