--引用
| 摘 要：文章描述了PowerBuilder中数据窗口缓冲区，详细介绍了数据窗口中行与列的修改状态以及PowerBuilder提供的相关函数，并给出了几则应用实例。 关键词：PowerBuilder 数据窗口 缓冲区 中图分类号：TP311.131 文献标识码：A | |||||||||||||||||||||||||||||
| PowerBuilder是当今最先进的数据库开发工具之一，它以 开放性、可移植性以及易用性而闻名于世。PowerBuilder的突出特点是给应用开发人员提供了非常方便的开发环境和工具，而数据窗口技术则是其中最 耀眼的闪光点。利用数据窗口，开发人员可以完成绝大多数数据操作任务。本文从数据窗口中数据的修改状态的角度出发，介绍利用数据窗口进行应用开发的一些技 巧。 1 数据窗口缓冲区 在应用中，每个数据窗口控件都要检索4个内存缓冲区，它们是： ·主缓冲区(PrimaryBuffer)：存放检索出来的数据，但不包括过滤掉和删除掉的数据。 ·过滤缓冲区(FilterBuffer)：存放从主缓冲区中过滤掉的数据。 ·删除缓冲区(DeleteBuffer)：存放从主缓冲区中删除掉的数据。 ·原始缓冲区(OriginalBuffer)：存放从数据库里检索到的原始数据，它由PowerBuild在内部维护，可以利用该缓冲区中的数据进行数据恢复，在应用程序中实现Undo功能。 2 行与列的修改状态 行与列的修改状态在PowerBuilder中为dwItemStatus枚举类型值，它们包含： ·NotModified!：指定行或列处的信息与最初检索出的相同。 ·DataModified!：指定列或行中某列处的信息在检索出后发生了改变。 ·New!：指定行是新行，但此行的列并未赋值。本状态只适用于行，不适用于单个列。 ·NewModified!：指定行是新行且行中的列已经赋值。新行的状态成为NewModified!，既可能是用户输入或使用SetItem函数造成的，也可能是由于它的某列具有缺省值。本状态只适用于行，不适用于单个列。 数据窗口中行或列的修改状态决定Update()函数将为该行或该列产生何种类型的SQL语句。 对主缓冲区和过滤缓冲区中的行，Update为状态是NewModified!的行产生Insert语句，为状态是DateModified!的行产生 Update语句，只有状态是DataModified!的列才会包含在Update语句中。对删除缓冲区中的行，若其状态是New!或 NewModified!，则Update语句不会为其产生Update语句。 利用函数GetItemStatus可获得某行或某列的修改状态，利用函数SetItemStatus可改变某行或某列的修改状态。 语法： dwcontrol.GetItemStatus(row,column,dwbuffer) dwcontrol.SetItemStatus(row,column,dwbuffer,status) 对于如何改变状态，PowerBuilder有一些限制，表1给出了这种限制，其中Yes表示可把初始状态改变为指定状态，No则表示不可以。 表1数据修改状态设置约束
通过观察表1，我们可以发现这样一种情况：假设某个记录的状态为New!，那么不能直接改为NotModified!但可先将它改为DataModified!，然后再改为NotModified!。 利用函数RowsCopy、RowsMove可以在不同DataWindow控件(或DataStore对象)之间或同一DataWindow控件(或DataStore对象)的不同缓冲区之间复制、移动数据行。 语法： dwcontrol.RowsCopy(startrow,endrow,copybuffer,targetdw,beforerow,targetbuffer) 当某行在删除缓冲区中时，或者在主缓冲区或过滤缓冲区中，并且状态为NewModified!或 DataModified!时，其更新标志被设置。函数ResetUpdate清除DataWindow或DataStore中主缓冲区和过滤缓冲区中的 更新标志并清空其删除缓冲区。清除更新标志后，所有行的状态为NotModified!或New!。 语法：dwcontrol.ResetUpdate() 3 应用举例 (1)在数据窗口中，某些列常具有缺省值，或我们在执行了InsertRow操作后立即使用 SetItem函数为某些列赋值。如果用户执行了一个插入操作后立即关闭窗口会触发closequery事件，这时会提示用户记录已经被修改，但用户并没 有感觉到对数据的修改。为避免出现这种情况，可作如下处理： intli_new_row (2)在应用程序中提供Undo功能，将实现很好的用户友好效果。本例中将数据窗口dw_l中的当前行、当前列的显示值置为从数据库中检索出的原始值： (3)在协调两个DataWindow对象dw_l、dw_2的更新时，若其中一个更新失败，应阻止重设更新标志，以便回滚事务，一旦所有数据窗口都已成功更新，就可使用COMMIT结束该事务，并使用ReSetUpdate重新设置数据窗口的状态标志。 （5）讲filter缓冲区的修改状态改为未修改，更新时候不保存filter缓冲区内的数据 举例 if tab_1.tabpage_2.rb_cq.checked then | |||||||||||||||||||||||||||||
举例
for i = 1 to tab_1.tabpage_2.dw_lymx.rowcount()
ll_pspb = tab_1.tabpage_2.dw_lymx.object.pspb[i]
ll_psjg = tab_1.tabpage_2.dw_lymx.object.psjg[i]
ll_ypyf = tab_1.tabpage_2.dw_lymx.object.ypyf[i]
if ll_pspb = 0 then continue
if ll_ypyf = ii_psyp_ypyf and ll_psjg <> 1 then continue //皮试用，非阳性
if ll_psjg = 0 or ll_psjg = 1 then
tab_1.tabpage_2.dw_lymx.deleterow(i)
i --
end if
next
tab_1.tabpage_2.dw_lymx.rowsdiscard( 1, tab_1.tabpage_2.dw_lymx.deletedcount(), Delete!)
分享缓冲区常识
一、 DataWindow的四个缓冲区
| 缓冲区 | 作用 |
| Primary Buffer （主缓冲区） | 存放检索出来的数据，但不包括过滤掉和删除掉的数据。数据窗口控件只显示主缓冲区中的数据。 |
| Delete Buffer （删除缓冲区） | 存放从Primary Buffer中删除掉的数据。在数据没有提交到数据库之前，可以从该缓冲区中将数据恢复出来。数据提交后，该缓冲区中的数据清空。 |
| Filter Buffer （过滤缓冲区） | 存放从Primary Buffer中过滤掉的数据。 |
| Original Buffer （原始缓冲区） | 存放从数据库里检索到的原始数据 |
二、四个缓冲区的相关函数
| 函数格式 | 功能 | 参数 | 说明 |
| Retrieve({arg,arg….}) | 检索数据，满足条件的数据放到数据窗口的主缓冲区，不满足条件的数据放到数据窗口的过滤缓冲区 | arg—在数据窗口对象中定义的检索参数。成功时返回检索出的数据行数，失败返回-1 | 常用方法： Retrieve()如果数据窗口对象定义的检索参数为学号，则对某个学号的检索为： dw_1.Retrieve(1234) |
| DeleteRow(row) | 删除行, 将被删除的数据从数据窗口的主缓存区移放到删除缓冲区 | row—要删除的行号，row=0时，删除当前行。成功时返回1，失败时返回-1 | 在数据窗口的主缓冲区中删除一行。例如删除数据窗口控件的dw_1中的第10行： dw_1.DeleteRow(10)
|
| RowsMove(startrow, endrow, movebuffer, targetdw, beforerow, targetbuffer ) | 将数据从一个缓冲区移动到另外缓冲区中 | startrow和endrow是要移动数据的范围；movebuffer指要从哪个缓冲区移出数据， targetdw是目标数据窗口控件名称；beforerow表示在目标数据窗口的哪一行之前插入移入的数据， targetbuffer是目标缓存区 | 例如： dwcontrol.RowsMove (l,dw_l.DeletedCount(), Delete!,dw_l,l,Primary!) 将数据行从删除缓冲区移到主缓冲区，实现取消删除的功能。 |
| RowsCopy(startrow, endrow, movebuffer, targetdw, beforerow, targetbuffer )
| 将数据从一个缓冲区复制到另外缓冲区中 | startrow和endrow是要复制数据的范围；movebuffer指要从哪个缓冲区复制数据， targetdw是目标数据窗口控件名称；beforerow表示在目标数据窗口的哪一行之前插入复制的数据， targetbuffer是目标缓存区 |
|
| SetFilter(format) | 设置数据窗口的过滤条件 | format—表示过滤条件的字符串，可以使用字段名或字段号定义条件。成功返回1，失败返回-1 | 例如： dw_1.setfilter(“age>25 and age<45”) 取消过滤条件： dw_1.setfilter（“ ”） |
| Filter()
| 对数据窗口的Original!缓存区进行过滤，不符合条件的数据行被移送到数据窗口的Filter!缓存区 | 成功返回1，失败返回-1 | 例如： dw_1.Filter() |
| GetItemStatus(row,column,dwbuffer,)
| 获取指定字段的状态 | row—指定数据行的行号 column—指定的数据列 dwbuffer—指定读取数据的缓冲区，默认主缓冲区，返回一个 dwItemStatus枚举量 | 例如：取数据窗口dw_1第5行work字段在Filter缓冲区的状态： dwItemStatus1_status 1_status=dw_1.GetItemStatus(5,”work”, Filter!) |
| SetItemStatus(row,column,dwbuffer, status)
| 设置指定字段的状态 | row—指定数据行的行号 column—指定的数据列 dwbuffer—指定读取数据的缓冲区 status—dwItemStatus枚举量 | 例如：设置dw_1第5行party字段在主缓冲区的状态为NotModIFied： dw_history.SetItemStatus (5,”Salary”，Primary!，NotModIFied!) |
★GetItemStatus和SetItemStatus的基本功能与说明已在上述表格中给出，其中
1、行与列的修改状态为dwItemStatus枚举类型值，它们包含：
| 状态标志 | 意义 |
| NotModified! | 指定单元的数据和原始数据相同，没有修改过。 |
| DataModified! | 指定单元的数据和原始数据不同，修改过。 |
| New! | 该数据行是新增加的，但还没有在该行上输入数据 |
| NewModified! | 该数据行是新增加的，并且已经在该行上录入了数据。 |
2、status为上面的四个取值中的一个，但不是任意的取值，因为有些状态不能用该函数设置成另外一种状态，必须是能够转换的状态。下面列出了能够转换的状态：
| 期望状态 当前状态 | New! | NewModified! | DataModified! | NotModified! |
| New! | \ | Yes | Yes | No |
| NewModified! | No | \ | Yes | New |
| DataModified! | NewModified! | Yes | \ | Yes |
| NotModified! | Yes | Yes | Yes | \ |
注意：表中的Yes表示可以使用SetItemStatus进行该状态设置，No表示不会产生预期的状态，如果标明了某个特定的状态，则说明是新的状态，而不是期望的状态。
三、pb Update Properties 详细介绍
1. Allow Updates
a) 名词解释：数据是否只读，如果把该选项关闭，那么在程序中的任何删、改操作都无法生效。
b) 注意事项：如果数据获取之后只是显示用，就不需要设置该属性
2. Table to Update
a) 名词解释：设置可更新的表，即可调用数据窗口的update函数
b) 注意事项：一次只能设置一张表具有更新属性
3. Where Clause or Update/Delete:
a) 名词解释：如何构建Update/Delete的where语句
b) 3个选项的解释
1) Key Columns（默认值）: 用主键构建where语句，值来自原始缓冲区。主键允许是复合主键。
2) Key and Updatable Columns:用主键和所有可更新列构建where语句，值来自原始缓冲区。“可更新列”详见“Updatable Columns”选项来设置
3) Key and Modified Columns:用主键和真正发生变化的列构建where语句，值来自原始缓冲区。
4. Key Modification
a) 名词解释：如何完全本次删、改操作
b) 两个选项
1) Use Delete then Insert（默认值）：先删除，再插入。
1. 注意：如果该表的主键值自动（触发器等）产生，且该主键作为另外表的外键，则不能采用这种方式。
2) Use Update：被修改字段通过Update语句更新回数据库。建议使用。
5. Updatable Columns
a) 名词解释：设置哪些字段被修改后可更新到数据库
b) 注意事项：Key and Updatable Columns对应,没有选中的列将不会出现在Update语句的where语句中，值与原始缓冲区里的值相同，防止并发操作。
6. Unique Key Columns
a) 名词解释：设置哪个字段具有唯一值，可以起到主键的作用。
2128
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
