[轉(zhuǎn)載]Ext.data-Store 收藏
Ext.data.Store
store是一個為Ext器件提供record對象的存儲容器,行為和屬性都很象數(shù)據(jù)表

方法:不列舉繼承來的方法
Store( Object config )
構(gòu)造,config定義為{
 autoLoad : Boolean/Object,    //自動載入
 baseParams : Object,    //只有使用httpproxy時才有意義
 data : Array,        //數(shù)據(jù)
 proxy : Ext.data.DataProxy,//數(shù)據(jù)代理
 pruneModifiedRecords : boolean,//清除修改信息
 reader : Ext.data.Reader,    //數(shù)據(jù)讀取器
 remoteSort : boolean,    //遠程排序?
 sortInfo : Object,    //{field: "fieldName", direction: "ASC|DESC"}這樣的排序?qū)ο?br />  url : String,        //利用url構(gòu)造HttpProxy
}

add( Ext.data.Record[] records ) : void
增加記錄records 到store

addSorted( Ext.data.Record record ) : void
增加record到store并排序(僅本地排序時有用)

clearFilter( Boolean suppressEvent ) : void
清除過濾器

collect( String dataIndex, [Boolean allowNull], [Boolean bypassFilter] ) : Array
收集由dataIndex指定字段的惟一值

commitChanges() : void
提交Store所有的變更,會引發(fā)Update事件


filter( String field, String/RegExp value, [Boolean anyMatch], [Boolean caseSensitive] ) : void
設(shè)定過濾器
field:String    //字段名
value:String    //RegExp 如果是字符器,檢查field是否以value開始,如果是正則,檢查是否匹配
anyMatch:Boolean //匹配任何部分而不僅令是開始
caseSensitive:Boolean //大小寫敏感?

filterBy( Function fn, [Object scope] ) : void
更強悍的過濾方法.fn接收兩個參數(shù)record和id

find( String property, String/RegExp value, [Number startIndex], [Boolean anyMatch], [Boolean caseSensitive] ) : Number
找到符合條件的第一條記錄,參數(shù)同filter

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

getAt( Number index ) : Ext.data.Record
getById( String id ) : Ext.data.Record
依充號/id得到record對象

getCount() : void
得到記錄數(shù)

getModifiedRecords() : Ext.data.Record[]
得到修改過的記錄集

getRange( [Number startIndex], [Number endIndex] ) : Ext.data.Record[]
得到指定范圍的記錄集合

getSortState() : void
得到排序狀態(tài):顯然不是void而是返回一個排序?qū)ο?同sortInfo一樣的結(jié)構(gòu){field: "fieldName", direction: "ASC|DESC"}

getTotalCount() : void
這個對于翻頁信息還是很有用的

indexOf( Ext.data.Record record ) : Number
indexOfId( String id ) : Number
由記錄或id得到序號

insert( Number index, Ext.data.Record[] records ) : void
在指定的位置插入記錄,并引發(fā)add事件

isFiltered() : Boolean
當前設(shè)置了過濾器則返回真

load( Object options ) : void
由指定的Proxy使用指定的reader讀取遠程數(shù)據(jù)
options定義為
{
    params :Object,    //請求url需要附加的參數(shù)
    callback :Function//回叫方法,接收三個參數(shù)
      //r : Ext.data.Record[] //返回的record數(shù)組
      //options: Options load方法傳入的options
      //success: Boolean //成功
    scope :Object, //范圍.默認是store本身
    add :Boolean 追加還是更新
}


loadData( Object data, [Boolean append] ) : void
用法比load簡單一點,目的是一樣的,只是這次數(shù)據(jù)由本地讀取

query( String field, String/RegExp value, [Boolean anyMatch], [Boolean caseSensitive] ) : MixedCollection
queryBy( Function fn, [Object scope] ) : MixedCollection
查詢,參數(shù)和find類似,但返回所有符合條件的record,而不是第一個符合條件記錄的序號

rejectChanges() : void
放棄所有的變更

reload( [Object options] ) : void
重新載入,相當于 load(options,false),如果連options都沒有傳入,則取最后一次load時使用的參數(shù)

remove( Ext.data.Record record ) : void
移除指定記錄

removeAll() : void
移除所有記錄

setDefaultSort( String fieldName, [String dir] ) : void
設(shè)置默認排序規(guī)則

sort( String fieldName, [String dir] ) : void
排序

sum( String property, Number start, Number end ) : Number
對property字段由start開始到end求和

事件列表
add : ( Store this, Ext.data.Record[] records, Number index )
beforeload : ( Store this, Object options )
clear : ( Store this )
datachanged : ( Store this )
load : ( Store this, Ext.data.Record[] records, Object options )
loadexception : ()
metachange : ( Store this, Object meta )
remove : ( Store this, Ext.data.Record record, Number index )
update : ( Store this, Ext.data.Record record, String operation )
看名字都很簡單,參數(shù)也不復(fù)雜,略過


用例
//得到遠程json對象
//其中jsoncallback.js內(nèi)容為
//{ 'results': 2, 'rows': [
//    { 'id': 1, 'name': 'Bill', occupation: 'Gardener' },
//    { 'id': 2, 'name': 'Ben', occupation: 'Horticulturalist' } ]
//}
//定義proxy
      var proxy=new Ext.data.HttpProxy({url:'jsoncallback.js'});
//定義reader
      var reader=new Ext.data.JsonReader(
        {
        totalProperty: "results",//totalRecords屬性由json.results得到
        root: "rows",            //構(gòu)造元數(shù)據(jù)的數(shù)組由json.rows得到
        id: "id"                //id由json.id得到
        },[
        {name: 'name', mapping: 'name'},
        {name: 'occupation'}            //如果name與mapping同名,可以省略mapping
        ]
    )
//構(gòu)建Store   
    var store=new Ext.data.Store({
      proxy:proxy,
      reader:reader
   });
//載入
store.load();


示例2
//得到遠程xml文件
//其中xml文件內(nèi)容為
<?xml version="1.0" encoding="utf-8" ?>
<dataset>
  <results>2</results>
  <row>
    <id>1</id>
    <name>Bill</name>
    <occupation>Gardener</occupation>
  </row>
  <row>
    <id>2</id>
    <name>Ben</name>
    <occupation>Horticulturalist</occupation>
  </row>
</dataset>


var proxy=new Ext.data.HttpProxy({url:'datasource.xml'});
   
    var reader = new Ext.data.XmlReader({
       totalRecords: "results",
       record: "row",        
       id: "id"                
    }, [
       {name: 'name', mapping: 'name'},
       {name: 'occupation'}           
    ]);
   var store=new Ext.data.Store({
      proxy:proxy,
      reader:reader
   });
store.load();


示例3
//從本地數(shù)組得到
 var arr=[ [1, 'Bill', 'Gardener'], [2, 'Ben', 'Horticulturalist'] ];
var reader = new Ext.data.ArrayReader(
   {id: 0},
   [
    {name: 'name', mapping: 1},        
    {name: 'occupation', mapping: 2}   
    ]);
   
    var store=new Ext.data.Store({
      reader:reader
   });
   store.loadData(arr);