net.akaish.kitty.orm

Class KittyModel

java.lang.Object

net.akaish.kitty.orm.KittyModel

All Implemented Interfaces:

java.lang.Cloneable

public abstract class KittyModel
extends java.lang.Object
implements java.lang.Cloneable

KittyORM abstract model class.

Author:

akaish (Denis Bogomolov)

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	EXCEPTION_UNABLE_TO_CLONE
(package private) java.util.ArrayList<java.lang.String>	exclusions

Constructor Summary

Constructors

Constructor and Description
KittyModel()

Method Summary

Modifier and Type	Method and Description
KittyModel	clone()
<T extends KittyModel> T	clone(java.lang.Class<T> recordClass)
java.util.Map<java.lang.String,java.lang.String>	getPrimaryKeyValues() Returns map where keys are names of columns that are part of PK for this model and values are values of those columns for this model Override this method manually if you want achieve more performance for update methods in KittyMapper (setting this method manually in KittyModel child would avoid generating this map in update operations via reflection in cases when RowId not set and where statement not defined).
java.lang.Long	getRowID()
void	setFieldExclusion(java.lang.String fieldName) Sets field exclusion for setting it explicitly Usefull for inserting values that should have to be assigned by DEFAULT constraint or for fields that are parts of PK that should be generated automatically by trigger
(package private) void	setRowID(java.lang.Long rowid)
java.lang.String	toLogString() Implement this method in order to use functionality of dev logging model values.

Methods inherited from class java.lang.Object

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

Field Detail

EXCEPTION_UNABLE_TO_CLONE

public static final java.lang.String EXCEPTION_UNABLE_TO_CLONE

See Also:

Constant Field Values

exclusions

final java.util.ArrayList<java.lang.String> exclusions

Constructor Detail

KittyModel

public KittyModel()

Method Detail

setRowID

final void setRowID(java.lang.Long rowid)

getRowID

public final java.lang.Long getRowID()

getPrimaryKeyValues

public java.util.Map<java.lang.String,java.lang.String> getPrimaryKeyValues()

Returns map where keys are names of columns that are part of PK for this model and values are values of those columns for this model
Override this method manually if you want achieve more performance for update methods in KittyMapper (setting this method manually in KittyModel child would avoid generating this map in update operations via reflection in cases when RowId not set and where statement not defined).

Returns:

clone

public <T extends KittyModel> T clone(java.lang.Class<T> recordClass)

clone

public KittyModel clone()

Overrides:

clone in class java.lang.Object

toLogString

public java.lang.String toLogString()

Implement this method in order to use functionality of dev logging model values.
And switch logging at production cause, you know, nobody wants their private data to be
outputted into serial console, lol. Or at least switch production mode to false, cause models
logging would be used only when both logging is true and development mode is false!
Good approach would be implementing it as kv pairs with comma delimiter via
KittyUtils.implodeWithCommaInBKT(String[])
For example, it would be good option to implement like following for this
example model with following model fields and table name persons:
Model: persons, fields _id, name, surname
public String toLogString() {
return implodeWithCommaInBKT(new String[] {
"[table name = persons]",
"[rowid = " + getRowID() + "]",
"[_id = " + getId() + "]",
"[name = " + getName() + "]",
"[surname = " + getSurname() + "]" });
}
Also do not forget for handling NULL's and, to be honest, use such methods as Long.toString() etc.

Returns:

setFieldExclusion

public final void setFieldExclusion(java.lang.String fieldName)

Sets field exclusion for setting it explicitly
Usefull for inserting values that should have to be assigned by DEFAULT constraint
or for fields that are parts of PK that should be generated automatically by trigger

Parameters:

fieldName -