Ext3.3的Record和Store

1.Ext.data.Record

定义：Ext.data.Record就是一个设定了内部数据类型的对象，它是Ext.data.Store的最基本组成部分。如果把Ext.data.Store看作是一张二维表，那么它的每一行就对应一个Ext.data.Record实例。

Ext.data.Record的主要功能是保存数据，并且在内部数据发生改变时记录修改的状态，它还可以保留修改之前的原始值。

用法：使用Ext.data.Record时通常都是由create()函数开始的，首先用create()函数创建一个自定义的Record类型，如下面的代码所示：

var PersonRecord=Ext.data.Record.create([

{name:'name',type:'string'}

{name:'name',type:'int'}

]);

PersonRecord就是我们定义的新类型，包含字符串类型的name和整数类型的sex两个属性，然后使用new关键字创建PersonRecord的实例，如下面的代码所示：

var boy=new PersonRecord({

name:'boy',

sex:0

});

创建对象时，可以直接通过构造方法为对象赋予初始值，将‘boy’赋值给name，0赋值给sex。

现在我们得到了PersonRecord的实例boy。如何才能得到它的属性呢？以下3种方式都可以获得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='boy name';

boy.data['name']='boy name';

而应该使用set()函数，如下面的代码所示：

boy.set('name','boy name');

set()函数会判断属性值是否发生了改变，如果改变了，就要将当前对象的dirty属性设置为true,并将修改之前的原始值放入modified对象中，供其他函数使用。如果直接操作data中的值，record就无法记录属性的数据的修改情况。

在Record的属性数据被修改后，可以执行如下几种操作。

commit() 提交：这个函数的效果是设置dirty为false，并删除modified中保存的原始数据。

reject() 撤销：这个函数的效果是将data中已经修改了的属性值都恢复成modified中保存的原始数据，然后将dirty设置为false，并删除保存原始数据的modified对象。

getChanges() 获得修改的部分：这个函数会把data中讲过修改的属性和数据放在一个JSON对象里并返回。例如上例中，getChanges()返回的结果是{name:'body name'}。

还可以调用isModified()判断当前record中的数据是否被修改。

Ext.data.Record还提供了用于复制record实例的函数copy()。

var copyBoy =boy.copy();
这样就得到了boy的一个副本，它里面包含了boy的data数据，但copy()函数不会复制dirty和modified等额外的属性值。

2.Ext.data.Store

定义：Ext.data.Store是EXT中用来进行数据交换和数据交互的标准中间件，无论是表格还是ComboBox，都是通过它是实现数据读取，类型转换，排序分页和搜索等操作的。

基本用法：Ext.data.Store中有一个Ext.data.Record数组，所有数据都存放在这些Ext.data.Record实例中，为后面的读取和修改操作做准备。

每个store最少需要两个组件的支持，分别是proxy和reader,proxy用于从某个途径读取原始数据，reader用于将原始数据转换成Record实例。

例如：

var data=[

['boy',0],

['girl',1]

]

var store=new Ext.data.Store({

proxy:new Ext.data.MemoryProxy(data),

reader:new Ext.data.ArrayReader({},PersonRecord)

});

store.load();

这里使用的是Ext.data.MemoryProxy和Ext.data.ArrayReader，将data数组中的数据转换成对应的几个PersonRecord实例，然后放入store中。store创建完毕后，执行store.load()实现这个转换过程。经过转换之后，store里的数据就可以提供给表格或ComboBox使用了，这就是Ext.data.Store的最基本用法。

对数据进行排序：

1.在创建时使用sortInfo参数指定排序的字段和排序方式，如下面的代码所示：

var store=new Ext.data.Store({

proxy:new Ext.data.MemoryProxy(data),

reader:new Ext.data.ArrayReader({},PersonRecord),

sortInfo:{field:'name',direction:'DESC'}

});

2.Store.setDefaultSort('name','DESC');

3.Store.sort('name','DESC');

4.如果我们希望获得store的排序信息，可以调用getSortState()函数，返回的是类似{field:"name",direction:"DESC"}的JSON对象。

5.与排序相关的参数还有remoteSort,这个参数是用来实现后台排序功能的。当设置为remoteSort:true时，store会在向后台请求数据时自动加入sort和dir两个参数，分别对应排序的方式，由后台获取并处理这两个参数，在后台对所需数据进行排序操作。remoteSort:true也会导致每次执行sort()时都要去后台重新加载数据，而不是只对本地数据进行排序。

从store中获取数据

1.store.getAt(0).get('name');

2.for(var i=0;i<store.getCount();i++){

var record=store.getAt(i);

alert(record.get('name'));

   }

3.Store.each(function(record){

alert(record.get('name'));

});

4.使用getRange()函数连续获得多个record,只需要指定开始和结束位置的索引值，如下：

var records=store.getRange(0,1);

for(var i=0;i<records.length;i++){

var record=records[i];

alert(record.get('name'));

}

5.如果确实不知道record的index,也可以根据record本身的id从store中获得对应的record,如下面的代码所示：

store.getById(1001).get('name');

6.Ext还提供了函数find()和findBy()，可以利用它们对store中的数据进行搜索，如下面的代码所示：

find(String property,String/RegExp value,[Number startIndex],[Boolean anyMatch],[Boolean caseSensitive])

