当前位置: 首页 > 工具软件 > FastDB > 使用案例 >

fastdb学习记录#1 table、宏、query、cursor

单凯捷
2023-12-01

基本解决了在example里testdb的代码疑问。

数据table对应在fastdb里是c++类;表记录对应于该类的实例。
下面的c++数据类型可以作为fastdb 记录的原子组件:
Type Description
bool boolean type (true,false)
int1 one byte signed integer (-128..127)
int2 two bytes signed integer (-32768..32767)
int4 four bytes signed integer (-2147483648..2147483647)
int8 eight bytes signed integer (-2**63..2**63-1)
real4 four bytes ANSI floating point type  *float*
real8 eight bytes ANSI double precision floating point type *double*
char const* zero terminated string
dbReference<T> reference to class T
dbArray<T> dynamic array of elements of type T

关于宏
fastdb 提供了一个宏和相关的类的集合来使得这个映像尽可能的灵活。
每一个要在数据库中使用的c++类或者结构,都包含一个特别的方法来描述其字段。
宏TYPE_DESCRIPTOR(field_list)构成了这个方
法。这个宏的用括号括起来的单一参数是一个类字段描述符的列表。
如果要为这个类定义一些方法并使之可以用于对应的数据库,则用宏CLASS_DESCRIPTOR(name, field_list)来代替
TYPE_DESCRIPTOR。

FIELD(name)指定名字的非索引字段KEY
KEY(name,index_type)索引字段。index_type 必须是HASHED 和INDEXED 标志的组合。当指定HASHED
标志的时候,fastdb 将为是用这个字段作为关键字的表创建一个hash 表。当指定INDEXED
标志时,fastdb将创建为使用这个字段作为关键字的表创建一个T_tree(一种特殊的索引)
SUPERCLASS(name)指定当前类的基类(父亲)的信息。
RELATION(reference, inverse_reference) 指定类(表)之间的一对一、一对多或者多对多
的关系。reference 和inverse_reference 字段都必须是引用或者引用数组类型。
inverse_reference字段是一个包含了指向当前表的逆引用的引用表。逆引用自动由fastdb
更新并用于查询优化。
OWNER(reference, inverse_reference) 指定类之间的一对一、一对
多或者多对多的owner-member关系。当owner记录被删除时所有引用的member 记录也会被
删除(层叠式删除)。如果member记录要引用owner就必须通过RELATION宏声明。
METHOD(name)
为类指定一个方法。该方法必须是无参的实例成员函数,返回bool 值、数值、引用或者字符
串类型。方法必须在类的所有属性之后指定。

所有数据库中使用的类都要定义类型描述符。也就是上面的宏TYPE_DESCRIPTOR *写在头文件中*
除了定义类型描述符外,还必须在C++类和数据库表之间建立一个映像。也就是REGISTER 宏。 *在实现文件中使用,不是在头文件*
该宏构造一个与类相连的表的描述符。
如果你要在一个应用中使用多个数据库,那么就可能使用REGISTER_IN(name,database)
宏在一个具体数据库中注册一个表。该宏的database 参数应该是一个指向dbDatabase 对象
的指针。

表在每一个时刻只能对应于一个数据库。
打开数据库,fastdb向数据库导入所有定义的类。
装载所有的类描述符之后,fastdb 就检查在应用程序的类描述符中指定的索引是否存在于数据库中、
创建新的索引并且删除不再使用的索引。
只有在不超过一个应用程序访问数据库是才可以进
行表的重构以及增加/删除索引。

----
query类的学习:

提供重载的运算符=和,构造带参数的查询语句,参数可以在被使用时直接指定。
query不仅可以构造一个查询并绑定查询参数,还可以作为已编译的查询的缓存。
例如:
dbQuery q;
int price, quantity;
q = "price >=",price,"or quantity >=",quantity;
参数price和quantity的指针保存在查询中,因此该查询可以用不同的参数执行多次。

查询变量既不能作为一个参数传给一个函数也不能赋给另一个变量
当fastdb 编译查询时,会把编译树存到该对象中。
下一次使用该查询时,不需要再次编译并且可以使用已编译好的树。这样节省了一些编译查询的时间。

---
游标的学习:
游标用来访问选择语句返回的记录。
fastdb 有两种游标:只读游标和用于更新的游标
fastdb 中的游标用c++模板类dbCursor<T>来表示,其中T 为与数据库表相关的C++类的的名字
缺省创建一个只读游标
要创建一个用于更新的游标,必须给构造函数传递一个dbCursorForUpdate 参数。
例如:dbCursor<Contract> updateContracts(dbCursorForUpdate)

执行一个查询要么通过游标select(dbQuery &q)方法,要么通过select()方法,后者可以
迭代表中的所有记录。两个方法都返回中选的记录的数量,并且把当前位置置于第一个记录
(如果有的话)。

游标可以前滚或者后滚。next(),prev(),first(),last()方法可以用来改变
游标的当前位置。如果由于没有(更多)的记录存在而使得操作无法进行,这些方法将返回
NULL,并且游标的位置不改变

get()方法来获得指向当前记录的指针。重载的运算符' ->'也可以用来访问当前记录的元素。
也就是游标当前指向的元素。
如果一个游标更新方式打开,就可以改变当前的记录并
且用update()方法保存到数据库中或者被删除掉。如果当前记录被删除,下一个记录变为当
前记录。如果没有下一个记录,则前一个记录(如果有的话)变为当前。
removeAll()方法删除表中的所有记录。
而removeAllSelected方法只删除游标选择的所有记录。

**
当更新记录后,数据库的大小可能会增加。从而虚拟存储器的数据库区域需要进行扩展。该
重映射的后果之一就是,该区域的基地址可能发生变化,然后应用程序中保存的所有数据库
指针都变得无效。当数据库区域重映象时fastdb自动更新所有打开的游标中的当前记录。
因此,当一个数据库更新时,程序员应该通过游标的->方法来访问记录字段,而不应该使用指
针变量。

游标也可以通过引用来访问记录。
at(dbReference<T> const& ref)方法把游标指向引用所指的记录。
但是在这种情况下,选择将只包含一个记录,而next(),prev()方法将总是返回NULL。

所有数据库数据的操作都可以通过游标来进行,唯一的例外是插入操作,
fastDB提供了一个重载的插入函数:


 

 类似资料: