因為上次用過Ext.data.Store，覺得挺重要的，  故轉載了一篇http://blog.csdn.net/davidxj/archive/2009/04/23/4103647.aspx

Ext.data.Store的基本用法

在使用之前，首先要建立一個Ext.data.Store的例項，如下面的程式碼所示。

1. var data = [   
2.     ['boy', 0],   
3.     ['girl', 1]   
4. ];   
5. var store = new Ext.data.Store({   
6.     proxy: new Ext.data.MemoryProxy(data),   
7.     reader: 
   new Ext.data.ArrayReader({}, PersonRecord)   
8. });   
9. store.load();  

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用於從某個途徑讀取原始資料，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. });  

var store = new Ext.data.Store({ proxy: new Ext.data.MemoryProxy(data), reader: new Ext.data.ArrayReader({}, PersonRecord), sortInfo: {field: 'name', direction: 'DESC'} });

這樣，在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')  

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. }  

for (var i = 0; i < store.getCount(); i++) { var record = store.getAt(i); alert(record.get('name')); }

Store.getCount()返回的是store中的所有資料記錄，然後使用for迴圈遍歷整個store，從而得到每條記錄。

除了使用getCount()的方法外，還可以使用each()函式，如下面的程式碼所示。

1. store.each(function(record) {   
2.     alert(record.get('name'));   
3. });  

store.each(function(record) { alert(record.get('name')); });

Each()可以接受一個函式作為引數，遍歷內部record，並將每個record作為引數傳遞給function()處理。

如果希望停止遍歷，可以讓function()返回false。

也可以使用getRange()函式連續獲得多個record，只需要指定開始和結束位置的索引值，如下面的程式碼所示。

1. var records = store.getRange(0, 1);   
2. for (var i = 0; i < records.length; i++) {   
3. var record = records[i];   
4.     alert(record.get('name'));   
5. }  

var records = store.getRange(0, 1); for (var i = 0; i < records.length; i++) { var record = records[i]; alert(record.get('name')); }


如果確實不知道record的id，也可以根據record本身的id從store中獲得對應的record，如下面的程式碼所示。

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

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


EXT還提供了函式find()和findBy()，可以利用它們對store中的資料進行搜尋，如下面的程式碼所示。

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

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. alert(store.getAt(index).get('name'));  

var index = store.find('name','g'); alert(store.getAt(index).get('name'));


與find()函式對應的findBy()函式的定義格式如下：

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

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. alert(store.getAt(index).get('name'));  

index = store.findBy(function(record, id) { return record.get('name') == 'girl' && record.get('sex') == 1; }); alert(store.getAt(index).get('name'));


通過findBy()函式，我們可以同時判斷record中的多個欄位，在函式中實現複雜邏輯。

我們還可以使用query和queryBy函式對store中的資料進行查詢。

與find和findBy不同的是，query和queryBy返回的是一個MixCollection物件，裡面包含了搜尋得到的資料，如下面的程式碼所示。

1. alert(store.query('name', 'boy'));   
2. alert(store.queryBy(function(record) {   
3. return record.get('name') == 'girl' && record.get('sex') == 1;   
4. }));  

alert(store.query('name', 'boy')); alert(store.queryBy(function(record) { return record.get('name') == 'girl' && record.get('sex') == 1; }));


Ext.data.Store更新store中的資料

可以使用add(Ext.data.Record[] records)向store末尾新增一個或多個record，使用的引數可以是一個record例項，如下面的程式碼所示。

1. store.add(new PersonRecord({   
2.     name: 'other',   
3.     sex: 0   
4. }));  

store.add(new PersonRecord({ name: 'other', sex: 0 }));

Add()的也可以新增一個record陣列，如下面的程式碼所示：

1. store.add([new PersonRecord({   
2.     name: 'other1',   
3.     sex: 0   
4. }), new PersonRecord({   
5.     name: 'other2',   
6.     sex: 0   
7. })]);  

store.add([new PersonRecord({ name: 'other1', sex: 0 }), new PersonRecord({ name: 'other2', sex: 0 })]);


Add()函式每次都會將新資料新增到store的末尾，這就有可能破壞store原有的排序方式。如果希望根據store原來的排序方式將新資料插入到對應的位置，可以使用addSorted()函式。它會在新增新資料之後立即對store進行排序，這樣就可以保證store中的資料有序地顯示，如下面的程式碼所示。

