Ext.js4.2.1 Ext.data.Record

百聯達發表於2017-08-18

Ext.data.Record就是一個設定了內部資料型別的物件,它是Ext.data.Store的最基本組成部分。如果把Ext.data.Store看作是一張二維表,那麼它的每一行就對應一個Ext.data.Record例項。

Ext.data.Record的主要功能是儲存資料,並且在內部資料發生改變時記錄修改的狀態,它還可以保留修改之前的原始值。

我們使用Ext.data.Record時通常都是由create()函式開始,首先用create()函式建立一個自定義的Record型別,如下面的程式碼所示:

  1. var PersonRecord Ext.data.Record.create([  
  2.     {name: 'name', type: 'string'},  
  3.   
  4.     {name: 'sex', type: 'int'}  
  5.   
  6. ]);  

PersonRecord就是我們定義的新型別,包含字串型別的name和整數型別的sex兩個屬性,然後我們使用new關鍵字建立PersonRecord的例項,如下面的程式碼所示:

  1. var boy new PersonRecord({  
  2.   
  3.     name: 'boy',  
  4.   
  5.     sex:  
  6.   
  7. });  

建立物件時,可以直接透過構造方法為物件賦予初始值,將'boy'賦值給name,0賦值給sex。

現在,我們得到了PersonRecord的例項boy,如何才能得到它的屬性呢?以下三種方式都可以獲得boy中name屬性的資料,如下面的程式碼所示:

  1. alert(boy.data.name);  
  2.   
  3. alert(boy.data['name']);  
  4.   
  5. alert(boy.get('name'));  

這裡涉及Ext.data.Record的data屬性,這是定義在Ext.data.Record中的一個公共屬性,用於儲存當前record物件的所有資料。它是一個JSON物件,可以直接從它裡面獲得需要的資料。可以透過Ext.data.Record的get()函式方便地從data屬性中獲得指定的屬性。

如果我們需要修改boy中的資料,請不要使用以下方式直接操作data,如下面的程式碼所示:

  1. boy.data.name 'boy name';  
  2.   
  3. boy.data['name'] 'boy name';  

而應該使用set()函式,如下面的程式碼所示:

  1. 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()。

 

  1. var copyBoy boy.copy();  

這樣我們就得到了boy的一個副本,它裡面包含了boy的data資料,但copy()函式不會複製dirty和modified等額外的屬性值。

來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/28624388/viewspace-2143769/,如需轉載,請註明出處,否則將追究法律責任。