乐者为王

Do one thing, and do it well.

DataWindow的数据缓冲区

在PowerBuilder中,DataWindow是用来存储和操纵数据的对象。在每个DataWindow对象中都有4个二维表作为数据缓冲区来存储数据。用户在DataWindow中对数据的操作实际上都是将数据在这几个缓冲区中进行修改和移动,最后在用户提交数据库时,系统根据这四个缓冲区中的信息形成SQL的INSERT、UPDATE、DELETE等语句。这四个缓冲区是:

Primary Buffer

这个缓冲区是存放填充窗口中DataWindow控件的数据的,调用DataWindow控件的Retrieve()函数和InsertRow()函数可以将数据填入这个缓冲区中。当使用有关DataWindow删除和过滤函数时,相应记录将从这一缓冲区中删除。而在执行DataWindow的Update()函数时,PowerBuilder将查看这一缓冲区中的记录以形成INSERT和UPDATE语句。

Delete Buffer

这个缓冲区保存的是用DeleteRow()函数从Primary Buffer中删除的记录,执行Update()函数时,系统根据这一缓冲区的记录形成DELETE语句。

Filter Buffer

这个缓冲区存储的是从Original Buffer使用Filter()函数过滤到Primary Buffer中后剩余的记录。

Original Buffer

这一缓冲区存储的是DataWindow最初执行Retrieve()函数时得到的全部记录。当提交数据库时,根据Primary Buffer生成的UPDATE语句和根据Delete Buffer生成的DELETE语句都要依据这一缓冲区来构造这些SQL语句中的WHERE子句。

Original Buffer由PowerBuilder内部维护,PowerBuilder所提供的任何函数都无法改变它的值,不过通过PowerBuilder所提供的GetItem系列函数可以读出DataWindow最初从数据库中查到的原始值。通过这些函数我们可以编程实现所谓的Undo功能,并且得到在使用乐观锁时形成提交数据库的WHERE子句。如果你当前使用的DataWindow没有设置修改的权力,你将不能对Delete Buffer和Original Buffer进行操作,而且当调用Update()时也将引起系统错误。

Primary Buffer和Delete Buffer都有行级和列级的状态值,这个状态值是一个枚举类型。在提交时由该行的状态值来决定是否要产生SQL语句,其中Primary Buffer产生的是INSERT和UPDATE语句,而Delete Buffer产生的是DELETE语句。我们用GetItemStatus()函数和SetItemStatus()函数可以对这一状态值进行操纵。这一枚举状态有以下四种:

1
2
3
4
NotModified! —— 指定单元的数据和原始数据相同,没有发生改变。
DataModified! —— 指定单元的数据和原始数据不同,发生了改变。
New! —— 该数据行是新增加的,但数据没有发生改变(数据为空或缺省值)。
NewModified! —— 该数据行是新增加的,且数据已发生改变(用户键盘输入或调用SetItem()函数)。

在上面的这四个值中,NotModifed!和DataModified!可以表示行和列的状态,而New!和NewModified!只可以表示行的状态。

让我们来看一个实例。有这样一张表,表中有3个字段,其中item是主键。

1
2
3
item CHAR(5)
name CHAR(20)
quantity INT

在代码中我们查询这张表的记录,得到以下的这些信息,它们被存储在Primary Buffer和Origianal Buffer中。

dwbuffer-1

在窗口中,我们过滤掉数量为0的行,并且加上一个空行:

1
2
3
dw_1.SetFilter("quantity=0")
dw_1.Filter()
dw_1.InsertRow()

这时Primary Buffer的状态为:

dwbuffer-2

在Filter Buffer中的记录为:

dwbuffer-3

用户在新插入行中输入数据,删除了第3行数据,并修改了第2行数据。当他离开这个DataWindow时,Primary Buffer和Delete Buffer的状态如下:

dwbuffer-4

dwbuffer-5

这时执行dw_1.Update()函数,系统将基于这两个缓冲区生成SQL语句。

dwbuffer-6

在Primary Buffer中,状态为NotModified!和New!的行将被忽略而不产生SQL语句。状态为DataModified!的行将产生UPDATE语句,状态为NewModified!的行将产生INSERT语句,在Delete Buffer中的行将产生DELETE语句。使用DataWindow的Reset()函数和Retrieve()函数以及改变DataObject属性时,系统将重置这几个缓冲区。

Comments