在这5个参数中，只有前两个是必须。第一个参数property代表搜索的字段名；第二个参数value是匹配用字符串或正则表达式；第三个参数startIndex表示从第几行开始搜索，第四个参数anyMatch为true时，不必从头开始匹配；第五个参数caseSensitive为true时，会区分大小写。如下：

var index=store.find('name',9);

alert(store.getAt(index).get('name'));

与find()函数对应的findBy()函数的定义格式如下：

findBy(Function fn,[Object scope],[Number startIndex]):Number

findBy()函数允许用户使用自定义函数对内部数据进行搜索，fn返回true时，表示查找成功，于是停止遍历并返回行号。fn返回false时，表示查找失败(即未找到)，继续遍历，如下面的代码：

index=store.findBy(function(record,id){

return record.get('name')=='girl' && record.get('sex')==1;

});

alert(store.getAt(index).get('name'));

使用findBy()函数可以同时判断record中的多个字段，在函数中实现复杂逻辑。

7.还可以使用query和queryBy函数对store中的数据进行查询。与find和findBy不同的是，query和queryBy返回的是一个MixCollection对象，里面包含了搜索得到的数据，如下面的代码所示：

alert(store.query('name','boy'));

alert(store.queryBy(function(record){

return record.get('name')=='grid'&&record.get('sex')==1;

}));

更新Store中的数据

1.可以使用add(Ext.data.Record[ ] records) 向store末尾添加一个或多个(数组)record，使用的参数可以是一个record实例，如下面的代码所示：

store.add(new PersonRecord({

name:'other',

sex:0

}));

add()也可以添加一个record数组，如下面的代码所示：

store.add([new PersonRecord({

name:'other1',

sex:0

}),new PersonRecord({

name:'other2',

sex:0

})]);

add()函数每次都会将新数据添加到store的末尾，这就有可能破环store原有的排序方式。如果希望根据store原来的排序方式将新数据插入到对应的位置，可以使用addSorted函数。它会在添加新数据之后立即对store进行排序，这样就可以保证store中的数据有序地显示，如下：

store.addSorted(new PersonRecord({

name:'lili',

sex:1

}));

store会根据排序信息查找这条record应该插入的索引位置，然后根据得到的索引位置插入数据，从而实现对整体进行排序。这个函数需要预先为store设置本地排序，否则会不起作用。

2.将数据插入到指定的位置，例子：

store.insert(3,new PersonRecord({

name:'other',

sex:0

}));

注意：第二个参数也可以是record数组插入之后，后面的数据自动后移。

3.删除操作

可以使用remove()和removeAll()函数，它们分别可以删除指定的record和清空整个store中的数据。

store.remove(store.getAt(0));

store.removeAll();

4.修改操作

store.getAt(0).set('name','xxxx');

注意：a.修改record的内部数据之后有两种选择：执行rejectChanges()撤销所有修改，将修改过的record恢复到原来的状态；执行commitChanges()提交数据修改。在执行撤销和提交操作之前，可以使用getModifiedRecords()获得store中修改过的record数组。

    b.与修改数据相关的参数是prueModifiedRecords，如果将它设置为true,那么在每次执行删除或者reload操作时，都会清空所有修改。这样，在每次执行删除或者reload操作之后，getModifiedRecords()返回的就是一个空数组，否则仍然会得到上次修改过的record记录。

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

});

*params是在store加载时发送的附加参数。

*callback是加载完毕时执行的回调函数，它包含3个参数：records表示获得的数据，options表示执行load()时传递的参数，success表示是否加载成功。

*scope用来指定回调函数执行时的作用域。

*add为true时，load()得到的数据会添加在原来的store数据的末尾，否则会先清除之前的数据，再将得到的数据添加到store中。

一般来说，为了对store中的数据进行初始化，load()函数只需要执行一次。如果用params参数指定了需要使用的参数，以后再次执行reload()重新加载数据时，store会自动使用上次load()中包含的params参数内容。

如果有一些需要固定传递的参数，也可以使用baseParams参数执行，它是一个JSON对象，里面的数据会作为参数发送给后台处理，如下面的代码所示：

store.baseParams.start=0;

store.baseParams.limit=10;

为store加载数据之后，有时不需要把所有数据都显示出来，这时可以使用函数filter和filterBy对store中的数据进行过滤，只显示符合条件的部分，如下：

filter(String field,String/RegExp value,[Boolean anyMatch],[Boolean caseSensitive])  :  void

filter()函数的用法与之前谈到的find()相似，如下：

store.filter('name','boy');

对应的filterBy()与findBy()类似，也可以在自定义的函数中实现各种复杂判断，如下：

store.filterBy(function(record){

return record.get('name')=='gril' && record.get('sex')==1

});

如果想取消过滤并显示所有数据，那么可以调用clearFilter()函数，如下面的代码所示：

store.clearFilter();

如果想知道store上是否设置了过滤器，可以通过isFiltered()函数进行判断。

6.其他功能

a.collect函数获得指定的dataIndex对应的那一列的数据。如下：

alert(store.collect('name'));

b.getTotalCount()用于在翻页时获得后台传递过来的数据总数。如果设置了分页getCount()就是当前页面的数据量，如果没有设置翻页getTotalCount()的结果与getCount()相同，都是返回当前的数据总数，如下：

alert(store.getTotalCount());