org.beigesoft.android.sqlite.service

Class SrvDatabase

java.lang.Object

org.beigesoft.orm.service.ASrvDatabase<android.database.Cursor>

org.beigesoft.android.sqlite.service.SrvDatabase

All Implemented Interfaces:

org.beigesoft.orm.service.ISrvDatabase<android.database.Cursor>

public class SrvDatabase
extends org.beigesoft.orm.service.ASrvDatabase<android.database.Cursor>

Implementation of database service on Android. Android SQLite Database not designed to be multiconnection. So two or more requests on IJetty at same time will be sharing the same connection, and result will be bad. E.g. thread1 for request1 invoke "setAutocommit(true)", then thread2 for request2 invoke "setAutocommit(false)", then thread1 invoke "beginTransaction"...

Author:

Yury Demidenko

Field Summary

Fields inherited from interface org.beigesoft.orm.service.ISrvDatabase

BAD_PARAMS, DIRTY_READ, ERROR_INSERT_UPDATE, KEY_ID_DATABASE, SQL_EXEC_ERROR, TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Constructor Summary

Constructors

Constructor and Description
SrvDatabase()

Method Summary

Methods

Modifier and Type	Method and Description
void	beginTransaction() Start new transaction.
void	commitTransaction() Commit transaction.
android.content.ContentValues	convertToContentValues(org.beigesoft.orm.model.ColumnsValues pColumnsVals) Convert org.beigesoft.orm.model.ColumnsValues to android.content.ContentValues.
void	createSavepoint(String pSavepointName) Create savepoint.
int	executeDelete(String pTable, String pWhere) Execute SQL DELETE that returns affected rows.
long	executeInsert(String pTable, org.beigesoft.orm.model.ColumnsValues pColumnsVals) Execute SQL INSERT that returns affected rows.
void	executeQuery(String pQuery) Execute any SQL query that returns no data.
int	executeUpdate(String pTable, org.beigesoft.orm.model.ColumnsValues pColumnsVals, String pWhere) Execute SQL UPDATE that returns affected rows.
protected void	finalize()
boolean	getIsAutocommit() Get if an transaction is started.
android.database.sqlite.SQLiteDatabase	getSqliteDatabase() Geter for sqliteDatabase.
int	getTransactionIsolation() Get transaction isolation level.
void	releaseResources() Release only unneeded memory.
void	releaseSavepoint(String pSavepointName) Release savepoint.
org.beigesoft.orm.model.IRecordSet<android.database.Cursor>	retrieveRecords(String pSelect) Retrieve records from DB.
void	rollBackTransaction() Rollback transaction.
void	rollBackTransaction(String pSavepointName) Rollback transaction to savepoint.
void	setIsAutocommit(boolean pIsAutocommit) Set RDBMS autocommit mode.
void	setSqliteDatabase(android.database.sqlite.SQLiteDatabase pSqliteDatabase) Setter for sqliteDatabase.
void	setTransactionIsolation(int pLevel) Set transaction isolation level.

Methods inherited from class org.beigesoft.orm.service.ASrvDatabase

evalDoubleResult, evalDoubleResults, evalFloatResult, evalIntegerResult, evalLongResult, getIdDatabase, getLogger, getSrvRecordRetriever, getVersionDatabase, setLogger, setSrvRecordRetriever

Methods inherited from class java.lang.Object

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

Constructor Detail

SrvDatabase

public SrvDatabase()

Method Detail

getIsAutocommit

public final boolean getIsAutocommit()
                              throws Exception

Get if an transaction is started.

Parameters:

pIsAutocommit - is autocommit

Throws:

Exception - - an exception

setIsAutocommit

public final void setIsAutocommit(boolean pIsAutocommit)
                           throws Exception

Set RDBMS autocommit mode.

Parameters:

pIsAutocommit - if autocommit

Throws:

Exception - - an exception

setTransactionIsolation

public final void setTransactionIsolation(int pLevel)
                                   throws Exception

Set transaction isolation level. For single-connection Android it doesnt care.

Parameters:

pLevel - according ISrvOrm

Throws:

Exception - - an exception

getTransactionIsolation

public final int getTransactionIsolation()
                                  throws Exception

