Ext.data.reader.Json
JSON Reader是用一个代理来读取服务端响应的JSON格式的返回值. 一般用于将结果加载成一个存储集-例如我们将创建一些如下东西:
extend fields}); model proxy type url reader type以上示例创建了一个“User”模型.
我们创建了尽可能最简单类型的JSON Reader对象, 简洁的告知了Store中的Proxy我们需要返回一个JSON Reader. Store将自动存储模型的配置,这样我们就可以通过以下方式来替代了:
type model}我们设置的reader属性已准备好从服务端读取数据了- 同时它将接受一个如下响应:
读取其他JSON格式
如果你已经有了一份JSON格式的定义,且其看起来不是十分像以上我们提供的那些, 你仍然可以通过JsonReader的夫妻配置选项来使其可以解析你的格式. 例如,我们可以使用root配置来解析返回的如下数据:
为了解析这个,我们只要传递一个root配置匹配以上的“users”:
type root}有时候JSON的结构异常复杂. 像CouchDB的文档数据库经常围绕这样一个嵌套的结构内每个记录提供元数据:
以上示例中的记录数据是在"users"数组中嵌套的一个额外级别,其中的每个“user”项目中都包含有额外元数据(例如本例中的’id‘和‘value’). 为了解析以上json数据中的每个‘user’项中的数据, 需要特别指定record配置,如下所示:
type root record}响应的元数据
服务端可以在其响应中返回元数据,除了记录数据,其中数据本身的描述数据的属性集或用于重新配置的读取器。 为了在响应中获取元数据,需要给响应数据的根简明加上一个‘metaData’属性. 元数据属性可以包含任何东西, 但若Reader存在,其还支持的一个特定设置属性。:
root: 响应中包含记录数据的节点对应的根属性名称idProperty: 数据中的主键字段属性名totalProperty: 数据中的所有记录数属性名successProperty: 响应中成功状态属性名messageProperty: 一个可选的响应信息的属性名fields: 在将响应数据转换成records之前用于重新配置Model的字段集的配置一份Reader初始化的配置包含大概如下的这些属性 ("fields" 一般包含在Model的定义中,故这边不显示):
type root idProperty totalProperty successProperty messageProperty}若要得到一个响应对象包含一个不同于以上初始化中定义的属性,需要使用‘metaData’属性动态重配置Reader。 例如:
你可以放置任何的你需要的任意数据在‘metaData’属性中,Reader将忽略这些属性, 但可以通过Reader的metaData属性(该属性也是通过监听Proxy'smetachange事件)。 (当然也可以由store替代)。 然后,应用程序代码就可以选择任何的方式来处理获取到的元数据了。
如何使用这些来给Model定做合适的字段集的一个简单例子就是表格(grid)了。 通过传递‘fields’属性,Reader内部会自动更新Model,但这些变化不会自动反应在grid内部,除非你已更新了列配置项. 你可以手动执行这些,或者通过一个标准的grid配置对象column作为‘metaData’属性, 然后就可以直接管理grid. 这有一个非常简单的例子说明如何实现这种情况:
Reader可以自动读取meta字段集的配置,并根据新的字段集重建Model, 但要处理新的列配置,需要在应用程序代码中处理元数据。 处理元数据时间可以很简单的通过store或proxy,例如:
... listeners myGrid Ext.data.reader.XmlXML Reader 用于代理读取服务端返回的XML格式的响应. 这一般发生在加载Store的结果上 - 例如如下我们创建一个类似的:
extend fields}); model proxy type url reader type record root以上例子创建了一个'User'模型. 若不熟悉模型,可参阅Model文档,有详细的解释说明
尽可能以简单的方式告知Store的{@linkExt.data.proxy.Proxy Proxy} 我们需要一个XML Reader来创建一个极简单的XML类型的Reader, Store将自动传递模型的参数给Store 所以我们可以如下方式传递参数代替:
type model record root}以上我们设置好的reader已准备好从服务端读取数据 - 在这时,reader会接收到一个如下响应:
首先root选项用于定义根节点<users>(一个完善的XML文档必须只有一个根). 然后XML Reader使用配置项record将数据拉成每个记录 - 在本例中,我们设置记录为‘user’, 所以以上的每个<user>都会转化成User模型中的对象.
注意:XmlReader不关心根节点root和record元素是否嵌套在一个更大的结构内, 所以如下的响应数据,仍然是可以有效工作的:
响应的元数据服务器可以在响应中返回额外的数据, 例如记录集数和响应成功状态. 它们一般是如下这般包含在XML的响应中: