原本使用数据库的时候,需要根据存储字段建立对应表和列,以及对应增删改查逻辑。于是便想要找到一种方法,只创建一次数据库表格,并且今后的增删改查都用一套逻辑完成。后来想到了将列与数据字段的对应关系放在数据模型之中,这样每一列只关心保存的数据类就可以了。
首先需要了解一下三个关键注解:
1.@SQLiteClassify:用于数据模型类的注解,相当于表名;
2.@SQLiteColumn:用于数据模型内部字段的注解,相当于列名,支持int、boolean、long、double、float、short、String几种类型,其中boolean值会以“0”和“1”的形式保存,其余类型会转为String(json)数据保存;使用时候需要选择合适的列名,保证字段类型与保存类型一致;
3. @SQLiteRelevance:用于表与表之间的关联,被绑定的字段需要拥有@SQLiteClassify注解(即自定义的数据模型类),并选取一个被绑定字段内部字段作为查询的关键字,将此关键字保存在当前表格中。
对于表格中列的创建,是采用遍历ColumnEnum枚举类内部字段,根据字段的值创建对应类型的列,目前暂不支持动态增加列,只能通过修改ColumnEnum文件实现。
在使用方面,首先需要初始化CacheDao的CacheInitInterface接口:
CacheUtil内实现了CacheDao的单例,每个CacheDao对应一个userCache.db文件,每一个db文件内只有一张表(userCache),通过CacheUtil获取CacheDao进行据操作。如果需要建立多张表格,需要在不同文件夹下初始化CacheDao。
所有的条件语句,全部依赖SQLiteInfo类完成,CacheDao会在具体执行的时候自动将SQLiteInfo内的数据转化为对应sqlite语句并完成对应的执行操作。目前SQLiteInfo对外暴露的方法有4个:
1.addOrderInfo(ColumnEnum columnName):添加排序条件;
2.setAsc(boolean asc):设置升序降序;
3.addQueryCondition(ColumnInfo info):添加关系条件(有多种实现,最后全部是执行这个方法);目前支持的关系见下图2。ColumnInfo 内有三个字段:ColumnEnum columnName(列名)、String relation(关系,默认为“=?”)、Object columnValue(对应值)
4.setOtherCondition(String otherCondition):预留的方法,添加其他条件语句,执行的时候会直接加到sqlite语句后面。
主要使用方法(CacheDao):
1.保存:saveValue,可不带查询条件。若返回-1代表失败;返回0代表新增;返回1代表更新。saveByArray,多条保存,无返回值,内部实际上是多次调用了saveValue;
2.查询:selectValueModel,可不带查询条件,receiver为数据接收者,查询到数据已通过反射保存到receiver中的对应字段,若查到的数据与receiver不匹配则receiver不会变化。例如:CacheUtil.instance().selectValueModel(new Group(), sqLiteInfo)。getColumnValue,查询指定的列。 selectValueList多条查询,有多种实现,差别在于如何新建数据的receiver以及查询的条目数量、范围。getSelectCursor获取查询结果光标。
3.删除:delete以及deleteByArray,单条删除和多条删除。
4.更新:updateColumn更新某一列上的值。
几个简单的例子: