net.akaish.kitty.orm

Class KittyMapper

java.lang.Object

net.akaish.kitty.orm.KittyMapper

All Implemented Interfaces:

java.lang.Cloneable

public class KittyMapper
extends java.lang.Object
implements java.lang.Cloneable

Kitty Data Mapper class

Author:

akaish (Denis Bogomolov)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	KittyMapper.TRANSACTION_MODES Transaction modes

Field Summary

Fields

Modifier and Type	Field and Description
protected KittyModel	blankModelInstance Blank model to be used with this mapper
protected java.util.HashMap<java.lang.String,KittyColumnConfiguration>	columnConfigurations
protected SQLiteConditionBuilder	conditionBuilder Condition builder
protected KittyModelCVFactory	cursorToModelFactory Cursor to model factory
protected android.database.sqlite.SQLiteDatabase	database
protected KittyDatabaseHelper	databaseHelper
protected java.lang.String	databasePassword
protected static java.lang.String	DELETE_PL
protected static java.lang.String	DELETE_PL2
protected static java.lang.String	INS_PL
protected java.util.List<java.lang.String>	insertPKExclusions
protected static java.lang.String	KE_DELETE_READ_ONLY
protected static java.lang.String	KE_INSERT_READ_ONLY
protected static java.lang.String	KE_SAVE_READ_ONLY
protected static java.lang.String	KE_UPDATE_READ_ONLY
protected boolean	logOn
protected java.lang.String	logTag
static java.lang.String	MODEL_LOG_PATTERN
static java.lang.String	MODEL_NOT_IMPL
protected java.util.HashMap<KittyArrayKey,InsertValuesStatement>	precompiledInserts
protected static java.lang.String	QE_COUNT
protected static java.lang.String	QE_DELETE_ALL
protected static java.lang.String	QE_DELETE_ALL_FAKE_QUERY
protected static java.lang.String	QE_DELETE_BY_WHERE
protected static java.lang.String	QE_DELETE_FAKE_QUERY
protected static java.lang.String	QE_EXECUTE_RAW_QUERY
protected static java.lang.String	QE_FIND_WITH_RAW_QUERY
protected static java.lang.String	QE_INSERT
protected static java.lang.String	QE_INSERT_FAKE_QUERY
protected static java.lang.String	QE_SUM
protected static java.lang.String	QE_UPDATE
protected static java.lang.String	QE_UPDATE_FAKE_QUERY
static java.lang.String	QUERY_LOG_PATTERN
protected boolean	returnNullNotEmptyCollection
protected boolean	rowidOn
protected KittyTableConfiguration	tableConfig Table configuration
protected static java.lang.String	UPDATE_PL

Constructor Summary

Constructors

Constructor and Description
KittyMapper(KittyTableConfiguration tableConfiguration, M blankModelInstance, java.lang.String databasePassword)

Method Summary

