Ext Store.docx
《Ext Store.docx》由会员分享，可在线阅读，更多相关《Ext Store.docx（23页珍藏版）》请在冰点文库上搜索。
ExtStore
在使用Ext的Grid、ComboBox或DataView时，经常要用到Store，下面将详细分析Store结构。
1.1Store的结构
无论是JsonStore、XmlStore、还是ArrayStore，它们的结构与Store都是一样的。
不同之处在于它们的Reader不同，ArrayStore已经自动配置其Reader为ArrayReader。
同理，JsonStore的Reader为JsonReader，XmlStore的Reader为XmlReader，而Store则需要自己配置Reader。
这说明了Store无论读取的数据是数组、JSON对象或XML数据，最终都会转成Store本身的结构，然后提供给界面控件使用。
这样的好处就是界面控件不需要为处理不同的数据格式定义不同的处理方式，或者根据不同数据格式做不同的数据格式的界面控件。
因而，界面控件的显示问题，譬如没有数据显示、显示格式错误等，与用户返回的数据格式没有任何关系，只与Store中的数据有关系，调试界面控件的显示问题，首先要检查的就是Store的问题，譬如Store中是否有数据、其数据是否正确，等等。
Store主要由data、fields和reader三个部分组成：
*data 部分由Record对象组成数组构成，负责提供数据并记录数据处理信息。
*fields 部分记录Store中数据的字段构成以及如何与原始数据对应的方式。
*reader 部分记录原始数据信息。
1.2Ext.data.Field
Field对象只有几个配置属性，没有方法和时间。
其配置属性说明如下：
*allowBlank：
是否允许为空值。
默认值为true，表示允许为空值。
该属性一般在增加一个Record时，校验字段值时使用。
*convert：
在将Reader提供的数据转换到Store的Record时会执行该函数。
该函数一般在原始数据不是界面控件的显示数据并且需要做一些处理时使用。
其使用方法：
//convert函数，将firstname与lastname合成后再显示
functionfullName（v,record）{
returnrecord.name.last+','+record.name.first;
};
//如果city不是空值，则结合state一起返回
functionlocation（v,record）{
return!
record.city?
'':
（record.city+','+record.state）;
};
varmyRecord=Ext.data.Record.create（[
{name:
'fullname',convert:
fullName},
{name:
'firstname',mapping:
'name.first'},
{name:
'lastname',mapping:
'name.last'},
{name:
'city',defaultValue:
'homeless'},
'state',
{name:
'location',convert:
location}
]）;
varstore=newExt.data.Store（{
reader:
newExt.data.JsonReader（{idProperty:
'key',root:
'rows',totalProperty:
'total'}）,
myRecord
}）;
varmyData=[
{key:
1,name:
{first:
'Fat',last:
'Albert'}//nocity},
{key:
2,name:
{first:
'Barney',last:
'Rubble'},city:
'Bedrock',state:
'Stoneridge'},
{key:
3,name:
{first:
'Cliff',last:
'Claven'},city:
'Boston',state:
'MA'}
];一些实用功能，下面是用法：
*dateFormat：
日期格式。
*defaultValue：
字段的默认值。
当将Reader中原始数据转换成Store的Record时，找不到对应的数据，则使用该值代替。
默认值是空字符串。
*mapping：
将Reader中的字段映射到Record的字段中，如果Reader中的字段与Record的字段名称相同，可以不设置该属性。
*name：
字段的名称。
*storDir：
排序方式。
值“ASC”表示升序，“DESC”表示降序。
默认值是“ASC”。
*type：
字段的数据类型。
它包含以下数据类型：
auto（默认，不会进行数据类型转换）、string、int、float、boolean、date。
1.3Ext.data.Record
Record是Store最小的数据单元，它除了记录Store的一行数据信息，还记录了这些数据的状态，并可修改这些状态。
其属性和方法如下：
*data：
存储了该记录的数据信息。
*dirty：
只读属性，表示该记录是否被编辑过。
*fields：
记录的字段信息。
*id：
当前记录的唯一标记。
*modified：
当记录的某个数据被修改后，会在这里保存数据的原始值。
*phantom：
当该值为false时，表示服务器端数据库内没有该条数据。
*store：
记录所在的store。
*beginEdit：
开始编辑记录，其使用方法如下：
record.beginEdit（）;
*cancelEdit：
取消当前记录的修改，其使用方法如下：
record.cancelEdit（）;
*commit：
确认更新数据。
一般情况是使用Store的commitChanges方法，其使用方法如下：
mit（）;
mit（true）;//更新数据但不触发Store的change事件
*copy：
复制一个记录。
其使用方法如下：
record.copy（）;//自动产生一个id
record.copy（"id1"）;//使用id1作为新记录的id
*create：
构建一个记录结构。
该方法通常用于为Store增加一条新记录前构造一个记录结构，然后再创建新记录，并添加到Store。
其使用方法如下：
varTopicRecord=Ext.data.Record.create（[
{name:
'title'},
{name:
'author',allowBlank:
false}
]）;
varmyNewRerord=newTopicRecord（
{title:
'测试',author:
'张三'}
）;
myStore.add（myNewRecord）;
*endEdit：
结束编辑。
如果有数据被修改，Store的update事件将会被触发，其使用方法参考beginEdit方法。
*get：
获取某个字段的值。
其使用方法如下：
record.get（'company'）;//获取company的值
*getChanges：
获取被修改的字段。
其使用方法如下：
varrec=record.getChanges（）;//获取company的值
*isModified：
判断某个字段是否已被修改。
其使用方法如下：
//判断字段company是否已被修改
if（record.isModified（'company'）{
//处理过程
}
*isValid：
检验Record是否有效，主要是检验设置了Ext.data.Field.allowBlank为true的字段。
其使用方法：
if（record.isValid（））{
//处理过程
}
*markDirty：
标记记录已被修改。
其使用方法：
record.markDirty（）;
*reject：
取消记录的修改，回复原值。
一般情况是使用Store的rejectChanges方法。
其使用方法：
record.reject（）;
record.reject（true）;//更新数据但不触发Store的change事件
*set：
设置某个字段的值。
其使用方法：
varrec=myStore.getAt
（1）;//getAt（n）,n表示行的索引值。
getAt表示获取行
rec.set（'name','张三'）;
mit（）;
1.4ArrayReader、JsonReader和XmlReader
Reader的作用是将源数据转换成Record对象。
Store一般使用数组、JSON或XML等3种格式的数据，因而对应建立ArrayReader、JsonReader和XmlReader三个Reader。
因为Reader的作用是进行数据转换，所以定义一个Reader必须包含源数据的格式、Record的格式和两种格式之间的数据如何对应这三个部分。
明白这一点，对Reader的定义和使用就简单多了。
下面介绍这三种Reader的使用方法。
1.4.1JsonReader
JsonReader的数据定义只要提供root参数即可，它会根据root参数提供的属性名称去获取数据源中的数据。
totalProperty参数和idProperty参数都是可选的，totalProperty参数定义的是数据源中保存数据总数的属性名称，idProperty参数定义的是数据源中可作为记录唯一标记的字段名称，如果没有设置，Store会自动产生这个唯一标记。
字段映射需要在Record中定义。
通过下面的例子来了解一下具体定义方式：
varreader=newExt.data.JsonReader（
{
totalProperty:
'results',
root:
'rows',
idProperty:
'id'
},
[
{name:
'id',type:
'int'},//因为Record中该字段名称与数据源同名，所以不用设置mapping参数
{name:
'username',mapping:
'name'}//映射数据源的name字段到Record的username字段
]
）;
//以下返回的数据格式
{
results:
20,//记录总数
rows:
[//数据
{id:
1,name:
'张三'},
{id:
2,name:
'李四'}
...
]
}
从代码中可以看到：
JsonReader的第一个参数是数据源的定义，主要包含totalProperty、root和idProperty三个参数；第二个参数则是Record对象的定义。
如果Record对象的字段名称与数据源的字段名称相同，则不需要定义mapping参数。
1.4.2ArrayReader
ArrayReader是从JsonReader扩展出来的，因为数组其实是JSON的一种简化形式，数组中的索引就相当于JSON格式中的属性名称。
通过下面的例子来了解一下具体的定义方式：
varreader=newExt.data.ArrayReader（
{
idIndex:
0
},
[
{name:
'id',type:
'int',mapping:
0},
{name:
'username',mapping:
1}
]
）;
从代码中可以看到：
在数据源定义部分，idIndex参数代替了JsonReader的idProperty参数，而且其值为数组的索引值；在Record定义部分，mapping定义也由数组的索引值代替了字段名称。
如果Record是数组按顺序读取的，也可以不设置mapping.
1.4.4XmlReader
虽然XmlReader不是从JsonReader扩展的，但是其定义方式与JsonReader类似。
不同的地方是，使用record参数代替了JsonReader的root参数，id参数代替idProperty参数了。
通过下面的例子来了解一下具体的定义方式：
varreader=newExt.data.XmlReader（
{
totalProperty:
'results',
record:
'row',
id:
'id'
},
[
{name:
'id',type:
'int'},//因为Record中该字段名称与数据源同名，所以不用设置mapping参数
{name:
'username',mapping:
'name'}//映射数据源的name字段到Record的username字段
]
）;
//以下返回的数据格式
xmlversion="1.0"encoding="UTF-8"?
>
20
|
1
张三
|
2
李四
...
从代码中可以看到，它的定义与JsonReader的定义没有太大区别，要注意的是数据源的数据格式。
1.5Store的加载数据
Store加载数据时有一下4种方式：
*在定义Store时，配置autoload参数，这样在Store创建时会自动调用load方法加载数据，其使用方法：
varstore=newExt.data.ArrayStore（{
autoload:
true,
fields:
[
{name:
'company'},
{name:
'price',type:
'float'},
{name:
'change',type:
'float'},
{name:
'pctChange',type:
'float'},
{name:
'lastChange',type:
'date',dateFormat:
'n/jh:
ia'}
]
}）;
//在autoload中配置提交参数
varstore=newExt.data.ArrayStore（{
autoload:
{page:
1},
fields:
[
{name:
'company'},
{name:
'price',type:
'float'},
{name:
'change',type:
'float'},
{name:
'pctChange',type:
'float'},
{name:
'lastChange',type:
'date',dateFormat:
'n/jh:
ia'}
]
}）;
在第二段代码中可以看到，在autoload中定义了一个对象“{page:
1}”，该对象会在调用load方法时作为参数传递给load方法。
*在创建Store后，执行load方法。
该方法一般用于加载远程数据，其使用方法：
varstore=newExt.data.ArrayStore（{
fields:
[
{name:
'company'},
{name:
'price',type:
'float'},
{name:
'change',type:
'float'},
{name:
'pctChange',type:
'float'},
{name:
'lastChange',type:
'date',dateFormat:
'n/jh:
ia'}
]
}）;
store.load（）;
//带提交参数、回调函数以及追加数据
store.load（{
params:
{page:
1},
callback:
function（r,opts,success）{//处理过程},
scope:
this,
add:
true
}）;
在代码中，回调函数是在Store的load事件执行后才执行的，参数r表示返回的记录集，opts表示调用load方法时的配置参数对象，success表示数据加载是否成功，参数add的作用是指示加载数据后不清空原有的数据，将新数据追加到原有数据里。
*在创建Store后，使用loadData方法加载数据，该方法一般用于加载本地数据，其使用方法：
store.loadData（datas）;
//追加方式
store.loadData（datas,true）
*需要刷新数据，可以使用reload方法，其使用方法参考load方法。
在加载数据时，如果要修改提交参数，可使用baseParams属性设置，其使用方法如下：
store.baseParams.page=1;
store.load（）;
也可以使用setBaseParam方法，其使用方法如下：
store.setBaseParam（'page',1）;
store.load（）;
当然，也可以直接在load方法里当参数传递，其使用方法请看前面的load方法介绍。
1.6Store的数据操作
1.6.1添加数据
要给Store添加数据，可以使用insert方法、add方法、addSorted方法或loadData方法。
insert方法将在指定位置开始插入记录，一次可以插入多条记录；add方法则直接增加一条或多条记录；addSorted方法则在排序后的位置插入记录，该方法一次只能插入一条记录。
如果要使用loadData方法添加记录，则需要指定第2个参数为true，不然会清空原有数据再追加数据。
下面是它们的使用方法：
//添加单个记录
vardata={id:
1001,name:
'张三'};
varp=newstore.recordType（data,data.id）;
store.insert（2,p）;//在第一条记录后插入
store.add（p）;
store.addSorted（p）;
store.loadData（p,true）;
//添加多个记录
vardata1={id:
1001,name:
'张三'};
varp1=newstore.recordType（data1,data1.id）;
vardata2={id:
1002,name:
'李四'};
varp2=newstore.recordType（data2,data2.id）;
store.insert（0,[p1,p2]）;
store.add（[p1,p2]）;
store.loadData（[p1,p2],true）;
1.6.2删除数据
在Store中删除数据有remove、removeAll和removeAt这3种方法。
它们的使用方法如下：
store.remove（rec）;//rec为一个记录
store.removeAll（）;//删除所有记录
store.removeAt（10）;//10为索引值，
从上面代码中可以看到：
remove方法需要知道具体的记录才允许删除；removeAll删除全部记录，并触发clear事件；removeAt方法则删除指定位置的记录。
1.6.3搜索、定位和统计
Store提供了以下搜索和定位记录的方法：
*each：
枚举所有记录，当枚举函数返回false时，终止枚举操作。
其使用方法：
store.each（function（rec）{
//处理过程
}）;
*filter：
根据指定属性过滤记录。
其使用方法：
//过滤掉不是name不包含“张”的记录
store.filter（'name','张',true,false）;
代码中的过滤规则可使用字符串，也可以使用正则表达式。
第3个参数如果为false，则表示只匹配开始位置，为true则表示匹配任何位置；第4个参数如果为false，则表示不区分大小写，为true则表示要匹配大小写。
*filterBy：
通过一个函数过滤记录。
该函数会枚举每一个记录，然后根据函数返回值判断记录是否被过滤。
如果函数返回true，则包含该记录，如果返回false，则过滤掉该记录。
其使用方法：
//返回id为单数的记录
store.filterBy（function（rec,id）{
if（id%2==0）{
returntrue;
}
else{
returnfalse;
}
}）;
*isFiltered：
判断Store当前是否处于过滤状态。
如果是，返回true；否则，返回false。
其使用方法：
if（store.isFiltered（））{
store.clearFilter（）;
}
*clearFilter：
将Store恢复到没有进行过滤的状态，其使用方法可参考isFiltered中的代码。
*find：
根据指定属性查找匹配的记录，并返回匹配的第一个记录的索引值。
如果没有找到匹配的记录，则返回-1。
其使用方法如下：
varindex=store.filter（'name','张',2,true,false）;
与filter方法一样，搜索值可以是字符串，也可以是正则表达式。
第3个参数为搜索开始位置，默认值是0。
第4个参数如果为false，则表示只匹配开始位置，为true则表示匹配任何位置。
第5个参数如果为false，表示不区分大小写，如果为true则表示要区分大小写。
*findBy：
通过一个函数查找匹配的记录并返回匹配的第一个记录的索引值。
该函数会从指定的开始位置枚举每一个记录，然后根据返回值判断记录是否匹配。
如果函数返回true，则表示已经找不到匹配记录，枚举操作结束并返回匹配记录的索引值。
如果没有找到匹配的记录，方法返回值为-1。
其使用方法如下：
store.findBy（function（rec,id）{
if（id%2==0）{
returntrue;
}
else{
returnfalse;
}
},2）;
在代码中，第2个参数“2”表示查找的开始位置。
*findExact：
与find方法作用一样，只是没有匹配位置和区分大小写参数。
其使用方法可参考find方法。
*getAt：
根据索引值获取一个记录，其使用方法：
//获得第2条记录
varrec=store.getAt
（2）;
*getById：
根据记录id返回记录，其使用方法：
//获得id为2的记录
varrec=store.getById
（2）;
*getCount：
返回Store的记录总数。
如果没有采用分页方式，则其返回结果与getTotalCount方法一样。
如果采用了分页方式，则getCount返回的是Store的记录总数，getTotalCount返回的才是数据库的记录总数，不过前提是
升级会员 