Get transaction isolation level. For single-connection Android it doesnt care.

Returns:

pLevel according ISrvOrm

Throws:

Exception - - an exception

createSavepoint

public final void createSavepoint(String pSavepointName)
                           throws Exception

Create savepoint.

Parameters:

pSavepointName - savepoint name

Throws:

Exception - - an exception

releaseSavepoint

public final void releaseSavepoint(String pSavepointName)
                            throws Exception

Release savepoint.

Parameters:

pSavepointName - savepoint name

Throws:

Exception - - an exception

rollBackTransaction

public final void rollBackTransaction(String pSavepointName)
                               throws Exception

Rollback transaction to savepoint.

Parameters:

pSavepointName - savepoint name

Throws:

Exception - - an exception

beginTransaction

public final void beginTransaction()
                            throws Exception

Start new transaction.

Throws:

Exception - - an exception

commitTransaction

public final void commitTransaction()
                             throws Exception

Commit transaction.

Throws:

Exception - - an exception

rollBackTransaction

public final void rollBackTransaction()
                               throws Exception

Rollback transaction.

Throws:

Exception - - an exception

releaseResources

public final void releaseResources()
                            throws Exception

Release only unneeded memory.

Throws:

Exception - - an exception

retrieveRecords

public final org.beigesoft.orm.model.IRecordSet<android.database.Cursor> retrieveRecords(String pSelect)
                                                                                  throws org.beigesoft.exception.ExceptionWithCode

Retrieve records from DB.

Parameters:

pSelect - query SELECT

Returns:

IRecordSet record set

Throws:

org.beigesoft.exception.ExceptionWithCode - - if an exception occured

executeQuery

public final void executeQuery(String pQuery)
                        throws Exception

Execute any SQL query that returns no data. E.g. PRAGMA, etc.

Parameters:

pQuery - query

Throws:

org.beigesoft.exception.ExceptionWithCode - - if an exception occured

Exception

executeUpdate

public final int executeUpdate(String pTable,
                org.beigesoft.orm.model.ColumnsValues pColumnsVals,
                String pWhere)
                        throws Exception

Execute SQL UPDATE that returns affected rows. It is to adapt Android insert/update/delete interface.

Parameters:

pTable - table name

pColumnsVals - type-safe map column name - column value

pWhere - where conditions e.g. "itsId=2"

Returns:

row count affected

Throws:

org.beigesoft.exception.ExceptionWithCode - - if an exception occured

Exception

executeInsert

public final long executeInsert(String pTable,
                 org.beigesoft.orm.model.ColumnsValues pColumnsVals)
                         throws Exception

Execute SQL INSERT that returns affected rows. It is to adapt Android insert/update/delete interface.

Parameters:

pTable - table name

pColumnsVals - type-safe map column name - column value

Returns:

-1 - error or autogenerated key or ? maybe 1 for String key ?

Throws:

org.beigesoft.exception.ExceptionWithCode - - if an exception occured

Exception

executeDelete

public final int executeDelete(String pTable,
                String pWhere)
                        throws Exception

Execute SQL DELETE that returns affected rows. It is to adapt Android insert/update/delete interface.

Parameters:

pTable - table name

pWhere - where conditions e.g. "itsId=2" or NULL -delete all

Returns:

row count affected

Throws:

org.beigesoft.exception.ExceptionWithCode - - if an exception occured

Exception

finalize

protected final void finalize()

Overrides:

finalize in class Object

convertToContentValues

public final android.content.ContentValues convertToContentValues(org.beigesoft.orm.model.ColumnsValues pColumnsVals)

Convert org.beigesoft.orm.model.ColumnsValues to android.content.ContentValues.

Parameters:

pColumnsVals - Columns Values

Returns:

ContentValues

getSqliteDatabase

public final android.database.sqlite.SQLiteDatabase getSqliteDatabase()

Geter for sqliteDatabase.

Returns:

SQLiteDatabase

setSqliteDatabase

public final void setSqliteDatabase(android.database.sqlite.SQLiteDatabase pSqliteDatabase)

Setter for sqliteDatabase.

Parameters:

pSqliteDatabase - reference