浅议PB中数据窗口缓冲区与数据修改状态,filter,delete之后不想修改之方法
置顶 2014年12月14日 21:34:17 luoxiya521 阅读数:4495
--引用
摘 要:文章描述了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 |
RowsDiscard 方法
功能:datawindow中移除行操作,一旦行被移除则改行不能修改或保存,除非再次从数据库中retrieve。
语法:integer dwcontrol.RowsDiscard (long startrow, long endrow, DWBuffer buffer )
参数:dwcontrol 数据窗口
startrow 将要移除的开始行
endrow 将要移除的结束行
buffer 缓存区的值(Primary! ,Delete! ,Filter! )
示例:dw_1.RowsDiscard(1, dw_1.DeletedCount(), Delete!)
将dw_1中从第1行到DeletedCount()行移除到Delete!缓冲区中,则dw_1调用update()方法时,以上被移除的行不会发生变化。[1]
举例
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) 名词解释:设置哪个字段具有唯一值,可以起到主键的作用。