com.abubusoft.kripton.android.sqlite

Class AbstractDataSource

java.lang.Object

com.abubusoft.kripton.android.sqlite.AbstractDataSource

All Implemented Interfaces:

AutoCloseable

public abstract class AbstractDataSource
extends Object
implements AutoCloseable

Base class for data source

Author:

Francesco Benincasa (info@abubusoft.com)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AbstractDataSource.AbstractTransaction<E extends BindDaoFactory> Interface for database transactions.

Field Summary

Fields

Modifier and Type	Field and Description
String	name
protected DataSourceOptions	options
protected android.database.sqlite.SQLiteOpenHelper	sqliteHelper
protected ThreadLocal<com.abubusoft.kripton.android.sqlite.AbstractDataSource.TypeStatus>	status
protected int	version database version
protected boolean	versionChanged if true, database was update during this application run

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractDataSource(String name, int version, DataSourceOptions options)

Method Summary

Modifier and Type	Method and Description
protected List<SQLiteUpdateTask>	buildTaskList(int previousVersion, int currentVersion)
void	close()
protected void	createHelper(DataSourceOptions options)
android.database.sqlite.SQLiteDatabase	database() Return database object or runtimeexception if no database is opened.
protected SQLiteUpdateTask	findPopulateTaskList(int currentVersion)
int	getVersion()
boolean	isOpen() return true if database is already opened.
boolean	isUpgradedVersion()
abstract void	onConfigure(android.database.sqlite.SQLiteDatabase database)
abstract void	onCreate(android.database.sqlite.SQLiteDatabase database)
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	openReadOnlyDatabase() Open a read only database.
android.database.sqlite.SQLiteDatabase	openWritableDatabase() open a writable database.
void	setOptions(DataSourceOptions options) Define options for data source.

Methods inherited from class java.lang.Object

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

Field Detail

name

public final String name

options

protected DataSourceOptions options

sqliteHelper

protected android.database.sqlite.SQLiteOpenHelper sqliteHelper

status

protected ThreadLocal<com.abubusoft.kripton.android.sqlite.AbstractDataSource.TypeStatus> status

versionChanged

protected boolean versionChanged

if true, database was update during this application run

version

protected int version

database version

Constructor Detail

AbstractDataSource

protected AbstractDataSource(String name,
                             int version,
                             DataSourceOptions options)

Method Detail

getVersion

public int getVersion()

close

public void close()

Specified by:

close in interface AutoCloseable

findPopulateTaskList

protected SQLiteUpdateTask findPopulateTaskList(int currentVersion)

buildTaskList

protected List<SQLiteUpdateTask> buildTaskList(int previousVersion,
                                               int currentVersion)

createHelper

protected void createHelper(DataSourceOptions options)

database

public android.database.sqlite.SQLiteDatabase database()

Return database object or runtimeexception if no database is opened.

Returns:

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

onConfigure

public abstract void onConfigure(android.database.sqlite.SQLiteDatabase database)

onCreate

public abstract void onCreate(android.database.sqlite.SQLiteDatabase database)

onDowngrade

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

onUpgrade

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

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

setOptions

public void setOptions(DataSourceOptions options)

Define options for data source. It must be defined before open first connection.

Parameters:

options - options