Ext.data.Store是EXT中用來進行數(shù)據(jù)交換和數(shù)據(jù)交互的標準中間件,無論是Grid還是ComboBox,都是通過它實現(xiàn)數(shù)據(jù)讀取、類型轉(zhuǎn)換、排序分頁和搜索等操作的。
Ext.data.Store中有一個Ext.data.Record數(shù)組,所有數(shù)據(jù)都存放在這些Ext.data. Record實例中,為后面的讀取和修改操作做準備。
一、Ext.data.Store基本應用
在使用之前,首先要創(chuàng)建一個Ext.data.Store的實例,如下面的代碼所示。
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();
每個store最少需要兩個組件的支持,分別是proxy和reader,proxy用于從某個途徑讀取原始數(shù)據(jù),reader用于將原始數(shù)據(jù)轉(zhuǎn)換成Record實例。
這里我們使用的是
Ext.data.MemoryProxy和Ext.data.ArrayReader,將data數(shù)組中的數(shù)據(jù)轉(zhuǎn)換成對應的幾個
PersonRecord實例,然后放入store中。store創(chuàng)建完畢之后,執(zhí)行store.load()實現(xiàn)這個轉(zhuǎn)換過程。
經(jīng)過轉(zhuǎn)換之后,store里的數(shù)據(jù)就可以提供給Grid或ComboBox使用了,這就是Ext.data. Store的最基本用法。
二、Ext.data.Store對數(shù)據(jù)進行排序
Ext.data.Store提供了一系列屬性和函數(shù),利用它們對數(shù)據(jù)進行排序操作。
可以在創(chuàng)建Ext.data.Store時使用sortInfo參數(shù)指定排序的字段和排序方式,如下面的代碼所示。
var store = new Ext.data.Store({
proxy: new Ext.data.MemoryProxy(data),
reader: new Ext.data.ArrayReader({}, PersonRecord),
sortInfo: {field: 'name', direction: 'DESC'}
});
這樣,在store加載數(shù)據(jù)之后,就會自動根據(jù)name字段進行降序排列。對store使用store.setDefaultSort('name','DESC');也會達到同樣效果。
也可以在任何時候調(diào)用sort()函數(shù),比如store.sort('name', 'DESC');,對store中的數(shù)據(jù)進行排序。
如果我們希望獲得store的排序信息,可以調(diào)用getSortState()函數(shù),返回的是類似{field: "name", direction: " DESC"}的JSON對象。
與排序相關(guān)的參數(shù)還有
remoteSort,這個參數(shù)是用來實現(xiàn)后臺排序功能的。當設置為remoteSort:true時,store會在向后臺請求數(shù)據(jù)時自動加入sort
和dir兩個參數(shù),分別對應排序的字段和排序的方式,由后臺獲取并處理這兩個參數(shù),在后臺對所需數(shù)據(jù)進行排序操作。remoteSort:true也會導
致每次執(zhí)行sort()時都要去后臺重新加載數(shù)據(jù),而不能只對本地數(shù)據(jù)進行排序。
三、Ext.data.Store加載及顯示數(shù)據(jù)
store創(chuàng)建好后,需要調(diào)用load()函數(shù)加載數(shù)據(jù),加載成功后才能對store中的數(shù)據(jù)進行操作。load()調(diào)用的完整過程如下面的代碼所示。
store.load({
params: {start:0,limit:20},
callback: function(records, options, success){
Ext.Msg.alert('info', '加載完畢');
},
scope: store,
add: true
});
params是在store加載時發(fā)送的附加參數(shù)。
callback是加載完畢時執(zhí)行的回調(diào)函數(shù),它包含3個參數(shù):records參數(shù)表示獲得的數(shù)據(jù),options表示執(zhí)行l(wèi)oad()時傳遞的參數(shù),success表示是否加載成功。
Scope用來指定回調(diào)函數(shù)執(zhí)行時的作用域。
Add為true時,load()得到的數(shù)據(jù)會添加在原來的store數(shù)據(jù)的末尾,否則會先清除之前的數(shù)據(jù),再將得到的數(shù)據(jù)添加到store中。
一般來說,為了對store中的數(shù)據(jù)進行初始化,load()函數(shù)只需要執(zhí)行一次。如果用params參數(shù)指定了需要使用的參數(shù),以后再次執(zhí)行reload()重新加載數(shù)據(jù)時,store會自動使用上次load()中包含的params參數(shù)內(nèi)容。
如果有一些需要固定傳遞的參數(shù),也可以使用baseParams參數(shù)執(zhí)行,它是一個JSON對象,里面的數(shù)據(jù)會作為參數(shù)發(fā)送給后臺處理,如下面的代碼所示。
store.baseParams.start = 0;
store.baseParams.limit = 20;
為store加載數(shù)據(jù)之后,有時不需要把所有數(shù)據(jù)都顯示出來,這時可以使用函數(shù)filter和filterBy對store中的數(shù)據(jù)進行過濾,只顯示符合條件的部分,如下面的代碼所示。
filter( String field, String/RegExp value, [Boolean anyMatch],
[Boolean caseSensitive] ) : void
filter()函數(shù)的用法與之前談到的find()相似,如下面的代碼所示。
store.filter('name', 'boy');
對應的filterBy()與findBy()類似,也可以在自定義的函數(shù)中實現(xiàn)各種復雜判斷,如下面的代碼所示。
store.filterBy(function(record) {
return record.get('name') == 'girl' && record.get('sex') == 1;
});
如果想取消過濾并顯示所有數(shù)據(jù),那么可以調(diào)用clearFilter()函數(shù),如下面的代碼所示。
store.clearFilter();
如果想知道store上是否設置了過濾器,可以通過isFiltered()函數(shù)進行判斷。
四、Ext.data.Store其他功能
除了上面提到的數(shù)據(jù)獲取、排序、更新、顯示等功能外,store還提供了其他一些功能函數(shù)。
collect( String dataIndex, [Boolean allowNull], [Boolean bypassFilter] ) : Array
collect函數(shù)獲得
指定的dataIndex對應的那一列的數(shù)據(jù),當allowNull參數(shù)為true時,返回的結(jié)果中可能會包含null、undefined或空字符串,
否則collect函數(shù)會自動將這些空數(shù)據(jù)過濾掉。當bypassFilter參數(shù)為true時,collect的結(jié)果不會受查詢條件的影響,無論查詢條
件是什么都會忽略掉,返回的信息是所有的數(shù)據(jù),如下面的代碼所示。
alert(store.collect('name'));
這樣會獲得所有name列的值,示例中返回的是包含了'boy'和'girl'的數(shù)組。
getTotalCount()用于在翻頁時獲得后臺傳遞過來的數(shù)據(jù)總數(shù)。如果沒有設置翻頁,get- TotalCount()的結(jié)果與getCount()相同,都是返回當前的數(shù)據(jù)總數(shù),如下面的代碼所示。
alert(store.getTotalCount());
indexOf(Ext.data.Record record)和indexOfId(String id)函數(shù)根據(jù)record或record的id獲得record對應的行號,如下面的代碼所示。
alert(store.indexOf(store.getAt(1)));
alert(store.indexOfId(1001));
loadData(object data, [Boolean append])從本地JavaScript變量中讀取數(shù)據(jù),append為true時,將讀取的數(shù)據(jù)附加到原數(shù)據(jù)后,否則執(zhí)行整體更新,如下面的代碼所示。
store.loadData(data, true);
Sum(String property, Number start, Number end):Number用于計算某一個列從start到end的總和,如下面的代碼所示。
alert(store.sum('sex'));