Package com.batch.android.user

Class SQLUserDatasource

java.lang.Object

com.batch.android.user.SQLUserDatasource

All Implemented Interfaces:

UserDatasource

public final class SQLUserDatasource
extends java.lang.Object
implements UserDatasource

User data (attributes) datasource. Wraps SQLite queries (DAO).

This class is NOT thread or context safe at all. You must make sure it is ALWAYS acessed using its singleton, and that all of the calls happen on a single thread.

Constructor Summary

Constructors

Constructor	Description
SQLUserDatasource(android.content.Context context)

Method Summary

Modifier and Type	Method	Description
void	acquireTransactionLock(long changeset)	Acquires a transaction for a changeset.
void	addTag(java.lang.String collection, java.lang.String tag)
void	clear()	Clear everything.
void	clearAttributes()
void	clearTags()
void	clearTags(java.lang.String collection)
void	close()
void	commitTransaction()	Commits the transaction, releasing the transaction lock
java.util.HashMap<java.lang.String,UserAttribute>	getAttributes()
java.util.Map<java.lang.String,java.util.Set<java.lang.String>>	getTagCollections()
java.lang.String	printDebugDump()
void	removeAttribute(java.lang.String key)
void	removeTag(java.lang.String collection, java.lang.String tag)
void	rollbackTransaction()
void	setAttribute(java.lang.String key, boolean attribute)
void	setAttribute(java.lang.String key, double attribute)
void	setAttribute(java.lang.String key, long attribute)
void	setAttribute(java.lang.String key, java.lang.String attribute)
void	setAttribute(java.lang.String key, java.net.URI attribute)
void	setAttribute(java.lang.String key, java.util.Date attribute)

Methods inherited from class java.lang.Object

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

Constructor Detail

SQLUserDatasource

public SQLUserDatasource(android.content.Context context)
                  throws android.database.sqlite.SQLiteException

Throws:

android.database.sqlite.SQLiteException

Method Detail

close

public void close()

Specified by:

close in interface UserDatasource

acquireTransactionLock

public void acquireTransactionLock(long changeset)
                            throws UserDatabaseException

Acquires a transaction for a changeset. Needed before doing other changes.

Specified by:

acquireTransactionLock in interface UserDatasource

Parameters:

changeset - Changeset for modifications

Throws:

UserDatabaseException

commitTransaction

public void commitTransaction()
                       throws UserDatabaseException

Commits the transaction, releasing the transaction lock

Specified by:

commitTransaction in interface UserDatasource

Throws:

UserDatabaseException

rollbackTransaction

public void rollbackTransaction()
                         throws UserDatabaseException

Specified by:

rollbackTransaction in interface UserDatasource

Throws:

UserDatabaseException

setAttribute

public void setAttribute(@NonNull
                         java.lang.String key,
                         long attribute)
                  throws UserDatabaseException

Specified by:

setAttribute in interface UserDatasource

Throws:

UserDatabaseException

setAttribute

public void setAttribute(@NonNull
                         java.lang.String key,
                         double attribute)
                  throws UserDatabaseException

Specified by:

setAttribute in interface UserDatasource

Throws:

UserDatabaseException

setAttribute

public void setAttribute(@NonNull
                         java.lang.String key,
                         boolean attribute)
                  throws UserDatabaseException

Specified by:

setAttribute in interface UserDatasource

Throws:

UserDatabaseException

setAttribute

public void setAttribute(@NonNull
                         java.lang.String key,
                         @NonNull
                         java.lang.String attribute)
                  throws UserDatabaseException

Specified by:

setAttribute in interface UserDatasource

Throws:

UserDatabaseException

setAttribute

public void setAttribute(@NonNull
                         java.lang.String key,
                         @NonNull
                         java.util.Date attribute)
                  throws UserDatabaseException

Specified by:

setAttribute in interface UserDatasource

Throws:

UserDatabaseException

setAttribute

public void setAttribute(@NonNull
                         java.lang.String key,
                         @NonNull
                         java.net.URI attribute)
                  throws UserDatabaseException

Specified by:

setAttribute in interface UserDatasource

Throws:

UserDatabaseException

removeAttribute

public void removeAttribute(@NonNull
                            java.lang.String key)
                     throws UserDatabaseException

Specified by:

removeAttribute in interface UserDatasource

Throws:

UserDatabaseException

addTag

public void addTag(@NonNull
                   java.lang.String collection,
                   @NonNull
                   java.lang.String tag)
            throws UserDatabaseException

Specified by:

addTag in interface UserDatasource

Throws:

UserDatabaseException

removeTag

public void removeTag(@NonNull
                      java.lang.String collection,
                      @NonNull
                      java.lang.String tag)
               throws UserDatabaseException

Specified by:

removeTag in interface UserDatasource

Throws:

UserDatabaseException

clear

public void clear()

Clear everything. Not meant to be used during a transaction!

Specified by:

clear in interface UserDatasource

clearTags

public void clearTags()

Specified by:

clearTags in interface UserDatasource

clearTags

public void clearTags(java.lang.String collection)

Specified by:

clearTags in interface UserDatasource

clearAttributes

public void clearAttributes()

Specified by:

clearAttributes in interface UserDatasource

getTagCollections

@NonNull
public java.util.Map<java.lang.String,java.util.Set<java.lang.String>> getTagCollections()

Specified by:

getTagCollections in interface UserDatasource

getAttributes

@NonNull
public java.util.HashMap<java.lang.String,UserAttribute> getAttributes()

Specified by:

getAttributes in interface UserDatasource

printDebugDump

public java.lang.String printDebugDump()

Specified by:

printDebugDump in interface UserDatasource