extjs数据存储与传输.docx
《extjs数据存储与传输.docx》由会员分享，可在线阅读，更多相关《extjs数据存储与传输.docx（47页珍藏版）》请在冰点文库上搜索。
extjs数据存储与传输
extjs数据存储与传输
2009年11月23日09:
39
本章内容
q Ext.data简介
q Ext.data.Connection
q Ext.data.Record
q Ext.data.Store
q 常用proxy
q 常用reader
q 高级store
q EXT中的Ajax
q 关于scope和createDelegate（）
q DWR与EXT整合
10.1 Ext.data简介
Ext.data在命名空间中定义了一系列store、reader和proxy。
Grid和ComboxBox都是以Ext.data为媒介获取数据的，它包含异步加载、类型转换、分页等功能。
Ext.data默认支持Array、JSON、XML等数据格式，可以通过Memory、HTTP、ScriptTag等方式获得这些格式的数据。
如果要实现新的协议和新的数据结构，只需要扩展reader和proxy即可。
DWRProxy就实现了自身的proxy和reader，让EXT可以直接从DWR获得数据。
10.2 Ext.data.Connection
Ext.data.Connection是对Ext.lib.Ajax的封装，它提供了配置使用Ajax的通用方式，它在内部通过Ext.lib.Ajax实现与后台的异步调用。
与底层的Ext.lib.Ajax相比，Ext.data.Connection提供了更简洁的配置方式，使用起来更方便。
Ext.data.Connection主要用于在Ext.data.HttpProxy和Ext.data.ScriptTagProxy中执行与后台交互的任务，它会从指定的URL获得数据，并把后台返回的数据交给HttpProxy或ScriptTagProxy处理，Ext.data.Connection的使用方式如代码清单10-1所示。
代码清单10-1 使用Ext.data.Connection
varconn=newExt.data.Connection（{
autoAbort:
false,
defaultHeaders:
{
referer:
'http:
//localhost:
8080/'
},
disableCaching:
false,
extraParams:
{
name:
'name'
},
method:
'GET',
timeout:
300,
url:
'01-01.txt'
}）;
在使用Ext.data.Connection之前，都要像上面这样创建一个新的Ext.Connection实例。
我们可以在构造方法里配置对应的参数，比如autoAbort表示链接是否会自动断开、default-Headers参数表示请求的默认首部信息、disableCaching参数表示请求是否会禁用缓存、extraParams参数代表请求的额外参数、method参数表示请求方法、timeout参数表示连接的超时时间、url参数表示请求访问的网址等。
在创建了conn之后，可以调用request（）函数发送请求，处理返回的结果，如下面的代码所示。
conn.request（{
success:
function（response）{
Ext.Msg.alert（'info',response.responseText）;
},
failure:
function（）{
Ext.Msg.alert（'warn','failure'）;
}
}）;
Request（）函数中可以设置success和failure两个回调函数，分别在请求成功和请求失败时调用。
请求成功时，success函数的参数就是后台返回的信息。
我们再来看一下request函数中的其他参数。
q url:
String：
请求url。
q params:
Object/String/Function：
请求传递的参数。
q method:
String：
请求方法，通常为GET或POST。
q callback:
Function：
请求完成后的回调函数，无论是成功还是失败，都会执行。
q success:
Function：
请求成功时的回调函数。
q failure:
Function：
请求失败时的回调函数
q scope:
Object：
回调函数的作用域。
q form:
Object/String：
绑定的form表单。
q isUpload:
Boolean：
是否执行文件上传。
q headers:
Object：
请求首部信息。
q xmlData:
Object：
XML文档对象，可以通过URL附加参数的方式发起请求。
q disableCaching:
Boolean：
是否禁用缓存，默认为禁用。
Ext.data.Connection还提供了abort（[NumbertransactionId]）函数，当同时有多个请求发生时，根据指定的事务id放弃其中的某一个请求。
如果不指定事务id，就会放弃最后一个请求。
isLoading（[NumbertransactionId]）函数的用法与abort（）类似，可以根据事务id判断对应的请求是否完成。
如果未指定事务id，就判断最后一个请求是否完成。
10.3 Ext.data.Record
Ext.data.Record就是一个设定了内部数据类型的对象，它是Ext.data.Store的最基本组成部分。
如果把Ext.data.Store看作是一张二维表，那么它的每一行就对应一个Ext.data.Record实例。
Ext.data.Record的主要功能是保存数据，并且在内部数据发生改变时记录修改的状态，它还可以保留修改之前的原始值。
我们使用Ext.data.Record时通常都是由create（）函数开始，首先用create（）函数创建一个自定义的Record类型，如下面的代码所示。
varPersonRecord=Ext.data.Record.create（[
{name:
'name',type:
'string'},
{name:
'sex',type:
'int'}
]）;
PersonRecord就是我们定义的新类型，包含字符串类型的name和整数类型的sex两个属性，然后我们使用new关键字创建PersonRecord的实例，如下面的代码所示。
varboy=newPersonRecord（{
name:
'boy',
sex:
0
}）;
创建对象时，可以直接通过构造方法为对象赋予初始值，将'boy'赋值给name，0赋值给sex。
现在，我们得到了PersonRecord的实例boy，如何才能得到它的属性呢？
以下三种方式都可以获得boy中name属性的数据，如下面的代码所示。
alert（boy.data.name）;
alert（boy.data['name']）;
alert（boy.get（'name'））;
这里涉及Ext.data.Record的data属性，这是定义在Ext.data.Record中的一个公共属性，用于保存当前record对象的所有数据。
它是一个JSON对象，可以直接从它里面获得需要的数据。
可以通过Ext.data.Record的get（）函数方便地从data属性中获得指定的属性值。
如果我们需要修改boy中的数据，请不要使用以下方式直接操作data，如下面的代码所示。
boy.data.name='boyname';
boy.data['name']='boyname';
而应该使用set（）函数，如下面的代码所示。
boy.set（'name','bodyname'）;
set（）函数会判断属性值是否发生了改变，如果改变了，就要将当前对象的dirty属性设置为true，并将修改之前的原始值放入modified对象中，供其他函数使用。
如果直接操作data中的值，record就无法记录属性数据的修改情况。
Record的属性数据被修改后，我们可以执行如下几种操作。
q commit（）（提交）：
这个函数的效果是设置dirty为false，并删除modified中保存的原始数据。
q reject（）（撤销）：
这个函数的效果是将data中已经修改了的属性值都恢复成modified中保存的原始数据，然后设置dirty为false，并删除保存原始数据的modified对象。
q getChanges（）获得修改的部分：
这个函数会把data中经过修改的属性和数据放在一个JSON对象里并返回。
例如上例中，getChanges（）返回的结果是{name:
’bodyname’}。
q 我们还可以调用isModified（）判断当前record中的数据是否被修改。
Ext.data.Record还提供了用于复制record实例的函数copy（）。
varcopyBoy=boy.copy（）;
这样我们就得到了boy的一个副本，它里面包含了boy的data数据，但copy（）函数不会复制dirty和modified等额外的属性值。
Ext.data.Record中其他的参数大多与Ext.data.Store有关，请参考与Ext.data.Store相关的讨论。
10.4 Ext.data.Store
Ext.data.Store是EXT中用来进行数据交换和数据交互的标准中间件，无论是Grid还是ComboBox，都是通过它实现数据读取、类型转换、排序分页和搜索等操作的。
Ext.data.Store中有一个Ext.data.Record数组，所有数据都存放在这些Ext.data.Record实例中，为后面的读取和修改操作做准备。
10.4.1 基本应用
在使用之前，首先要创建一个Ext.data.Store的实例，如下面的代码所示。
vardata=[
['boy',0],
['girl',1]
];
varstore=newExt.data.Store（{
proxy:
newExt.data.MemoryProxy（data）,
reader:
newExt.data.ArrayReader（{},PersonRecord）
}）;
store.load（）;
每个store最少需要两个组件的支持，分别是proxy和reader，proxy用于从某个途径读取原始数据，reader用于将原始数据转换成Record实例。
这里我们使用的是Ext.data.MemoryProxy和Ext.data.ArrayReader，将data数组中的数据转换成对应的几个PersonRecord实例，然后放入store中。
store创建完毕之后，执行store.load（）实现这个转换过程。
经过转换之后，store里的数据就可以提供给Grid或ComboBox使用了，这就是Ext.data.Store的最基本用法。
10.4.2 对数据进行排序
Ext.data.Store提供了一系列属性和函数，利用它们对数据进行排序操作。
可以在创建Ext.data.Store时使用sortInfo参数指定排序的字段和排序方式，如下面的代码所示。
varstore=newExt.data.Store（{
proxy:
newExt.data.MemoryProxy（data）,
reader:
newExt.data.ArrayReader（{},PersonRecord）,
sortInfo:
{field:
'name',direction:
'DESC'}
}）;
这样，在store加载数据之后，就会自动根据name字段进行降序排列。
对store使用store.setDefaultSort（'name','DESC'）;也会达到同样效果。
也可以在任何时候调用sort（）函数，比如store.sort（'name','DESC'）;，对store中的数据进行排序。
如果我们希望获得store的排序信息，可以调用getSortState（）函数，返回的是类似{field:
"name",direction:
"DESC"}的JSON对象。
与排序相关的参数还有remoteSort，这个参数是用来实现后台排序功能的。
当设置为remoteSort:
true时，store会在向后台请求数据时自动加入sort和dir两个参数，分别对应排序的字段和排序的方式，由后台获取并处理这两个参数，在后台对所需数据进行排序操作。
remoteSort:
true也会导致每次执行sort（）时都要去后台重新加载数据，而不能只对本地数据进行排序。
详细的用法可以参考第2章。
10.4.3 从store中获取数据
从store中获取数据有很多种途径，可以依据不同的要求选择不同的函数。
最直接的方法是根据record在store中的行号获得对应的record，得到了record就可以使用get（）函数获得里面的数据了，如下面的代码所示。
store.getAt（0）.get（'name'）
通过这种方式，我们可以遍历store中所有的record，依次得到它们的数据，如下面的代码所示。
for（vari=0;i varrecord=store.getAt（i）;
alert（record.get（'name'））;
}
Store.getCount（）返回的是store中的所有数据记录，然后使用for循环遍历整个store，从而得到每条记录。
除了使用getCount（）的方法外，还可以使用each（）函数，如下面的代码所示。
store.each（function（record）{
alert（record.get（'name'））;
}）;
Each（）可以接受一个函数作为参数，遍历内部record，并将每个record作为参数传递给function（）处理。
如果希望停止遍历，可以让function（）返回false。
也可以使用getRange（）函数连续获得多个record，只需要指定开始和结束位置的索引值，如下面的代码所示。
varrecords=store.getRange（0,1）;
for（vari=0;i varrecord=records[i];
alert（record.get（'name'））;
}
如果确实不知道record的id，也可以根据record本身的id从store中获得对应的record，如下面的代码所示。
store.getById（1001）.get（'name'）
EXT还提供了函数find（）和findBy（），可以利用它们对store中的数据进行搜索，如下面的代码所示。
find（Stringproperty,String/RegExpvalue,[NumberstartIndex],[BooleananyMatch],
[BooleancaseSensitive]）
在这5个参数中，只有前两个是必须的。
第一个参数property代表搜索的字段名；第二个参数value是匹配用字符串或正则表达式；第三个参数startIndex表示从第几行开始搜索，第四个参数anyMatch为true时，不必从头开始匹配；第五个参数caseSensitive为true时，会区分大小写。
如下面的代码所示：
varindex=store.find（'name','g'）;
alert（store.getAt（index）.get（'name'））;
与find（）函数对应的findBy（）函数的定义格式如下：
findBy（Functionfn,[Objectscope],[NumberstartIndex]）:
Number
findBy（）函数允许用户使用自定义函数对内部数据进行搜索。
fn返回true时，表示查找成功，于是停止遍历并返回行号。
fn返回false时，表示查找失败（即未找到），继续遍历，如下面的代码所示。
index=store.findBy（function（record,id）{
returnrecord.get（'name'）=='girl'&&record.get（'sex'）==1;
}）;
alert（store.getAt（index）.get（'name'））;
通过findBy（）函数，我们可以同时判断record中的多个字段，在函数中实现复杂逻辑。
我们还可以使用query和queryBy函数对store中的数据进行查询。
与find和findBy不同的是，query和queryBy返回的是一个MixCollection对象，里面包含了搜索得到的数据，如下面的代码所示。
alert（store.query（'name','boy'））;
alert（store.queryBy（function（record）{
returnrecord.get（'name'）=='girl'&&record.get（'sex'）==1;
}））;
10.4.4 更新store中的数据
可以使用add（Ext.data.Record[]records）向store末尾添加一个或多个record，使用的参数可以是一个record实例，如下面的代码所示。
store.add（newPersonRecord（{
name:
'other',
sex:
0
}））;
Add（）的也可以添加一个record数组，如下面的代码所示：
store.add（[newPersonRecord（{
name:
'other1',
sex:
0
}）,newPersonRecord（{
name:
'other2',
sex:
0
}）]）;
Add（）函数每次都会将新数据添加到store的末尾，这就有可能破坏store原有的排序方式。
如果希望根据store原来的排序方式将新数据插入到对应的位置，可以使用addSorted（）函数。
它会在添加新数据之后立即对store进行排序，这样就可以保证store中的数据有序地显示，如下面的代码所示。
store.addSorted（newPersonRecord（{
name:
'lili',
sex:
1
}））;
store会根据排序信息查找这条record应该插入的索引位置，然后根据得到的索引位置插入数据，从而实现对整体进行排序。
这个函数需要预先为store设置本地排序，否则会不起作用。
如果希望自己指定数据插入的索引位置，可以使用insert（）函数。
它的第一个参数表示插入数据的索引位置，可以使用record实例或record实例的数组作为参数，插入之后，后面的数据自动后移，如下面的代码所示。
store.insert（3,newPersonRecord（{
name:
'other',
sex:
0
}））;
store.insert（3,[newPersonRecord（{
name:
'other1',
sex:
0
}）,newPersonRecord（{
name:
'other2',
sex:
0
}）]）;
删除操作可以使用remove（）和removeAll（）函数，它们分别可以删除指定的record和清空整个store中的数据，如下面的代码所示。
store.remove（store.getAt（0））;
store.removeAll（）;
store中没有专门提供修改某一行record的操作，我们需要先从store中获取一个record。
对这个record内部数据的修改会直接反映到store上，如下面的代码所示。
store.getAt（0）.set（'name','xxxx'）;
修改record的内部数据之后有两种选择：
执行rejectChanges（）撤销所有修改，将修改过的record恢复到原来的状态；执行commitChanges（）提交数据修改。
在执行撤销和提交操作之前，可以使用getModifiedRecords（）获得store中修改过的record数组。
与修改数据相关的参数是pruneModifiedRecords，如果将它设置为true，当每次执行删除或reload操作时，都会清空所有修改。
这样，在每次执行删除或reload操作之后，getModifiedRecords（）返回的就是一个空数组，否则仍然会得到上次修改过的record记录。
10.4.5 加载及显示数据
store创建好后，需要调用load（）函数加载数据，加载成功后才能对store中的数据进行操作。
load（）调用的完整过程如下面的代码所示。
store.load（{
params:
{start:
0,limit:
20},
callback:
function（records,options,success）{
Ext.Msg.alert（'info','加载完毕'）;
},
scope:
store,
add:
true
}）;
q params是在store加载时发送的附加参数。
q callback是加载完毕时执行的回调函数，它包含3个参数：
records参数表示获得的数据，options表示执行load（）时传递的参数，success表示是否加载成功。
q Scope用来指定回调函数执行时的作用域。
q Add为true时，load（）得到的数据会添加在原来的store数据的末尾，否则会先清除之前的数据，再将得到的数据添加到store中。
一般来说，为了对store中的数据进行初始化，load（）函数只需要执行一次。
如果用params参数指定了需要使用的参数，以后再次执行reload（）重新加载数据时，store会自动使用上次load（）中包含的params参数内容。
如果有一些需要固定传递的参数，也可以使用baseParams参数执行，它是一个JSON对象，里面的数据会作为参数发送给后台处理，如下面的代码所示。
store.baseParams.start=
升级会员 