com.abubusoft.kripton.android.sqlite

Class AbstractDataSource

java.lang.Object

android.database.sqlite.SQLiteOpenHelper

com.abubusoft.kripton.android.sqlite.AbstractDataSource

All Implemented Interfaces:

AutoCloseable

public abstract class AbstractDataSource
extends android.database.sqlite.SQLiteOpenHelper
implements AutoCloseable

Base class for data source

Author:

xcesco

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AbstractDataSource.AbstractTransaction<E extends BindDaoFactory> Interface for database transactions.
static interface	AbstractDataSource.OnDatabaseUpdateListener Manage upgrade or downgrade of database.

Field Summary

Fields

Modifier and Type	Field and Description
protected android.database.sqlite.SQLiteDatabase	database database instance
protected AbstractDataSource.OnDatabaseUpdateListener	databaseUpdateListener listener to execute code during database upgrade events
protected boolean	upgradedVersion if true, database was update during this application run

Constructor Summary

Constructors

Constructor and Description
AbstractDataSource(android.content.Context context, String name, android.database.sqlite.SQLiteDatabase.CursorFactory factory, int version)
AbstractDataSource(android.content.Context context, String name, android.database.sqlite.SQLiteDatabase.CursorFactory factory, int version, android.database.DatabaseErrorHandler errorHandler)

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
android.database.sqlite.SQLiteDatabase	getReadableDatabase()
android.database.sqlite.SQLiteDatabase	getWritableDatabase()
boolean	isOpen() return true if database is already opened.
boolean	isUpgradedVersion()
void	onDowngrade(android.database.sqlite.SQLiteDatabase db, int oldVersion, int newVersion)
void	onUpgrade(android.database.sqlite.SQLiteDatabase db, int oldVersion, int newVersion)
android.database.sqlite.SQLiteDatabase	openDatabase() Open database.
android.database.sqlite.SQLiteDatabase	openReadOnlyDatabase() Open a read only database.
android.database.sqlite.SQLiteDatabase	openWritableDatabase() open a writable database.
void	setOnDatabaseUpdateListener(AbstractDataSource.OnDatabaseUpdateListener listener) Register the listener.

Methods inherited from class android.database.sqlite.SQLiteOpenHelper

getDatabaseName, onConfigure, onCreate, onOpen, setWriteAheadLoggingEnabled

Methods inherited from class java.lang.Object

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

Field Detail

database

protected android.database.sqlite.SQLiteDatabase database

database instance

databaseUpdateListener

protected AbstractDataSource.OnDatabaseUpdateListener databaseUpdateListener

listener to execute code during database upgrade events

upgradedVersion

protected boolean upgradedVersion

if true, database was update during this application run

Constructor Detail

AbstractDataSource

public AbstractDataSource(android.content.Context context,
                  String name,
                  android.database.sqlite.SQLiteDatabase.CursorFactory factory,
                  int version)

AbstractDataSource

public AbstractDataSource(android.content.Context context,
                  String name,
                  android.database.sqlite.SQLiteDatabase.CursorFactory factory,
                  int version,
                  android.database.DatabaseErrorHandler errorHandler)

Method Detail

close

public void close()

Specified by:

close in interface AutoCloseable

Overrides:

close in class android.database.sqlite.SQLiteOpenHelper

getReadableDatabase

public android.database.sqlite.SQLiteDatabase getReadableDatabase()

Overrides:

getReadableDatabase in class android.database.sqlite.SQLiteOpenHelper

getWritableDatabase

public android.database.sqlite.SQLiteDatabase getWritableDatabase()

Overrides:

getWritableDatabase in class android.database.sqlite.SQLiteOpenHelper

isOpen

public boolean isOpen()

return true if database is already opened.

Returns:

true if database is opened, otherwise false

isUpgradedVersion

public boolean isUpgradedVersion()

Returns:

the upgradedVersion

onDowngrade

public void onDowngrade(android.database.sqlite.SQLiteDatabase db,
               int oldVersion,
               int newVersion)

Overrides:

onDowngrade in class android.database.sqlite.SQLiteOpenHelper

onUpgrade

public void onUpgrade(android.database.sqlite.SQLiteDatabase db,
             int oldVersion,
             int newVersion)

Specified by:

onUpgrade in class android.database.sqlite.SQLiteOpenHelper

openDatabase

public android.database.sqlite.SQLiteDatabase openDatabase()

Open database. Is alias for openWritableDatabase()

Returns:

writable database

openReadOnlyDatabase

public android.database.sqlite.SQLiteDatabase openReadOnlyDatabase()

Open a read only database.

Returns:

read only database

openWritableDatabase

public android.database.sqlite.SQLiteDatabase openWritableDatabase()

open a writable database.

Returns:

writable database

setOnDatabaseUpdateListener

public void setOnDatabaseUpdateListener(AbstractDataSource.OnDatabaseUpdateListener listener)

Register the listener. It need to be called before any database operations.

Parameters:

listener - listener to user