1. store.addSorted(new PersonRecord({   
2.     name: 'lili',   
3.     sex: 1   
4. }));  

store.addSorted(new PersonRecord({ name: 'lili', sex: 1 }));

store會根據排序資訊查詢這條record應該插入的索引位置，然後根據得到的索引位置插入資料，從而實現對整體進行排序。這個函式需要預先為store設定本地排序，否則會不起作用。

如果希望自己指定資料插入的索引位置，可以使用insert()函式。它的第一個引數表示插入資料的索引位置，可以使用record例項或record例項的陣列作為引數，插入之後，後面的資料自動後移，如下面的程式碼所示。

1. store.insert(3, new PersonRecord({   
2.     name: 'other',   
3.     sex: 0   
4. }));   
5. store.insert(3, [new PersonRecord({   
6.     name: 'other1',   
7.     sex: 0   
8. }), new PersonRecord({   
9.     name: 'other2',   
10.     sex: 0   
11. })]);  

store.insert(3, new PersonRecord({ name: 'other', sex: 0 })); store.insert(3, [new PersonRecord({ name: 'other1', sex: 0 }), new PersonRecord({ name: 'other2', sex: 0 })]);


刪除操作可以使用remove()和removeAll()函式，它們分別可以刪除指定的record和清空整個store中的資料，如下面的程式碼所示。

1. store.remove(store.getAt(0));   
2. store.removeAll();  

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


store中沒有專門提供修改某一行record的操作，我們需要先從store中獲取一個record。對這個record內部資料的修改會直接反映到store上，如下面的程式碼所示。

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

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. });  

store.load({ params: {start:0,limit:20}, callback: function(records, options, success){ Ext.Msg.alert('info', '載入完畢'); }, scope: store, add: true });

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;  

store.baseParams.start = 0; store.baseParams.limit = 20;

為store載入資料之後，有時不需要把所有資料都顯示出來，這時可以使用函式filter和filterBy對store中的資料進行過濾，只顯示符合條件的部分，如下面的程式碼所示。

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

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


filter()函式的用法與之前談到的find()相似，如下面的程式碼所示。

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

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

對應的filterBy()與findBy()類似，也可以在自定義的函式中實現各種複雜判斷，如下面的程式碼所示。

1. store.filterBy(function(record) {   
2. return record.get('name') == 'girl' && record.get('sex') == 1;   
3. });  

store.filterBy(function(record) { return record.get('name') == 'girl' && record.get('sex') == 1; });


如果想取消過濾並顯示所有資料，那麼可以呼叫clearFilter()函式，如下面的程式碼所示。

1. store.clearFilter();  

store.clearFilter();


如果想知道store上是否設定了過濾器，可以通過isFiltered()函式進行判斷。


Ext.data.Store其他功能

除了上面提到的資料獲取、排序、更新、顯示等功能外，store還提供了其他一些功能函式。

1. collect( String dataIndex, [Boolean allowNull], [Boolean bypassFilter] ) : Array  

collect( String dataIndex, [Boolean allowNull], [Boolean bypassFilter] ) : Array


collect函式獲得指定的dataIndex對應的那一列的資料，當allowNull引數為 true時，返回的結果中可能會包含null、undefined或空字串，否則collect函式會自動將這些空資料過濾掉。當 bypassFilter引數為true時，collect的結果不會受查詢條件的影響，無論查詢條件是什麼都會忽略掉，返回的資訊是所有的資料，如下面的程式碼所示。

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

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

這樣會獲得所有name列的值，示例中返回的是包含了'boy'和'girl'的陣列。

getTotalCount()用於在翻頁時獲得後臺傳遞過來的資料總數。如果沒有設定翻頁，get- TotalCount()的結果與getCount()相同，都是返回當前的資料總數，如下面的程式碼所示。

1. alert(store.getTotalCount());  

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));  

alert(store.indexOf(store.getAt(1))); alert(store.indexOfId(1001));


loadData(object data, [Boolean append])從本地JavaScript變數中讀取資料，append為true時，將讀取的資料附加到原資料後，否則執行整體更新，如下面的程式碼所示。

1. store.loadData(data, true);  

store.loadData(data, true);

Sum(String property, Number start, Number end):Number用於計算某一個列從start到end的總和，如下面的程式碼所示。

1. alert(store.sum('sex'));  

alert(store.sum('sex'));


如果省略引數start和end，就計算全部資料的總和。

store還提供了一系列事件（見下表），讓我們可以為對應操作設定操作函式。