Ext.js4.2.1 Ext.data.Record
Ext.data.Record就是一個設定了內部資料型別的物件,它是Ext.data.Store的最基本組成部分。如果把Ext.data.Store看作是一張二維表,那麼它的每一行就對應一個Ext.data.Record例項。
Ext.data.Record的主要功能是儲存資料,並且在內部資料發生改變時記錄修改的狀態,它還可以保留修改之前的原始值。
我們使用Ext.data.Record時通常都是由create()函式開始,首先用create()函式建立一個自定義的Record型別,如下面的程式碼所示:
- var PersonRecord = Ext.data.Record.create([
- {name: 'name', type: 'string'},
- {name: 'sex', type: 'int'}
- ]);
PersonRecord就是我們定義的新型別,包含字串型別的name和整數型別的sex兩個屬性,然後我們使用new關鍵字建立PersonRecord的例項,如下面的程式碼所示:
- var boy = new PersonRecord({
- name: 'boy',
- sex: 0
- });
建立物件時,可以直接透過構造方法為物件賦予初始值,將'boy'賦值給name,0賦值給sex。
現在,我們得到了PersonRecord的例項boy,如何才能得到它的屬性呢?以下三種方式都可以獲得boy中name屬性的資料,如下面的程式碼所示:
- alert(boy.data.name);
- alert(boy.data['name']);
- alert(boy.get('name'));
這裡涉及Ext.data.Record的data屬性,這是定義在Ext.data.Record中的一個公共屬性,用於儲存當前record物件的所有資料。它是一個JSON物件,可以直接從它裡面獲得需要的資料。可以透過Ext.data.Record的get()函式方便地從data屬性中獲得指定的屬性。
如果我們需要修改boy中的資料,請不要使用以下方式直接操作data,如下面的程式碼所示:
- boy.data.name = 'boy name';
- boy.data['name'] = 'boy name';
而應該使用set()函式,如下面的程式碼所示:
- boy.set('name', 'body name');
set()函式會判斷屬性值是否發生了改變,如果改變了,就要將當前物件的dirty屬性設定為true,並將修改之前的原始值放入
modified物件中,供其他函式使用。如果直接操作data中的值,record就無法記錄屬性資料的修改情況。
- Record的屬性資料被修改後,我們可以執行如下幾種操作。
- commit()(提交):這個函式的效果是設定dirty為false,並刪除modified中儲存的原始資料。
- reject()(撤銷):這個函式的效果是將data中已經修改了的屬性值都恢復成modified中儲存的原始資料,然後設定dirty為false,並刪除儲存原始資料的modified物件。
- getChanges()獲得修改的部分:這個函式會把data中經過修改的屬性和資料放在一個JSON物件裡並返回。例如上例中,getChanges()返回的結果是{name:’body name’}。
- 我們還可以呼叫isModified()判斷當前record中的資料是否被修改。
Ext.data.Record還提供了用於複製record例項的函式copy()。
- var copyBoy = boy.copy();
這樣我們就得到了boy的一個副本,它裡面包含了boy的data資料,但copy()函式不會複製dirty和modified等額外的屬性值。
來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/28624388/viewspace-2143769/,如需轉載,請註明出處,否則將追究法律責任。