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=["<?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>"].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);