Modifier and Type	Method and Description
KittyMapper	clone() Cloning implementation
<D extends KittyMapper> D	clone(java.lang.Class<D> recordClass) Cloning implementation with generic
protected <M extends KittyModel> M	cloneModel(java.lang.Class<M> modelClass) Clones blank model associated with this data mapper
void	close() Closes current db
protected SQLiteCondition	conditionFromSQLString(java.lang.String condition, java.lang.Object... params) Generates instance of SQLiteCondition from SQLite string and set of parameters.
long	countAll() Counts all records in table.
long	countAll(QueryParameters qParams) Counts all records in table.
long	countWhere(QueryParameters qParams, java.lang.String condition, java.lang.Object... conditionValues) Counts record's amount of those records that suits provided condition.
long	countWhere(SQLiteCondition where) Counts record's amount of those records that suits provided condition.
long	countWhere(SQLiteCondition where, QueryParameters qParams) Counts record's amount of those records that suits provided condition.
long	countWhere(java.lang.String condition, java.lang.Object... conditionValues) Counts record's amount of those records that suits provided condition.
<M extends KittyModel> void	delete(KittyMapper.TRANSACTION_MODES txMode, java.util.List<M> models) Deletes all rows that represented by provided model's list.
<M extends KittyModel> void	delete(java.util.List<M> models) Deletes all rows that represented by provided model's list.
<M extends KittyModel> long	delete(M model) Deletes row that represented by provided model.
long	deleteAll() Deletes all rows in table associated with this data mapper.
long	deleteByIPK(java.lang.Long id) Deletes row in database's table depending on provided INTEGER PRIMARY KEY value.
long	deleteByPK(KittyPrimaryKey pk) Deletes row in database's table depending on values in provided PK.
long	deleteByRowID(java.lang.Long rowid) Deletes row in database's table depending on provided RowID.
<M extends KittyModel> void	deleteInTransaction(java.util.List<M> models) Deletes all rows that represented by provided model's list.
long	deleteWhere(SQLiteCondition condition) Deletes all rows in table associated with this data mapper that suit provided condition.
long	deleteWhere(java.lang.String condition, java.lang.Object... conditionValues) Deletes all rows in table associated with this data mapper that suit provided condition.
void	executeRawQuery(java.lang.String querySQL, java.lang.String... parameters) Execute a single SQL statement that is NOT a SELECT/INSERT/UPDATE/DELETE.
<M extends KittyModel> java.util.List<M>	findAll() Returns list of all models associated with records in backed database table.
<M extends KittyModel> java.util.List<M>	findAll(QueryParameters qParams) Returns list of all models associated with records in backed database table with usage of passed qParams.
<M extends KittyModel> M	findByIPK(java.lang.Long ipk) Returns model filled with data from database or null if no record with provided IPK found.
<M extends KittyModel> M	findByPK(KittyPrimaryKey primaryKey) Returns model filled with data from database or null if no record with provided PK (KittyPrimaryKey) found.
<M extends KittyModel> M	findByPKV(java.util.Map<java.lang.String,java.lang.String> pkv) Returns model filled with data from database or null if no record with provided PK MAP (KittyPrimaryKey.getPrimaryKeyColumnValues()) found.
<M extends KittyModel> M	findByRowID(java.lang.Long rowid) Returns model filled with data from database or null if no record with provided rowid found.
<M extends KittyModel> M	findFirst() Returns first record in KittyModel wrapper in database table that suits provided condition.
<M extends KittyModel> M	findFirst(SQLiteCondition where) Returns first record in KittyModel wrapper in database table that suits provided condition.
<M extends KittyModel> M	findFirst(java.lang.String condition, java.lang.Object... conditionValues) Returns first record in KittyModel wrapper in database table that suits provided condition.
<M extends KittyModel> M	findLast() Returns last record in KittyModel wrapper in database table that suits provided condition.
<M extends KittyModel> M	findLast(SQLiteCondition where) Returns last record in KittyModel wrapper in database table that suits provided condition.
<M extends KittyModel> M	findLast(java.lang.String condition, java.lang.Object... conditionValues) Returns last record in KittyModel wrapper in database table that suits provided condition.
<M extends KittyModel> java.util.List<M>	findWhere(QueryParameters qParams, java.lang.String condition, java.lang.Object... conditionValues) Returns list of models that suits provided condition string and query parameters.
<M extends KittyModel> java.util.List<M>	findWhere(SQLiteCondition where) Returns list of models that suits provided conditions.
<M extends KittyModel> java.util.List<M>	findWhere(SQLiteCondition where, QueryParameters qParams) Returns list of models that suits provided conditions and query parameters.
<M extends KittyModel> java.util.List<M>	findWhere(java.lang.String condition, java.lang.Object... conditionValues) Returns list of models that suits provided condition string.
<M extends KittyModel> java.util.List<M>	findWithRawQuery(boolean rowIdSupport, KittySQLiteQuery query) Tries to fetch data from database table with provided query and wrap it into collection of models.
void	finishTransaction() Trying to finish transaction, sets transaction successful and if failed than throws KittyRuntimeException that holds original exception.
protected <M extends KittyModel> M	getBlankModelInstance() Creates new model via default constructor You should rewrite it, I suppose, for better performance cause it uses one more reflection magic piece, however, you know, it makes model classes more pretty to look also, if you are big fan of entropy and want to make death of universe closer, you also can rewrite this method for parametrized models with Context for serializing objects to be stored in databaseClass (you're sick!)
KittyColumnConfiguration	getColumnByFieldName(java.lang.String fieldName) Returns column name associated with model field name or null if nothing found
protected <M extends KittyModel> InsertValuesStatement	getInsertStatement(M model)
protected SQLiteCondition	getIPKCondition(java.lang.Long id) Creates condition "WHERE {IPK} = ?"
protected <M extends KittyModel> java.lang.Class<M>	getModelClass() Returns model class associated with this mapper child
protected <M extends KittyModel> SQLiteCondition	getPKCondition(M model, SQLiteCondition defaultCondition) Returns PK condition for provided model, there are following steps: If provided default condition not null, it would be returned.
protected <M extends KittyModel> java.util.Map<java.lang.String,java.lang.String>	getPrimaryKeyValuesForModel(M model) Tries to return primary key values from provided model as map where keys are column names of PK and values are string representations of PK's values from model's fields.
protected SQLiteCondition	getRowIDCondition(java.lang.Long id) Creates condition "WHERE rowid = ?"
protected <M extends KittyModel> SQLiteCondition	getRowIDCondition(M model) Creates condition "WHERE rowid = ?"
protected SQLiteCondition	getSQLiteConditionForPK(KittyPrimaryKey primaryKey) Returns SQLiteCondition from provided PK's map where keys of map are column's names of table and values are values of those columns.
protected SQLiteCondition	getSQLiteConditionForPKKeyValues(java.util.Map<java.lang.String,java.lang.String> pkKeyValues) Returns SQLiteCondition from provided map where keys of map are column's names of table and values are values of those columns.
void	getWritableDatabase() Opens current db
void	getWritableDatabase(java.lang.String pwd) Opens current encrypted db with provided password
<M extends KittyModel> void	insert(KittyMapper.TRANSACTION_MODES txMode, java.util.List<M> models) Inserts models in provided list into database table in new transaction.
<M extends KittyModel> void	insert(java.util.List<M> models) Inserts models in provided list into database table.
<M extends KittyModel> long	insert(M model) Inserts into database provided model's values.
<M extends KittyModel> void	insertInTransaction(java.util.List<M> models) Inserts models in provided list into database table in internal method transaction started with transaction mode KittyMapper.TRANSACTION_MODES.EXCLUSIVE_MODE.
boolean	isTransactionON() Returns transaction state.
protected <M extends KittyModel> void	logModel(java.lang.String executor, M model) Logs model to log if logOn and !
static <M extends KittyModel> void	logModel(java.lang.String executor, M model, java.lang.String logTag, boolean logOn, boolean productionOn, java.lang.Object helper, java.lang.String schemaName, int schemaVersion) Logs model to log depends on parameter flags
protected void	logQuery(java.lang.String executor, KittySQLiteQuery query) Logs query or fake query to log
static void	logQuery(java.lang.String executor, KittySQLiteQuery query, java.lang.String logTag, boolean logOn, boolean productionMode, java.lang.Object helper, java.lang.String schemaName, int schemaVersion) Logs query to log depends on parameter flags
protected java.lang.String	pkvMapToString(java.util.Map<java.lang.String,java.lang.String> pkv) Returns string like '( key1 = value1 ; key2 = value2 )' for provided pkv.
<M extends KittyModel> void	save(KittyMapper.TRANSACTION_MODES txMode, java.util.List<M> models) Saves values from provided list of models into database.
<M extends KittyModel> void	save(java.util.List<M> models) Saves values from provided list of models into database.
<M extends KittyModel> void	save(M model) Saves data from provided model into database table.
<M extends KittyModel> void	saveInTransaction(java.util.List<M> models) Saves values from provided list of models into database.
<H extends KittyDatabaseHelper> KittyMapper	setDatabaseHelper(H helper)
void	setLogOn(boolean logOn)
void	setLogTag(java.lang.String logTag)
void	setReturnNullNotEmptyCollection(boolean returnNullNotEmptyCollection) Defines what would be returned by fetch methods in cases when nothing found in database table.
void	setRowIDSupport(boolean rowIDSupport) Sets rowid support.
void	startTransaction() Starts transaction on current database instance in KittyMapper.TRANSACTION_MODES.EXCLUSIVE_MODE.
void	startTransaction(KittyMapper.TRANSACTION_MODES mode) Starts transaction on current database instance.
long	sum(java.lang.String sumColumn, QueryParameters qParams, java.lang.String condition, java.lang.Object... conditionValues) Sum all values in table in specified column that suits provided condition and additional query qParams.
long	sum(java.lang.String sumColumn, SQLiteCondition where) Sum all values in table in specified column that suits provided condition.
long	sum(java.lang.String sumColumn, SQLiteCondition where, QueryParameters qParams) Sum all values in table in specified column that suits provided condition and additional query qParams.
long	sum(java.lang.String sumColumn, java.lang.String condition, java.lang.Object... conditionValues) Sum all values in table in specified column that suits provided condition and additional query qParams.
long	sumAll(java.lang.String sumColumn) Sum all values in table in specified column.
long	sumAll(java.lang.String sumColumn, QueryParameters qParams) Sum all values in table in specified column that suits provided additional query qParams.
void	throwExcReadOPWhileInTransaction() Call this method in read OP to throw exception if in transaction
<M extends KittyModel> void	update(KittyMapper.TRANSACTION_MODES txMode, java.util.List<M> models) Updates values in database with values from models from provided list in new transaction..
<M extends KittyModel> long	update(java.util.List<M> models) Update records from database with values from provided list of model.
<M extends KittyModel> long	update(M model) Update records from database with values from provided model.
<M extends KittyModel> long	update(M model, SQLiteCondition condition) Update records from database with values from provided model that suits provided condition.
<M extends KittyModel> long	update(M model, SQLiteCondition condition, java.lang.String[] names, int IEFlag) Update records from database with values from provided model that suits provided condition.
<M extends KittyModel> long	update(M model, java.lang.String[] names, int IEFlag, java.lang.String condition, java.lang.Object... conditionValues) See update(KittyModel, SQLiteCondition, String[], int) for more info
<M extends KittyModel> long	update(M model, java.lang.String condition, java.lang.Object... conditionValues)
<M extends KittyModel> void	updateInTransaction(java.util.List<M> models) Updates rows in database with models from provided list in internal method transaction started with transaction mode KittyMapper.TRANSACTION_MODES.EXCLUSIVE_MODE.

Methods inherited from class java.lang.Object

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

Field Detail

conditionBuilder

protected final SQLiteConditionBuilder conditionBuilder

Condition builder

insertPKExclusions

protected final java.util.List<java.lang.String> insertPKExclusions

tableConfig

protected final KittyTableConfiguration tableConfig

Table configuration

cursorToModelFactory

protected final KittyModelCVFactory cursorToModelFactory

Cursor to model factory

blankModelInstance

protected final KittyModel blankModelInstance

Blank model to be used with this mapper

databaseHelper

protected KittyDatabaseHelper databaseHelper

databasePassword

protected final java.lang.String databasePassword

database

protected android.database.sqlite.SQLiteDatabase database

rowidOn

protected boolean rowidOn

logOn

protected boolean logOn

logTag

protected java.lang.String logTag

returnNullNotEmptyCollection

protected boolean returnNullNotEmptyCollection

precompiledInserts

protected final java.util.HashMap<KittyArrayKey,InsertValuesStatement> precompiledInserts

columnConfigurations

protected final java.util.HashMap<java.lang.String,KittyColumnConfiguration> columnConfigurations

QE_COUNT

protected static final java.lang.String QE_COUNT

See Also:

Constant Field Values

QE_SUM

protected static final java.lang.String QE_SUM

See Also:

Constant Field Values

QE_INSERT

protected static final java.lang.String QE_INSERT

See Also:

Constant Field Values

QE_INSERT_FAKE_QUERY

protected static final java.lang.String QE_INSERT_FAKE_QUERY

See Also:

Constant Field Values

INS_PL

protected static java.lang.String INS_PL

KE_INSERT_READ_ONLY

protected static final java.lang.String KE_INSERT_READ_ONLY

See Also:

Constant Field Values

QE_UPDATE

protected static final java.lang.String QE_UPDATE

See Also:

Constant Field Values

QE_UPDATE_FAKE_QUERY

protected static final java.lang.String QE_UPDATE_FAKE_QUERY

See Also:

Constant Field Values

UPDATE_PL

protected static final java.lang.String UPDATE_PL

See Also:

Constant Field Values

KE_UPDATE_READ_ONLY

protected static final java.lang.String KE_UPDATE_READ_ONLY

See Also:

Constant Field Values

KE_SAVE_READ_ONLY

protected static final java.lang.String KE_SAVE_READ_ONLY

See Also:

Constant Field Values

QE_DELETE_ALL

protected static final java.lang.String QE_DELETE_ALL

See Also:

Constant Field Values

QE_DELETE_ALL_FAKE_QUERY

protected static final java.lang.String QE_DELETE_ALL_FAKE_QUERY

See Also:

Constant Field Values

QE_DELETE_BY_WHERE

protected static final java.lang.String QE_DELETE_BY_WHERE

See Also:

Constant Field Values

QE_DELETE_FAKE_QUERY

protected static final java.lang.String QE_DELETE_FAKE_QUERY

See Also:

Constant Field Values

DELETE_PL2

protected static java.lang.String DELETE_PL2

DELETE_PL

protected static java.lang.String DELETE_PL

KE_DELETE_READ_ONLY

protected static final java.lang.String KE_DELETE_READ_ONLY

See Also:

Constant Field Values

QE_FIND_WITH_RAW_QUERY

protected static final java.lang.String QE_FIND_WITH_RAW_QUERY

See Also:

Constant Field Values

QE_EXECUTE_RAW_QUERY

protected static final java.lang.String QE_EXECUTE_RAW_QUERY

See Also:

Constant Field Values

QUERY_LOG_PATTERN

public static final java.lang.String QUERY_LOG_PATTERN

See Also:

Constant Field Values

MODEL_LOG_PATTERN

public static final java.lang.String MODEL_LOG_PATTERN

See Also:

Constant Field Values

MODEL_NOT_IMPL

public static final java.lang.String MODEL_NOT_IMPL

See Also:

Constant Field Values

Constructor Detail

KittyMapper

public KittyMapper(KittyTableConfiguration tableConfiguration,
                   M blankModelInstance,
                   java.lang.String databasePassword)

Method Detail

setDatabaseHelper

public final <H extends KittyDatabaseHelper> KittyMapper setDatabaseHelper(H helper)

setReturnNullNotEmptyCollection

public final void setReturnNullNotEmptyCollection(boolean returnNullNotEmptyCollection)

Defines what would be returned by fetch methods in cases when nothing found in database table. So, if passed true than if result set for select query contains no rows than NULL would be returned. Otherwise (false passed as parameter) empty collection would be returned in such cases.
By default it is false

Parameters:

returnNullNotEmptyCollection -

setLogOn

public final void setLogOn(boolean logOn)

setLogTag

public final void setLogTag(java.lang.String logTag)

setRowIDSupport

public final void setRowIDSupport(boolean rowIDSupport)

Sets rowid support. That means that each SELECT query would for kitty model would be like SELECT rowid, * and each model selected from database table would have KittyModel.rowid value set. Also, if rowid not null that means that all operations with current models already fetched from db (delete\\update) would be done through rowid (that faster than fecthing PK values via reflection)

Parameters:

rowIDSupport - flag if rowid on or off (by default rowid is ON)

getWritableDatabase

public void getWritableDatabase()

Opens current db

getWritableDatabase

public void getWritableDatabase(java.lang.String pwd)

Opens current encrypted db with provided password

Parameters:

pwd -

close

public void close()

Closes current db

startTransaction

public final void startTransaction(KittyMapper.TRANSACTION_MODES mode)

Starts transaction on current database instance. That means that all write operations on DB would be accumulated to buffer and written to DB only after ending transaction (finishTransaction()).
While in transaction, only insert, update, save and create methods are available. Calling read methods while in transaction would cause KittyRuntimeException.

Parameters:

mode - mode to start with, following modes are available:
KittyMapper.TRANSACTION_MODES.EXCLUSIVE_MODE - starting with this mode would start transaction in exclusive mode (SQLiteDatabase.beginTransaction())
KittyMapper.TRANSACTION_MODES.NON_EXCLUSIVE_MODE - starting with this mode would start transaction in immediate mode, this mode requires api 11 and higher (SQLiteDatabase.beginTransactionNonExclusive()). If current api level lower than api 11 than transaction would be started in KittyMapper.TRANSACTION_MODES.EXCLUSIVE_MODE
KittyMapper.TRANSACTION_MODES.LOCKING_FALSE_MODE - starting transaction with false locking option (SQLiteDatabase.setLockingEnabled(boolean)).

Throws:

KittyRuntimeException - if trying to start transaction when transaction already started

getInsertStatement

protected <M extends KittyModel> InsertValuesStatement getInsertStatement(M model)

startTransaction

public final void startTransaction()

Starts transaction on current database instance in KittyMapper.TRANSACTION_MODES.EXCLUSIVE_MODE. That means that all write operations on DB would be accumulated to buffer and written to DB only after ending transaction (finishTransaction()).
While in transaction, only insert, update, save and create methods are available. Calling read methods while in transaction would cause KittyRuntimeException.

finishTransaction

public final void finishTransaction()

Trying to finish transaction, sets transaction successful and if failed than throws KittyRuntimeException that holds original exception.

isTransactionON

public final boolean isTransactionON()

Returns transaction state.

Returns:

true if in transaction, otherwise false

throwExcReadOPWhileInTransaction

public final void throwExcReadOPWhileInTransaction()

Call this method in read OP to throw exception if in transaction

findWhere

public final <M extends KittyModel> java.util.List<M> findWhere(QueryParameters qParams,
                                                                java.lang.String condition,
                                                                java.lang.Object... conditionValues)

Returns list of models that suits provided condition string and query parameters. Select query. If no records found in db with passed condition and parameters than null would be returned.

Parameters:

qParams - additional query parameters (offset, limit, ordering etc), can be null

condition - sqlite condition string in format `column_name = ? AND #?fieldName = ?`

conditionValues - parameters for condition str

Returns:

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findWhere

public final <M extends KittyModel> java.util.List<M> findWhere(java.lang.String condition,
                                                                java.lang.Object... conditionValues)

Returns list of models that suits provided condition string. Select query. If no records found in db with passed condition and parameters than null would be returned.

Parameters:

condition - sqlite condition string in format `column_name = ? AND #?fieldName = ?`

conditionValues - parameters for condition str

Returns:

list of models or null if nothing found and returnNullNotEmptyCollection is on

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findWhere

public final <M extends KittyModel> java.util.List<M> findWhere(SQLiteCondition where,
                                                                QueryParameters qParams)

Returns list of models that suits provided conditions and query parameters. Select query. If no records found in db with passed condition and parameters than null would be returned.

Parameters:

where - condition, can be null

qParams - additional query parameters (offset, limit, ordering etc), can be null

Returns:

list of models or null if nothing found and returnNullNotEmptyCollection is on

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findWhere

public final <M extends KittyModel> java.util.List<M> findWhere(SQLiteCondition where)

Returns list of models that suits provided conditions. Select query. If no records found in db with passed condition than null would be returned.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere(where, null)

Parameters:

where - condition, can be null

Returns:

list of models or null if nothing found and returnNullNotEmptyCollection is on

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findAll

public final <M extends KittyModel> java.util.List<M> findAll(QueryParameters qParams)

Returns list of all models associated with records in backed database table with usage of passed qParams.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere(null, qParams)

Parameters:

qParams - query params such as limit, offset etc, can be null

Returns:

list of all models fetched according to passed params or null if nothing found and returnNullNotEmptyCollection is on

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findAll

public final <M extends KittyModel> java.util.List<M> findAll()

Returns list of all models associated with records in backed database table.

Returns:

list of all models associated with backed database table or null if nothing found and returnNullNotEmptyCollection is on

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findByRowID

public final <M extends KittyModel> M findByRowID(java.lang.Long rowid)

Returns model filled with data from database or null if no record with provided rowid found.
If more than one value found for provided rowid or getRowIDCondition(Long) returned null, KittyRuntimeException would be thrown.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere("rowid = ?", null).get(0) with check that resulting collection's size == 0 | 1

Parameters:

rowid - RowID of database table's record to fetch

Returns:

model filled from record in db's table or null if nothing found.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findByPK

public final <M extends KittyModel> M findByPK(KittyPrimaryKey primaryKey)

Returns model filled with data from database or null if no record with provided PK (KittyPrimaryKey) found.
If more than one value found for provided PK or getSQLiteConditionForPKKeyValues(Map) returned null, KittyRuntimeException would be thrown.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere({PKCondition}, null).get(0) with check that resulting collection's size == 0 | 1

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

primaryKey - primary key filled with values, also notice that there is no check for PK

Returns:

model filled from record in db's table or null if nothing found.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findByPKV

public final <M extends KittyModel> M findByPKV(java.util.Map<java.lang.String,java.lang.String> pkv)

Returns model filled with data from database or null if no record with provided PK MAP (KittyPrimaryKey.getPrimaryKeyColumnValues()) found.
If more than one value found for provided PK values or getSQLiteConditionForPKKeyValues(Map) returned null, KittyRuntimeException would be thrown.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere({PKCondition}, null).get(0) with check that resulting collection's size == 0 | 1

Parameters:

pkv - primary key values map, also notice that there is no check for PK values

Returns:

model filled from record in db's table or null if nothing found.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findByIPK

public final <M extends KittyModel> M findByIPK(java.lang.Long ipk)

Returns model filled with data from database or null if no record with provided IPK found.
If more than one value found for provided IPK or getIPKCondition(Long) returned null, KittyRuntimeException would be thrown.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere("{IPK} = ?", null).get(0) with check that resulting collection's size == 0 | 1

Parameters:

ipk - INTEGER PRIMARY KEY value of database table's record to fetch

Returns:

model filled from record in db's table or null if nothing found.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findFirst

public final <M extends KittyModel> M findFirst(SQLiteCondition where)

Returns first record in KittyModel wrapper in database table that suits provided condition.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere(conditions, {LIMIT = 1, ORDER BY rowid ASCENDING}

Parameters:

where - SQLiteCondition for select

Returns:

model filled from first record in db's table that suits provided condition or null if nothing found.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findFirst

public final <M extends KittyModel> M findFirst(java.lang.String condition,
                                                java.lang.Object... conditionValues)

Returns first record in KittyModel wrapper in database table that suits provided condition.
Alias for findWhere(QueryParameters, String, Object...) (findWhere({LIMIT = 1, ORDER BY rowid ASCENDING}, conditionStr, conditionValues)

Parameters:

condition - sqlite condition string in format `column_name = ? AND #?fieldName = ?`

conditionValues - parameters for condition str

Returns:

model filled from first record in db's table that suits provided condition or null if nothing found.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findFirst

public final <M extends KittyModel> M findFirst()

Returns first record in KittyModel wrapper in database table that suits provided condition.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere(null, {LIMIT = 1, ORDER BY rowid ASCENDING}

Returns:

model filled from first record in db's table or null if nothing found.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findLast

public final <M extends KittyModel> M findLast(SQLiteCondition where)

Returns last record in KittyModel wrapper in database table that suits provided condition.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere(conditions, {LIMIT = 1, ORDER BY rowid DESCENDING}

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

where - SQLiteCondition for select

Returns:

model filled from last record in db's table that suits provided condition or null if nothing found.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findLast

public final <M extends KittyModel> M findLast(java.lang.String condition,
                                               java.lang.Object... conditionValues)

Returns last record in KittyModel wrapper in database table that suits provided condition.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere({LIMIT = 1, ORDER BY rowid DESCENDING}, conditionStr, conditionValues))

Parameters:

condition - sqlite condition string in format `column_name = ? AND #?fieldName = ?`

conditionValues - parameters for condition str

Returns:

model filled from last record in db's table that suits provided condition or null if nothing found.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

findLast

public final <M extends KittyModel> M findLast()

Returns last record in KittyModel wrapper in database table that suits provided condition.
Alias for findWhere(SQLiteCondition, QueryParameters) (findWhere(null, {LIMIT = 1, ORDER BY rowid DESCENDING}

Type Parameters:

M - instance of non abstract child of KittyModel

Returns:

model filled from last record in db's table or null if nothing found.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

countWhere

public final long countWhere(SQLiteCondition where,
                             QueryParameters qParams)

Counts record's amount of those records that suits provided condition.

Parameters:

where - SQLite condition, may be null

qParams - query qParams, may be null

Returns:

record's amount of those records that suits provided condition.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

countWhere

public final long countWhere(QueryParameters qParams,
                             java.lang.String condition,
                             java.lang.Object... conditionValues)

Counts record's amount of those records that suits provided condition.

Parameters:

qParams - query qParams, may be null

condition - sqlite condition string in format `column_name = ? AND #?fieldName = ?`

conditionValues - parameters for condition str

Returns:

record's amount of those records that suits provided condition.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

countWhere

public final long countWhere(java.lang.String condition,
                             java.lang.Object... conditionValues)

Counts record's amount of those records that suits provided condition.

Parameters:

condition - sqlite condition string in format `column_name = ? AND #?fieldName = ?`

conditionValues - parameters for condition str

Returns:

record's amount of those records that suits provided condition.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

countWhere

public final long countWhere(SQLiteCondition where)

Counts record's amount of those records that suits provided condition.
Alias for countWhere(SQLiteCondition, QueryParameters) (countWhere(condition, null)

Parameters:

where - SQLite condition, may be null

Returns:

record's amount of those records that suits provided condition.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

countAll

public final long countAll(QueryParameters qParams)

Counts all records in table.
Alias for countWhere(SQLiteCondition, QueryParameters) (countWhere(null, qParams)

Parameters:

qParams - query parameters such as OFFSET, LIMIT etc

Returns:

count of all records in table.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

countAll

public final long countAll()

Counts all records in table.
Alias for countWhere(SQLiteCondition, QueryParameters) (countWhere(null, null)

Returns:

count of all records in table.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

sum

public final long sum(java.lang.String sumColumn,
                      QueryParameters qParams,
                      java.lang.String condition,
                      java.lang.Object... conditionValues)

Sum all values in table in specified column that suits provided condition and additional query qParams.

Parameters:

sumColumn -

qParams -

condition -

conditionValues -

Returns:

sum

public final long sum(java.lang.String sumColumn,
                      java.lang.String condition,
                      java.lang.Object... conditionValues)

Sum all values in table in specified column that suits provided condition and additional query qParams.

Parameters:

sumColumn -

condition -

conditionValues -

Returns:

sum

public final long sum(java.lang.String sumColumn,
                      SQLiteCondition where,
                      QueryParameters qParams)

Sum all values in table in specified column that suits provided condition and additional query qParams.

Parameters:

sumColumn - column name from where should be values summed

where - SQLite condition for SUM

qParams - additional query qParams

Returns:

sum of values in table in specified column that suits provided condition and additional query qParams.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

sum

public final long sum(java.lang.String sumColumn,
                      SQLiteCondition where)

Sum all values in table in specified column that suits provided condition.
Alias for sum(String, SQLiteCondition, QueryParameters) (sum(colName, condition, null).

Parameters:

sumColumn - column name from where should be values summed

where - SQLite condition for SUM

Returns:

sum of values in table in specified column that suits provided condition.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

sumAll

public final long sumAll(java.lang.String sumColumn,
                         QueryParameters qParams)

Sum all values in table in specified column that suits provided additional query qParams.
Alias for sum(String, SQLiteCondition, QueryParameters) (sum(colName, null, qParams).

Parameters:

sumColumn - column name from where should be values summed

qParams - additional query qParams

Returns:

sum of values in table in specified column that suits provided additional query qParams.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

sumAll

public final long sumAll(java.lang.String sumColumn)

Sum all values in table in specified column.
Alias for sum(String, SQLiteCondition, QueryParameters) (sum(colName, null, null).

Parameters:

sumColumn - column name from where should be values summed

Returns:

sum of values in table in specified column.

Throws:

KittyRuntimeException - if there some errors, if KittyRuntimeException was caused by another exception than first exception can be fetched by KittyRuntimeException.getNestedException()

insert

public final <M extends KittyModel> long insert(M model)

Inserts into database provided model's values. No checks on auto generated values of PK fields performed. May throw exceptions related to reflection access to fields wrapped in KittyRuntimeException.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

model - model to inserts

Returns:

RowID of inserted record, or -1 if error occurred

insert

public final <M extends KittyModel> void insert(java.util.List<M> models)

Inserts models in provided list into database table.
May throw exceptions related to reflection access to fields wrapped in KittyRuntimeException.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

models - list of models to insert

insertInTransaction

public final <M extends KittyModel> void insertInTransaction(java.util.List<M> models)

Inserts models in provided list into database table in internal method transaction started with transaction mode KittyMapper.TRANSACTION_MODES.EXCLUSIVE_MODE.
Alias for insert(TRANSACTION_MODES, List) insert(TRANSACTION_MODES.EXCLUSIVE_MODE, models)
May throw exceptions related to reflection access to fields wrapped in KittyRuntimeException.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

models - list of models to insert

insert

public final <M extends KittyModel> void insert(KittyMapper.TRANSACTION_MODES txMode,
                                                java.util.List<M> models)

Inserts models in provided list into database table in new transaction.
If there is already existing transaction than this transaction would be used.
If provided txMode is null than no transaction would be started.
If no transaction exists than new transaction would be created and finished in this method.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

txMode - transaction mode, see startTransaction(TRANSACTION_MODES) for modes info

models - list of models to insert

update

public final <M extends KittyModel> long update(M model,
                                                SQLiteCondition condition,
                                                java.lang.String[] names,
                                                int IEFlag)

Update records from database with values from provided model that suits provided condition.
This method would generate an update statement that would be applied to all record in database that suits provided condition. By default would be an attempt to update all database records with values from all model fields annotated with KITTY_COLUMN.
If no condition available (condition parameter is NULL) then update operation would be applied to ALL records in database

You can use this method for generating classic SQL update queries by passing model with set fields to be updated, names array that contains column or model field names to include\exclude in statement generation and flag that defines inclusion\exclusion tactic.
For example, you have model with following fields:

1. firstName (columnName = "first_name")
2. secondName (columnName = "second_name")
3. telNumber (columnName = "tel_number")

And you want for some reason set to all Johnsons tel. 8800555355

So you set to model field telNumber to 8800555355

Then you set names array to {"tel_number"} and pass CVUtils.INCLUDE_ONLY_SELECTED_COLUMN_NAMES
or
set names array to {"telNumber"} and pass CVUtils.INCLUDE_ONLY_SELECTED_FIELDS

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

model - model to update

condition - condition for that model

names - array of fields names or column names to include\exclude

IEFlag - flag that determines what to do with provided KittyColumnConfiguration instance, may be CVUtils.IGNORE_INCLUSIONS_AND_EXCLUSIONS, CVUtils.INCLUDE_ALL_EXCEPT_SELECTED_COLUMN_NAMES, CVUtils.INCLUDE_ONLY_SELECTED_COLUMN_NAMES, CVUtils.INCLUDE_ALL_EXCEPT_SELECTED_FIELDS or CVUtils.INCLUDE_ONLY_SELECTED_FIELDS. If flag's value differs from any of inclusion predefined flags than would be used default flag (CVUtils.IGNORE_INCLUSIONS_AND_EXCLUSIONS)

Returns:

the number of rows affected

update

public final <M extends KittyModel> long update(M model,
                                                java.lang.String[] names,
                                                int IEFlag,
                                                java.lang.String condition,
                                                java.lang.Object... conditionValues)

See update(KittyModel, SQLiteCondition, String[], int) for more info

Type Parameters:

M -

Parameters:

model -

names -

IEFlag -

condition -

conditionValues -

Returns:

update

public final <M extends KittyModel> long update(M model,
                                                SQLiteCondition condition)

Update records from database with values from provided model that suits provided condition.
If you use your own condition make sure that you know what are you doing cause in that case would be generated an update statement that can update all records in table that suit provided condition.
If provided condition is null than would be attempt to get RowID condition.
If no RowID found than would be attempt to get PK condition.
If no PK condition exists than KittyRuntimeException would be thrown.

Type Parameters:

M -

Parameters:

model -

condition -

Returns:

update

public final <M extends KittyModel> long update(M model,
                                                java.lang.String condition,
                                                java.lang.Object... conditionValues)

update

public final <M extends KittyModel> long update(M model)

Update records from database with values from provided model.
If no RowID found than would be attempt to get PK condition.
If no PK condition exists than KittyRuntimeException would be thrown.
Alias for update(KittyModel, SQLiteCondition) update(model, null)

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

model - model to update

Returns:

the number of affected rows

update

public final <M extends KittyModel> long update(java.util.List<M> models)

Update records from database with values from provided list of model.
If no RowID found than would be attempt to get PK condition.
If no PK condition exists than KittyRuntimeException would be thrown.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

models - list of models to update

update

public final <M extends KittyModel> void update(KittyMapper.TRANSACTION_MODES txMode,
                                                java.util.List<M> models)

Updates values in database with values from models from provided list in new transaction..
Foreach model:
If no RowID found than would be attempt to get PK condition.
If no PK condition exists than KittyRuntimeException would be thrown.
If there is already existing transaction than this transaction would be used.
If provided txMode is null than no transaction would be started.
If no transaction exists than new transaction would be created and finished in this method.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

txMode - transaction mode, see startTransaction(TRANSACTION_MODES) for modes info

models - list of models to update

updateInTransaction

public final <M extends KittyModel> void updateInTransaction(java.util.List<M> models)

Updates rows in database with models from provided list in internal method transaction started with transaction mode KittyMapper.TRANSACTION_MODES.EXCLUSIVE_MODE.
Alias for update(TRANSACTION_MODES, List) (update(TRANSACTION_MODES.EXCLUSIVE_MODE, models)
May throw exceptions related to reflection access to fields wrapped in KittyRuntimeException.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

models - list of models to update

save

public final <M extends KittyModel> void save(M model)

Saves data from provided model into database table.
If provided model has RowID set or auto generated PK values set than update(KittyModel) would be called.
If provided model has no RowID or auto generated PK values set than insert(KittyModel) would be called.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

model - model to save

save

public final <M extends KittyModel> void save(java.util.List<M> models)

Saves values from provided list of models into database. Foreach model in collection save(KittyModel) method would be called.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

models - list of models to save

save

public final <M extends KittyModel> void save(KittyMapper.TRANSACTION_MODES txMode,
                                              java.util.List<M> models)

Saves values from provided list of models into database. Foreach model in collection save(KittyModel) method would be called. Insert\\update operations would be run in internal method transaction.
If there is already existing transaction than this transaction would be used.
If provided txMode is null than no transaction would be started.
If no transaction exists than new transaction would be created and finished in this method.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

txMode - transaction mode, see startTransaction(TRANSACTION_MODES) for modes info

models - list of models to save

saveInTransaction

public final <M extends KittyModel> void saveInTransaction(java.util.List<M> models)

Saves values from provided list of models into database. Foreach model in collection save(KittyModel) method would be called. Insert\\update operations would be run in internal method transaction started with transaction mode KittyMapper.TRANSACTION_MODES.EXCLUSIVE_MODE.
Alias for save(TRANSACTION_MODES, List) (save(TRANSACTION_MODES.EXCLUSIVE_MODE, models)
May throw exceptions related to reflection access to fields wrapped in KittyRuntimeException.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

models - list of models to save

deleteAll

public final long deleteAll()

Deletes all rows in table associated with this data mapper.

Returns:

rows affected

deleteWhere

public final long deleteWhere(java.lang.String condition,
                              java.lang.Object... conditionValues)

Deletes all rows in table associated with this data mapper that suit provided condition.

Parameters:

condition - not null

conditionValues -

Returns:

deleteWhere

public final long deleteWhere(SQLiteCondition condition)

Deletes all rows in table associated with this data mapper that suit provided condition.

Parameters:

condition - SQLite condition, not null

Returns:

rows affected

delete

public final <M extends KittyModel> long delete(M model)

Deletes row that represented by provided model. If model has no RowID or PK fields set KittyRuntimeException would be thrown.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

model - model to delete

Returns:

rows affected

delete

public final <M extends KittyModel> void delete(java.util.List<M> models)

Deletes all rows that represented by provided model's list. If any of model has no RowID or PK fields set KittyRuntimeException would be thrown.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

models - list of models to delete

delete

public final <M extends KittyModel> void delete(KittyMapper.TRANSACTION_MODES txMode,
                                                java.util.List<M> models)

Deletes all rows that represented by provided model's list. If any of model has no RowID or PK fields set KittyRuntimeException would be thrown. Delete operations would be run in internal method transaction.
If there is already existing transaction than this transaction would be used.
If provided txMode is null than no transaction would be started.
If no transaction exists than new transaction would be created and finished in this method.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

txMode - transaction mode, see startTransaction(TRANSACTION_MODES) for modes info

models - list of models to delete

deleteInTransaction

public final <M extends KittyModel> void deleteInTransaction(java.util.List<M> models)

Deletes all rows that represented by provided model's list. If any of model has no RowID or PK fields set KittyRuntimeException would be thrown. Delete operations would be run in internal method transaction started with transaction mode KittyMapper.TRANSACTION_MODES.EXCLUSIVE_MODE.
Alias for delete(TRANSACTION_MODES, List) (delete(TRANSACTION_MODES.EXCLUSIVE_MODE, models)
May throw exceptions related to reflection access to fields wrapped in KittyRuntimeException.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

models - list of models to delete

deleteByPK

public long deleteByPK(KittyPrimaryKey pk)

Deletes row in database's table depending on values in provided PK. If generated condition by method getSQLiteConditionForPK(KittyPrimaryKey) null than KittyRuntimeException would be thrown.

Parameters:

pk - primary key for generating delete condition.

Returns:

number of affected rows.

deleteByRowID

public long deleteByRowID(java.lang.Long rowid)

Deletes row in database's table depending on provided RowID. If generated condition by method getRowIDCondition(Long) null than KittyRuntimeException would be thrown.

Parameters:

rowid - row id

Returns:

count of affected rows

deleteByIPK

public long deleteByIPK(java.lang.Long id)

Deletes row in database's table depending on provided INTEGER PRIMARY KEY value. If generated condition by method getIPKCondition(Long) null than KittyRuntimeException would be thrown.

Parameters:

id - INTEGER PRIMARY KEY VALUE

Returns:

count of affected rows

findWithRawQuery

public final <M extends KittyModel> java.util.List<M> findWithRawQuery(boolean rowIdSupport,
                                                                       KittySQLiteQuery query)

Tries to fetch data from database table with provided query and wrap it into collection of models.

Type Parameters:

M - instance of non abstract child of KittyModel

Parameters:

rowIdSupport - RowID flag

query - sql query

Returns:

collection of models or null if nothing found and returnNullNotEmptyCollection is on

executeRawQuery

public final void executeRawQuery(java.lang.String querySQL,
                                  java.lang.String... parameters)

Execute a single SQL statement that is NOT a SELECT/INSERT/UPDATE/DELETE.

Parameters:

querySQL - the SQL statement to be executed. Multiple statements separated by semicolons are not supported.

parameters - only byte[], String, Long and Double are supported in bindArgs.

Throws:

android.database.SQLException - if the SQL string is invalid

getModelClass

protected final <M extends KittyModel> java.lang.Class<M> getModelClass()

Returns model class associated with this mapper child

Returns:

getBlankModelInstance

protected <M extends KittyModel> M getBlankModelInstance()

Creates new model via default constructor You should rewrite it, I suppose, for better performance cause it uses one more reflection magic piece, however, you know, it makes model classes more pretty to look also, if you are big fan of entropy and want to make death of universe closer, you also can rewrite this method for parametrized models with Context for serializing objects to be stored in databaseClass (you're sick!)

Returns:

cloneModel

protected <M extends KittyModel> M cloneModel(java.lang.Class<M> modelClass)

Clones blank model associated with this data mapper

Type Parameters:

M -

Parameters:

modelClass -

Returns:

clone

public <D extends KittyMapper> D clone(java.lang.Class<D> recordClass)

Cloning implementation with generic

Type Parameters:

D -

Parameters:

recordClass -

Returns:

clone

public KittyMapper clone()

Cloning implementation

Overrides:

clone in class java.lang.Object

Returns:

getPKCondition

protected final <M extends KittyModel> SQLiteCondition getPKCondition(M model,
                                                                      SQLiteCondition defaultCondition)

Returns PK condition for provided model, there are following steps:
If provided default condition not null, it would be returned.
If model's RowID set than condition would be "WHERE rowid = ?".
If model's getPrimaryKeyValues() not null than condition would be created from those values.
If model's RowID and getPrimaryKeyValues() null than DataMapper would try to acquire PK fields and values via reflection according to KittyPrimaryKey instance set in KittyTableConfiguration for provided model.
If no default condition, rowid, and no PK than null would be returned.

Type Parameters:

M - not abstract child of KittyModel

Parameters:

model - KittyModel child instance

defaultCondition - default condition, may be null, if not null than it would be returned

Returns:

SQLiteCondition that can fully define provided model as model in database (or null if it is impossible or provided SQLiteCondition passed as parameter if it is not null)

Throws:

KittyRuntimeException - throws exceptions wrapped into KittyRuntimeException

getSQLiteConditionForPK

protected final SQLiteCondition getSQLiteConditionForPK(KittyPrimaryKey primaryKey)

Returns SQLiteCondition from provided PK's map where keys of map are column's names of table and values are values of those columns. Returns null if provided PK's key value map null or has zero size.

Parameters:

primaryKey - PK with bounded values to use

Returns:

SQLiteCondition ready to use

getSQLiteConditionForPKKeyValues

protected final SQLiteCondition getSQLiteConditionForPKKeyValues(java.util.Map<java.lang.String,java.lang.String> pkKeyValues)

Returns SQLiteCondition from provided map where keys of map are column's names of table and values are values of those columns. Returns null if provided pkKeyValues null or has zero size.

Parameters:

pkKeyValues - map of column names and values to create SQLiteCondition

Returns:

SQLiteCondition ready to use

getPrimaryKeyValuesForModel

protected final <M extends KittyModel> java.util.Map<java.lang.String,java.lang.String> getPrimaryKeyValuesForModel(M model)

Tries to return primary key values from provided model as map where keys are column names of PK and values are string representations of PK's values from model's fields. If any of field's values of PK are NULL than ORM thinks that model is newly created so it is impossible to create PK condition from provided model. SQLite permits using NULL as values for PK, however SQL language not, so do I.

Type Parameters:

M - not abstract child of KittyModel

Parameters:

model - model from what should be PK condition be generated

Returns:

PK condition or null if it is impossible to create it

getIPKCondition

protected final SQLiteCondition getIPKCondition(java.lang.Long id)

Creates condition "WHERE {IPK} = ?" with provided model.

Parameters:

id -

Returns:

getRowIDCondition

protected final <M extends KittyModel> SQLiteCondition getRowIDCondition(M model)

Creates condition "WHERE rowid = ?" with provided model.getRowID. If id is null than null would be returned.

Type Parameters:

M - instance of not abstract child of KittyModel

Parameters:

model - model

Returns:

SQLiteCondition "WHERE rowid = ?"

getRowIDCondition

protected final SQLiteCondition getRowIDCondition(java.lang.Long id)

Creates condition "WHERE rowid = ?" with provided id. If id is null than null would be returned.

Parameters:

id - RowID value

Returns:

SQLiteCondition "WHERE rowid = ?"
I hate people. I hate myself. I have no friends, money or health.
I ran my company and it wasn't successful. I got good job and failed it. For three years I have no income. I moved to my parents and rent my apartments, working on two projects with some hope.
My first love was a whore (literally, she fucked with four guys and lied to all of them). Fucking first love. Bad days. You know when you are young
you're not spoiled enough and stupid. You think that all will be good and love is love, not just word with what people hide animal instincts.
I'm working on this shit for half a year. My ex-wife betrayed me. She cheated on me and
threw me as a piece of used paper via text message in viber in two weeks before NY. This cunt fucked with me when decided to leave me. She wanted to be pregnant and make a child from me to get benefits while
was dating with other guy. In a moment she forgot all good things that I done to her. I even didn't lie to her in all our relations and for my honest I received only lie and hate.
Now I hate her and want her be unhappy and lonely for the rest of her fucking life. But seems she is ok and this fact piss me off.
People do not get what they deserve. I'm working hard and I was a good guy. Once I saved drunk man from death, for example. I was always good to people. But I do not need.
I'm near 27 ears old and have nothing. All my friend are buddies from online games, only VoIP. I have big problems with my health. My back, my head, my stomach and other liver.
And there is even no God. Fuck, this is not some kind of Lord's test or whatever. This is my shitty life that would be ended sometimes and nothing would happen.
Just dead corpse buried in ground and nothing more.
But I do not give up. Why? I have no alternative. This is my shitty life but it's the only life I have. Fucking disappointment.

logQuery

protected final void logQuery(java.lang.String executor,
                              KittySQLiteQuery query)

Logs query or fake query to log

Parameters:

executor -

query -

logModel

protected final <M extends KittyModel> void logModel(java.lang.String executor,
                                                     M model)

Logs model to log if logOn and !productionOn

Type Parameters:

M -

Parameters:

executor -

model -

logQuery

public static final void logQuery(java.lang.String executor,
                                  KittySQLiteQuery query,
                                  java.lang.String logTag,
                                  boolean logOn,
                                  boolean productionMode,
                                  java.lang.Object helper,
                                  java.lang.String schemaName,
                                  int schemaVersion)

Logs query to log depends on parameter flags

Parameters:

executor -

query -

logTag -

logOn -

productionMode -

helper -

schemaName -

schemaVersion -

logModel

public static final <M extends KittyModel> void logModel(java.lang.String executor,
                                                         M model,
                                                         java.lang.String logTag,
                                                         boolean logOn,
                                                         boolean productionOn,
                                                         java.lang.Object helper,
                                                         java.lang.String schemaName,
                                                         int schemaVersion)

Logs model to log depends on parameter flags

Type Parameters:

M -

Parameters:

executor -

model -

logTag -

logOn -

productionOn -

helper -

schemaName -

schemaVersion -

pkvMapToString

protected final java.lang.String pkvMapToString(java.util.Map<java.lang.String,java.lang.String> pkv)

Returns string like '( key1 = value1 ; key2 = value2 )' for provided pkv.
If pkv null or it's size = 0 than string '( )' would be returned.

Parameters:

pkv - map for PK

Returns:

string like '( key1 = value1 ; key2 = value2 )' or '( )' depends on pkv

conditionFromSQLString

protected final SQLiteCondition conditionFromSQLString(java.lang.String condition,
                                                       java.lang.Object... params)

Generates instance of SQLiteCondition from SQLite string and set of parameters.
Actually, it is SQLiteConditionBuilder.fromSQL(String, Class, Object...) but there is no need to pass model class cause mapper already knows it
So, better to refactor, cause a lot of same code

Parameters:

condition -

params -

Returns:

getColumnByFieldName

public KittyColumnConfiguration getColumnByFieldName(java.lang.String fieldName)

Returns column name associated with model field name or null if nothing found

Parameters:

fieldName -

Returns: