com.abubusoft.kripton.android.sqlite

Class AbstractDataSource

java.lang.Object

com.abubusoft.kripton.android.sqlite.AbstractDataSource

All Implemented Interfaces:

SQLContext, AutoCloseable

public abstract class AbstractDataSource
extends Object
implements AutoCloseable, SQLContext

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.AbstractExecutable<E extends BindDaoFactory> Interface for database operations.
static interface	AbstractDataSource.OnErrorListener
static class	AbstractDataSource.TypeStatus

Field Summary

Fields

Modifier and Type	Field and Description
protected SQLContextImpl	context
boolean	logEnabled
String	name
protected AbstractDataSource.OnErrorListener	onErrorListener
protected DataSourceOptions	options
protected android.database.sqlite.SQLiteOpenHelper	sqliteHelper
protected ThreadLocal<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)
abstract void	clearCompiledStatements() used to clear prepared statements
void	close()
KriptonContentValues	contentValues(android.database.sqlite.SQLiteStatement compiledStatement)
KriptonContentValues	contentValuesForContentProvider(android.content.ContentValues values)
KriptonContentValues	contentValuesForUpdate(android.database.sqlite.SQLiteStatement compiledStatement)
SQLContext	context()
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)
AbstractDataSource.OnErrorListener	getOnErrorListener() Get error listener, in transations
int	getVersion()
boolean	isLogEnabled()
boolean	isOpen() return true if database is already opened.
boolean	isOpenInWriteMode() return true if database is already opened in write mode.
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	setOnErrorListener(AbstractDataSource.OnErrorListener onErrorListener) Set error listener for transactions
void	setOptions(DataSourceOptions options) Define options for data source.
StringBuilder	sqlBuilder()

Methods inherited from class java.lang.Object

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

Field Detail

onErrorListener

protected AbstractDataSource.OnErrorListener onErrorListener

logEnabled

public boolean logEnabled

name

public final String name

options

protected DataSourceOptions options

sqliteHelper

protected android.database.sqlite.SQLiteOpenHelper sqliteHelper

context

protected SQLContextImpl context

status

protected ThreadLocal<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

getOnErrorListener

public AbstractDataSource.OnErrorListener getOnErrorListener()

Get error listener, in transations

Returns:

setOnErrorListener

public void setOnErrorListener(AbstractDataSource.OnErrorListener onErrorListener)

Set error listener for transactions

Parameters:

onErrorListener -

clearCompiledStatements

public abstract void clearCompiledStatements()

used to clear prepared statements

context

public SQLContext context()

contentValuesForUpdate

public KriptonContentValues contentValuesForUpdate(android.database.sqlite.SQLiteStatement compiledStatement)

Specified by:

contentValuesForUpdate in interface SQLContext

contentValues

public KriptonContentValues contentValues(android.database.sqlite.SQLiteStatement compiledStatement)

Specified by:

contentValues in interface SQLContext

contentValuesForContentProvider

public KriptonContentValues contentValuesForContentProvider(android.content.ContentValues values)

Specified by:

contentValuesForContentProvider in interface SQLContext

sqlBuilder

public StringBuilder sqlBuilder()

Specified by:

sqlBuilder in interface SQLContext

isLogEnabled

public boolean isLogEnabled()

Specified by:

isLogEnabled in interface SQLContext

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.

Specified by:

database in interface SQLContext

Returns:

isOpen

public boolean isOpen()

return true if database is already opened.

Returns:

true if database is opened, otherwise false

isOpenInWriteMode

public boolean isOpenInWriteMode()

return true if database is already opened in write mode.

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