`
langgufu
  • 浏览: 2285885 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

ExtJs之Ext.data.Store详解(转载)

阅读更多
Ext.data.Store是EXT中用来进行数据交换和数据交互的标准中间件,无论是Grid还是ComboBox,都是通过它实现数据读取、类型转换、排序分页和搜索等操作的。 Ext.data.Store中有一个Ext.data.Record数组,所有数据都存放在这些Ext.data. Record实例中,为后面的读取和修改操作做准备。 Ext.data.Store的基本用法 在使用之前,首先要创建一个Ext.data.Store的实例,如下面的代码所示。
  1. var data = [   
  2.     ['boy', 0],   
  3.     ['girl', 1]   
  4. ];   
  5.   
  6. var store = new Ext.data.Store({   
  7.     proxy: new Ext.data.MemoryProxy(data),   
  8.     reader: new Ext.data.ArrayReader({}, PersonRecord)   
  9. });   
  10.   
  11. store.load();  
 
  1. var data = [  
  2.     ['boy', 0],  
  3.     ['girl', 1]  
  4. ];  
  5.   
  6. var store = new Ext.data.Store({  
  7.     proxy: new Ext.data.MemoryProxy(data),  
  8.     reader: new Ext.data.ArrayReader({}, PersonRecord)  
  9. });  
  10.   
  11. 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的最基本用法。 Ext.data.Store对数据进行排序Ext.data.Store提供了一系列属性和函数,利用它们对数据进行排序操作。 可以在创建Ext.data.Store时使用sortInfo参数指定排序的字段和排序方式,如下面的代码所示。
  1. var store = new Ext.data.Store({   
  2.     proxy: new Ext.data.MemoryProxy(data),   
  3.     reader: new Ext.data.ArrayReader({}, PersonRecord),   
  4.     sortInfo: {field: 'name', direction: 'DESC'}   
  5. });  
 
  1. var store = new Ext.data.Store({  
  2.     proxy: new Ext.data.MemoryProxy(data),  
  3.     reader: new Ext.data.ArrayReader({}, PersonRecord),  
  4.     sortInfo: {field: 'name', direction: 'DESC'}  
  5. });  
这样,在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()时都要去后台重新加载数据,而不能只对本地数据进行排序。 Ext.data.Store从store中获取数据 从store中获取数据有很多种途径,可以依据不同的要求选择不同的函数。 最直接的方法是根据record在store中的行号获得对应的record,得到了record就可以使用get()函数获得里面的数据了,如下面的代码所示。
  1. store.getAt(0).get('name')  
 
  1. store.getAt(0).get('name')  
通过这种方式,我们可以遍历store中所有的record,依次得到它们的数据,如下面的代码所示。
  1. for (var i = 0; i < store.getCount(); i++) {   
  2.     var record = store.getAt(i);   
  3.     alert(record.get('name'));   
  4. }  
 
  1. for (var i = 0; i < store.getCount(); i++) {  
  2.     var record = store.getAt(i);  
  3.     alert(record.get('name'));  
  4. }  
Store.getCount()返回的是store中的所有数据记录,然后使用for循环遍历整个store,从而得到每条记录。 除了使用getCount()的方法外,还可以使用each()函数,如下面的代码所示。
  1. store.each(function(record) {   
  2.     alert(record.get('name'));   
  3. });  
 
  1. store.each(function(record) {  
  2.     alert(record.get('name'));  
  3. });  
Each()可以接受一个函数作为参数,遍历内部record,并将每个record作为参数传递给function()处理。 如果希望停止遍历,可以让function()返回false。 也可以使用getRange()函数连续获得多个record,只需要指定开始和结束位置的索引值,如下面的代码所示。
  1. var records = store.getRange(0, 1);   
  2.   
  3. for (var i = 0; i < records.length; i++) {   
  4.     var record = records[i];   
  5.     alert(record.get('name'));   
  6. }  
 
  1. var records = store.getRange(0, 1);  
  2.   
  3. for (var i = 0; i < records.length; i++) {  
  4.     var record = records[i];  
  5.     alert(record.get('name'));  
  6. }  
如果确实不知道record的id,也可以根据record本身的id从store中获得对应的record,如下面的代码所示。
  1. store.getById(1001).get('name')  
 
  1. store.getById(1001).get('name')  
EXT还提供了函数find()和findBy(),可以利用它们对store中的数据进行搜索,如下面的代码所示。
  1. find( String property, String/RegExp value, [Number startIndex], [Boolean anyMatch],[Boolean caseSensitive] )   
 
  1. find( String property, String/RegExp value, [Number startIndex], [Boolean anyMatch],[Boolean caseSensitive] )   
在这5个参数中,只有前两个是必须的。 第一个参数property代表搜索的字段名; 第二个参数value是匹配用字符串或正则表达式; 第三个参数startIndex表示从第几行开始搜索; 第四个参数anyMatch为true时,不必从头开始匹配; 第五个参数caseSensitive为true时,会区分大小写。 如下面的代码所示:
  1. var index = store.find('name','g');   
  2.   
  3. alert(store.getAt(index).get('name'));  
 
  1. var index = store.find('name','g');  
  2.   
  3. alert(store.getAt(index).get('name'));  
与find()函数对应的findBy()函数的定义格式如下:
  1. findBy( Function fn, [Object scope], [Number startIndex] ) : Number  
 
  1. findBy( Function fn, [Object scope], [Number startIndex] ) : Number  
findBy()函数允许用户使用自定义函数对内部数据进行搜索。 fn返回true时,表示查找成功,于是停止遍历并返回行号。 fn返回false时,表示查找失败(即未找到),继续遍历,如下面的代码所示。
  1. index = store.findBy(function(record, id) {   
  2.     return record.get('name') == 'girl' && record.get('sex') == 1;   
  3. });   
  4.   
  5. alert(store.getAt(index).get('name'));  
 
  1. index = store.findBy(function(record, id) {  
  2.     return record.get('name') == 'girl' && record.get('sex') == 1;  
  3. });  
  4.   
  5. alert(store.getAt(index).get('name'));  
通过findBy()函数,我们可以同时判断record中的多个字段,在函数中实现复杂逻辑。 我们还可以使用query和queryBy函数对store中的数据进行查询。 与find和findBy不同的是,query和queryBy返回的是一个MixCollection对象,里面包含了搜索得到的数据,如下面的代码所示。
  1. alert(store.query('name''boy'));   
  2.   
  3. alert(store.queryBy(function(record) {   
  4.     return record.get('name') == 'girl' && record.get('sex') == 1;   
  5. }));  
 
  1. alert(store.query('name''boy'));  
  2.   
  3. alert(store.queryBy(function(record) {  
  4.     return record.get('name') == 'girl' && record.get('sex') == 1;  
  5. })); 

第二: 

Ext.data.Store更新store中的数据 可以使用add(Ext.data.Record[] records)向store末尾添加一个或多个record,使用的参数可以是一个record实例,如下面的代码所示。
  1. store.add(new PersonRecord({   
  2.     name: 'other',   
  3.     sex: 0   
  4. }));  
 
  1. store.add(new PersonRecord({  
  2.     name: 'other',  
  3.     sex: 0  
  4. }));  
Add()的也可以添加一个record数组,如下面的代码所示:
  1. store.add([new PersonRecord({   
  2.     name: 'other1',   
  3.     sex: 0   
  4. }), new PersonRecord({   
  5.     name: 'other2',   
  6.     sex: 0   
  7. })]);  
 
  1. store.add([new PersonRecord({  
  2.     name: 'other1',  
  3.     sex: 0  
  4. }), new PersonRecord({  
  5.     name: 'other2',  
  6.     sex: 0  
  7. })]);  
Add()函数每次都会将新数据添加到store的末尾,这就有可能破坏store原有的排序方式。如果希望根据store原来的排序方式将新数据插入到对应的位置,可以使用addSorted()函数。它会在添加新数据之后立即对store进行排序,这样就可以保证store中的数据有序地显示,如下面的代码所示。
  1. store.addSorted(new PersonRecord({   
  2.     name: 'lili',   
  3.     sex: 1   
  4. }));  
 
  1. store.addSorted(new PersonRecord({  
  2.     name: 'lili',  
  3.     sex: 1  
  4. }));  
store会根据排序信息查找这条record应该插入的索引位置,然后根据得到的索引位置插入数据,从而实现对整体进行排序。这个函数需要预先为store设置本地排序,否则会不起作用。 如果希望自己指定数据插入的索引位置,可以使用insert()函数。它的第一个参数表示插入数据的索引位置,可以使用record实例或record实例的数组作为参数,插入之后,后面的数据自动后移,如下面的代码所示。
  1. store.insert(3, new PersonRecord({   
  2.     name: 'other',   
  3.     sex: 0   
  4. }));   
  5.   
  6. store.insert(3, [new PersonRecord({   
  7.     name: 'other1',   
  8.     sex: 0   
  9. }), new PersonRecord({   
  10.     name: 'other2',   
  11.     sex: 0   
  12. })]);  
 
  1. store.insert(3, new PersonRecord({  
  2.     name: 'other',  
  3.     sex: 0  
  4. }));  
  5.   
  6. store.insert(3, [new PersonRecord({  
  7.     name: 'other1',  
  8.     sex: 0  
  9. }), new PersonRecord({  
  10.     name: 'other2',  
  11.     sex: 0  
  12. })]);  
删除操作可以使用remove()和removeAll()函数,它们分别可以删除指定的record和清空整个store中的数据,如下面的代码所示。
  1. store.remove(store.getAt(0));   
  2. store.removeAll();  
 
  1. store.remove(store.getAt(0));  
  2. store.removeAll();  
store中没有专门提供修改某一行record的操作,我们需要先从store中获取一个record。对这个record内部数据的修改会直接反映到store上,如下面的代码所示。
  1. store.getAt(0).set('name''xxxx');  
 
  1. store.getAt(0).set('name''xxxx');  
修改record的内部数据之后有两种选择:执行rejectChanges()撤销所有修改,将修改过的record恢复到原来的状态;执行commitChanges()提交数据修改。在执行撤销和提交操作之前,可以使用getModifiedRecords()获得store中修改过的record数组。 与修改数据相关的参数是pruneModifiedRecords,如果将它设置为true,当每次执行删除或reload操作时,都会清空所有修改。这样,在每次执行删除或reload操作之后,getModifiedRecords()返回的就是一个空数组,否则仍然会得到上次修改过的record记录Ext.data.Store加载及显示数据 store创建好后,需要调用load()函数加载数据,加载成功后才能对store中的数据进行操作。load()调用的完整过程如下面的代码所示。
  1. store.load({   
  2.     params: {start:0,limit:20},   
  3.     callback: function(records, options, success){   
  4.         Ext.Msg.alert('info''加载完毕');   
  5.     },   
  6.     scope: store,   
  7.     add: true  
  8. });  
 
  1. store.load({  
  2.     params: {start:0,limit:20},  
  3.     callback: function(records, options, success){  
  4.         Ext.Msg.alert('info''加载完毕');  
  5.     },  
  6.     scope: store,  
  7.     add: true  
  8. });  
1. params是在store加载时发送的附加参数。 2. callback是加载完毕时执行的回调函数,它包含3个参数:records参数表示获得的数据,options表示执行load()时传递的参数,success表示是否加载成功。 3. Scope用来指定回调函数执行时的作用域。 4. Add为true时,load()得到的数据会添加在原来的store数据的末尾,否则会先清除之前的数据,再将得到的数据添加到store中。 一般来说,为了对store中的数据进行初始化,load()函数只需要执行一次。如果用params参数指定了需要使用的参数,以后再次执行reload()重新加载数据时,store会自动使用上次load()中包含的params参数内容。 如果有一些需要固定传递的参数,也可以使用baseParams参数执行,它是一个JSON对象,里面的数据会作为参数发送给后台处理,如下面的代码所示。
  1. store.baseParams.start = 0;   
  2. store.baseParams.limit = 20;  
 
  1. store.baseParams.start = 0;  
  2. store.baseParams.limit = 20;  

 

第三:

为store加载数据之后,有时不需要把所有数据都显示出来,这时可以使用函数filter和filterBy对store中的数据进行过滤,只显示符合条件的部分,如下面的代码所示。
  1. filter( String field, String/RegExp value, [Boolean anyMatch], [Boolean caseSensitive] ) : void  
 
  1. filter( String field, String/RegExp value, [Boolean anyMatch], [Boolean caseSensitive] ) : void  
filter()函数的用法与之前谈到的find()相似,如下面的代码所示。
  1. store.filter('name''boy');  
 
  1. store.filter('name''boy');  
对应的filterBy()与findBy()类似,也可以在自定义的函数中实现各种复杂判断,如下面的代码所示。
  1. store.filterBy(function(record) {   
  2.     return record.get('name') == 'girl' && record.get('sex') == 1;   
  3. });  
 
  1. store.filterBy(function(record) {  
  2.     return record.get('name') == 'girl' && record.get('sex') == 1;  
  3. });  
如果想取消过滤并显示所有数据,那么可以调用clearFilter()函数,如下面的代码所示。
  1. store.clearFilter();  
 
  1. store.clearFilter();  
如果想知道store上是否设置了过滤器,可以通过isFiltered()函数进行判断。 Ext.data.Store其他功能 除了上面提到的数据获取、排序、更新、显示等功能外,store还提供了其他一些功能函数。
  1. collect( String dataIndex, [Boolean allowNull], [Boolean bypassFilter] ) : Array  
 
  1. collect( String dataIndex, [Boolean allowNull], [Boolean bypassFilter] ) : Array  
collect函数获得指定的dataIndex对应的那一列的数据,当allowNull参数为true时,返回的结果中可能会包含null、undefined或空字符串,否则collect函数会自动将这些空数据过滤掉。当bypassFilter参数为true时,collect的结果不会受查询条件的影响,无论查询条件是什么都会忽略掉,返回的信息是所有的数据,如下面的代码所示。
  1. alert(store.collect('name'));  
 
  1. alert(store.collect('name'));  
这样会获得所有name列的值,示例中返回的是包含了'boy'和'girl'的数组。 getTotalCount()用于在翻页时获得后台传递过来的数据总数。如果没有设置翻页,get- TotalCount()的结果与getCount()相同,都是返回当前的数据总数,如下面的代码所示。
  1. alert(store.getTotalCount());  
 
  1. alert(store.getTotalCount());  
indexOf(Ext.data.Record record)和indexOfId(String id)函数根据record或record的id获得record对应的行号,如下面的代码所示。
  1. alert(store.indexOf(store.getAt(1)));   
  2. alert(store.indexOfId(1001));  
 
  1. alert(store.indexOf(store.getAt(1)));  
  2. alert(store.indexOfId(1001));  
loadData(object data, [Boolean append])从本地JavaScript变量中读取数据,append为true时,将读取的数据附加到原数据后,否则执行整体更新,如下面的代码所示。
  1. store.loadData(data, true);  
 
  1. store.loadData(data, true);  
Sum(String property, Number start, Number end):Number用于计算某一个列从start到end的总和,如下面的代码所示。
  1. alert(store.sum('sex'));  
 
  1. alert(store.sum('sex'));  
如果省略参数start和end,就计算全部数据的总和。 store还提供了一系列事件(见下表),让我们可以为对应操作设定操作函数。
 store提供的事件

事件名

参  数

add

( Store this, Ext.data.Record[] records, Number index )

beforelaod

( Store this, Object options )

clear

( Store this )

datachanged

( Store this )

load

( Store this, Ext.data.Record[] records, Object options )

loadexception

()

metachange

( Store this, Object meta. )

remove

( Store this, Ext.data.Record record, Number index )

update

( Store this, Ext.data.Record record, String operation )

至此,store和record等组件已经讲解完毕,下面我们主要讨论一下常用的proxy和reader组件。

 

分享到:
评论
1 楼 jpfrmd 2014-01-26  
你好,楼主现在在吗?能不能加下我的QQ,1031568262  我extjs有问题请教你。能不能加下,或者回复我下。

相关推荐

Global site tag (gtag.js) - Google Analytics