2008年12月29日

Ext.data-DataReader/ArrayReader/JsonReader/XmlRead

Ext.data.DataReader

純虛類,從數據源得到結構化數據轉換為元數據對象,對象包含Record的集合,一般用做Store對象的元數據,
具有如下格式
{
totalRecord:int,
records:Array of Ext.data.Record
}
具體使用參見三個子類
Ext.data.ArrayReader/Ext.data.JsonReader/Ext.data.XmlReader


方法
DataReader( Object meta, Object recordType )
構造

Ext.data.ArrayReader
用於讀數組到一個元數據對象

ArrayReader( Object meta, Object recordType )
構造,第一個參數是配置除了可以指示使用哪個字段做id外,不懂其它的用法,
第二個參數是recordType與record對象的create方法的參數一樣,是一樣config對象數組,具體參見
readRecords( Object o ) : Object
讀取o,返回一個元數據對象

用例示範:
//定義數組
var arr=[ [1, 'Bill', 'Gardener'], [2, 'Ben', 'Horticulturalist'] ];
var reader = new Ext.data.ArrayReader(
//以第一個元素做為recordid
{id: 0},
//定義數組到record的映射關係
[
{name: 'name', mapping: 1},
{name: 'occupation', mapping: 2}
]
);
//生成元數據
var data=reader.readRecords(arr);

Ext.data.JsonReader
用於將一個json對象轉換為元數據對象

JsonReader( Object meta, Object recordType )
JsonReader的構造參數meta可以有更多選擇,
{
id : String,
root : String,
successProperty : String,
totalProperty : String
}
都是對應json對象的屬性名

read( Object response ) : Object
從一個response對象返回,response.responseText屬性應僅含有一個json格式數據塊

readRecords( Object o ) : Object
讀取o,返回一個元數據對象

使用示例:
var json={ 'results': 2, 'rows': [
{ 'id': 1, 'name': 'Bill', occupation: 'Gardener' },
{ 'id': 2, 'name': 'Ben', occupation: 'Horticulturalist' } ]
};
var reader=new Ext.data.JsonReader(
{
totalProperty: "results",//totalRecords屬性由json.results得到
root: "rows", //構造元數據的數組由json.rows得到
id: "id" //id由json.id得到
},[
{name: 'name', mapping: 'name'},
{name: 'occupation'} //如果name與mapping同名,可以省略mapping
]
)
var data=reader.readRecords(json);



Ext.data.XmlReader
xmlreader對象當然是為xml而準備的

構造:
XmlReader( Object meta, Mixed recordType )
meta與jsonreader類似,
meta是一個{
id : String,
record : String,
success : String,
totalRecords : String
}對象,只是這些字符串都是相對於文檔根目錄的domquery路徑
read( Object response ) : Object
readRecords( Object doc ) : Object
....


var str=["",
"",
"2",
"",
"1",
"Bill",
"Gardener",
"
",
"",
"2",
"Ben",
"Horticulturalist",
"
",
"
"].join("");

//生成xmldocument對象
var xmlDocument;
if(Ext.isIE){
xmlDocument = new ActiveXObject("Msxml2.FreeThreadedDOMDocument")
xmlDocument.async=false;
xmlDocument.resolveExternals = false;
xmlDocument.loadXML(str)
}
else{
xmlDocument = (new DOMParser()).parseFromString(str, "text/xml");
}

//然後開始...和其它兩個reader一樣的用法,只是這兒換了一種寫法,recordtype也可以是一個record對象
var record = Ext.data.Record.create([
{name: 'name', mapping: 'name'}, // "mapping" property not needed if it's the same as "name"
{name: 'occupation'} // This field will use "occupation" as the mapping.
])
var reader = new Ext.data.XmlReader({
totalRecords: "results",
record: "row", //row是節點選擇器
id: "id"
}, record);
var data=reader.readRecords(xmlDocument);