Ext.data.Store的基本用法
标签:
杂谈 |
分类: extjs4.0 |
Ext.data.Store是EXT中用来进行数据交换和数据交互的标准中间件,无论是Grid还是ComboBox,都是通过它实现数据读取、类型转换、排序分页和搜索等操作的。
Ext.data.Store中有一个Ext.data.Record数组,所有数据都存放在这些Ext.data.
Record实例中,为后面的读取和修改操作做准备。
Ext.data.Store的基本用法
在使用之前,首先要创建一个Ext.data.Store的实例,如下面的代码所示。
01.var data = [
02.['boy', 0],
03.['girl', 1]
04.];
05.var store = new Ext.data.Store({
06.proxy: new Ext.data.MemoryProxy(data),
07.reader: new Ext.data.ArrayReader({}, PersonRecord)
08.});
09.store.load();
10.
11.
复制代码每个store最少需要两个组件的支持,分别是proxy和reader,proxy用于从某个途径读取原始数据,reader用于将原始数据转换成Record实例。
Ext.data.Store对数据进行排序
Ext.data.Store提供了一系列属性和函数,利用它们对数据进行排序操作。
01.var store = new Ext.data.Store({
02.proxy: new Ext.data.MemoryProxy(data),
03.reader: new Ext.data.ArrayReader({}, PersonRecord),
04.sortInfo: {field: 'name', direction: 'DESC'}
05.});
06.
07.
复制代码这样,在store加载数据之后,就会自动根据name字段进行降序排列。对store使用store.setDefaultSort('name','DESC');也会达到同样效果。
Ext.data.Store从store中获取数据
从store中获取数据有很多种途径,可以依据不同的要求选择不同的函数。
01.store.getAt(0).get('name')
02.
复制代码通过这种方式,我们可以遍历store中所有的record,依次得到它们的数据,如下面的代码所示。
01.for (var i = 0; i < store.getCount(); i++)
{
02.
03.
04.}
05.
复制代码Store.getCount()返回的是store中的所有数据记录,然后使用for循环遍历整个store,从而得到每条记录。
除了使用getCount()的方法外,还可以使用each()函数,如下面的代码所示。
01.store.each(function(record) {
02.alert(record.get('name'));
03.});
04.
05.
复制代码Each()可以接受一个函数作为参数,遍历内部record,并将每个record作为参数传递给function()处理。
如果希望停止遍历,可以让function()返回false。
也可以使用getRange()函数连续获得多个record,只需要指定开始和结束位置的索引值,如下面的代码所示。
01.var records = store.getRange(0, 1);
02.for (var i = 0; i < records.length; i++) {
03.var record = records;
04.alert(record.get('name'));
05.}
06.
07.
复制代码如果确实不知道record的id,也可以根据record本身的id从store中获得对应的record,如下面的代码所示。
01.store.getById(1001).get('name');
复制代码EXT还提供了函数find()和findBy(),可以利用它们对store中的数据进行搜索,如下面的代码所示。
01.find( String property, String/RegExp value, [Number
startIndex], [Boolean anyMatch],[Boolean caseSensitive] )
02.
复制代码在这5个参数中,只有前两个是必须的。
01.var index = store.find('name','g');
02.alert(store.getAt(index).get('name'));
复制代码与find()函数对应的findBy()函数的定义格式如下:
01.findBy( Function fn, [Object scope], [Number startIndex] ) :
Number
02.
复制代码findBy()函数允许用户使用自定义函数对内部数据进行搜索。
01.index = store.findBy(function(record, id) {
02.return record.get('name') == 'girl' && record.get('sex') == 1;
03.});
04.alert(store.getAt(index).get('name'));
05.
06.
复制代码通过findBy()函数,我们可以同时判断record中的多个字段,在函数中实现复杂逻辑。
01.alert(store.query('name', 'boy'));
02.alert(store.queryBy(function(record) {
03.return record.get('name') == 'girl' && record.get('sex')
== 1;
04.}));
05.
06.
复制代码Ext.data.Store更新store中的数据
可以使用add(Ext.data.Record[]
records)向store末尾添加一个或多个record,使用的参数可以是一个record实例,如下面的代码所示。
01.store.add(new PersonRecord({
02.name: 'other',
03.sex: 0
04.}));
05.
06.
复制代码Add()的也可以添加一个record数组,如下面的代码所示:
01.store.add([new PersonRecord({
02.name: 'other1',
03.sex: 0
04.}), new PersonRecord({
05.name: 'other2',
06.sex: 0
07.})]);
08.
09.
复制代码Add()函数每次都会将新数据添加到store的末尾,这就有可能破坏store原有的排序方式。如果希望根据store原来的排序方式将新数据插入到对应的位置,可以使用addSorted()函数。它会在添加新数据之后立即对store进行排序,这样就可以保证store中的数据有序地显示,如下面的代码所示。
01.store.addSorted(new PersonRecord({
02.name: 'lili',
03.sex: 1
04.}));
05.
06.
复制代码store会根据排序信息查找这条record应该插入的索引位置,然后根据得到的索引位置插入数据,从而实现对整体进行排序。这个函数需要预先为store设置本地排序,否则会不起作用。
01.store.insert(3, new PersonRecord({
02.name: 'other',
03.sex: 0
04.}));
05.store.insert(3, [new PersonRecord({
06.name: 'other1',
07.sex: 0
08.}), new PersonRecord({
09.name: 'other2',
10.sex: 0
11.})]);
12.
复制代码删除操作可以使用remove()和removeAll()函数,它们分别可以删除指定的record和清空整个store中的数据,如下面的代码所示。
01.store.remove(store.getAt(0));
02.store.removeAll();
03.
04.
复制代码store中没有专门提供修改某一行record的操作,我们需要先从store中获取一个record。对这个record内部数据的修改会直接反映到store上,如下面的代码所示。
01.store.getAt(0).set('name', 'xxxx');
02.
复制代码修改record的内部数据之后有两种选择:执行rejectChanges()撤销所有修改,将修改过的record恢复到原来的状态;执行commitChanges()提交数据修改。在执行撤销和提交操作之前,可以使用getModifiedRecords()获得store中修改过的record数组。
Ext.data.Store加载及显示数据
01.store.load({
02.params: {start:0,limit:20},
03.callback: function(records, options, success){
04.Ext.Msg.alert('info', '加载完毕');
05.},
06.scope: store,
07.add: true
08.});
09.
10.
复制代码1. params是在store加载时发送的附加参数。
01.store.baseParams.start = 0;
02.store.baseParams.limit = 20;
03.
04.
复制代码为store加载数据之后,有时不需要把所有数据都显示出来,这时可以使用函数filter和filterBy对store中的数据进行过滤,只显示符合条件的部分,如下面的代码所示。
01.filter( String field, String/RegExp value, [Boolean
anyMatch], [Boolean caseSensitive] ) : void
复制代码filter()函数的用法与之前谈到的find()相似,如下面的代码所示。
01.store.filter('name', 'boy');
02.
复制代码对应的filterBy()与findBy()类似,也可以在自定义的函数中实现各种复杂判断,如下面的代码所示。
01.store.filterBy(function(record) {
02.return record.get('name') == 'girl' &&
record.get('sex') == 1;
03.});
04.
05.
复制代码如果想取消过滤并显示所有数据,那么可以调用clearFilter()函数,如下面的代码所示。
01.store.clearFilter();
复制代码如果想知道store上是否设置了过滤器,可以通过isFiltered()函数进行判断。
Ext.data.Store其他功能
除了上面提到的数据获取、排序、更新、显示等功能外,store还提供了其他一些功能函数。
01.collect( String dataIndex, [Boolean allowNull], [Boolean
bypassFilter] ) : Array
复制代码
collect函数获得指定的dataIndex对应的那一列的数据,当allowNull参数为true时,返回的结果中可能会包含null、undefined或空字符串,否则collect函数会自动将这些空数据过滤掉。当bypassFilter参数为true时,collect的结果不会受查询条件的影响,无论查询条件是什么都会忽略掉,返回的信息是所有的数据,如下面的代码所示。
01.
02.alert(store.collect('name'));
复制代码
这样会获得所有name列的值,示例中返回的是包含了'boy'和'girl'的数组。
getTotalCount()用于在翻页时获得后台传递过来的数据总数。如果没有设置翻页,get-
TotalCount()的结果与getCount()相同,都是返回当前的数据总数,如下面的代码所示。
01.alert(store.getTotalCount());
复制代码
02.alert(store.indexOf(store.getAt(1)));
03.alert(store.indexOfId(1001));
复制代码
01.store.loadData(data, true);
复制代码
Sum(String property, Number start, Number
end):Number用于计算某一个列从start到end的总和,如下面的代码所示。
01.alert(store.sum('sex'));
复制代码
如果省略参数start和end,就计算全部数据的总和。
store还提供了一系列事件(见下表),让我们可以为对应操作设定操作函数。

加载中…