Ext 3.0新增内容系列文章之二：Ext.data.Writer简介

上期我们的内容是关于API接口的配置，其中涉及到CRUD只是略略一提，没有谈论太多，今期再重点说说。

根据CRUD 的原则，数据或资源操作不外乎“生、变、见、灭”的四大规律，也就是说，只需要“创建（Create ）、获取（Read ）、更新 （Update ）和销毁（DELETE ）”四种行为便可完成对资源的处理和操作了。如果“读”操作在Ext 中没有题的话，那么其他三种操作就应该归类为“写”的操作了。这部分的内容，在Ext 3.0 中将由Writer 来负责完成。Ext.data.DataWriter提供了增、删、改，而“查”的实现让Ext.data.Store与服务端框架密切通讯。Writer控制了Store了自动管理AJAX的请求，让其成为Store CRUD操作的管道。换句话说，这个DataWriter相对于远程CRUD操作而言，是一个在前端的初始化部分，负责写入单个或多个的 Ext.data.Record对象。Ext.data.DataWriter是一个抽象类，一般用于让来被继承，例如 Ext.data.JsonWriter。我们大致看看JsonWriter是怎么完成的。

Writer继承自Object，是一个崭新的Ext.data.*类，先引入一个JsonWriter 实例对象：

var settingsWriter = new Ext.data.JsonWriter({ writeAllFields: true });

设置writeAllFields 为true 表示，记录所有的字段都会写入到数据库中去。当然，如果有特定ORM 方面，可能就要设置其为false 以适应ORM 的策略。writeAllFields默认是false。设为true的话，就表示让DataWriter返回所有那个记录的所有字段，不仅仅是修改的那些字段。true就是记录那些修改的字段而已。

明显，Writer类的关键方法是write(action, params, rs)方法。action参数代表[CREATE|UPDATE|DESTROY]的字符串，Writer类只需要有DataWriter.update、DataWriter.create、DataWriter.destroy的proxy就可以囊括“写”的操作；params是要写入的hash参数；rs是要写的数据对象（可以为list的数据对象）。Ext.data.DataWriter本身有几个模版方法render()、updateRecord()、createRecord()、destroyRecord()，让继承它的子类重写使用。render()表示写事件的最后动作。将写入的数据对象添加到参数，该方法也说明了送抵的数据对象会依据用户在DataReader配置的元数据信息产生真正的渲染数据，有参数“data”和“params”。

值得一提的是，JsonWriter配置项 true 表示对.DataWriter.toHash()哈希数据进行Ext.util.JSON.encode()。 默认为true 。当使用Ext.data.DirectProxy的时候，不同于Ext.Direct.JsonProvider有自己的JSON编码，所以该配置项要设置为false 。 此外，如果你使用的是Ext.data.HttpProxy，设置该项为false 就会使得HttpProxy采用 Ext.Ajaxrequest配置参数的jsonData传输数据，而非params。 当使用Ext.data.Storerestful的Store，一些服务端框架就会认为数据从jsonData的通道经过。如果采用这样的机制的话，应该让底层的连接对象完成编码的工作（如Ext.Ajax），把encode: 设为false 。

通过proxy对象激活Store对象来控制writer，也就是配置一个url：

var proxy = new Ext.data.HttpProxy({ url: 'app.php/users' });

对于更细颗粒的控制，proxy也可配置成为api，也就是定义CRUD 的资源位置，并告诉Proxy 让Writer 得知操作地点的URL 。我们的指导思想倾向于与REST 架构的。

var settingsProxy = new Ext.data.HttpProxy({ api: { read: 'app.php/settings/view', create : 'app.php/settings/create', update: 'app.php/settings/update', destroy : 'app.php/settings/destroy' } });

然后就是Writer 、Proxy 组装一起：

var settingsStore = new Ext.data.Store({ id: 'setting', proxy: settingsProxy, reader: settingsReader, writer: settingsWriter, ... });

当上层的组件通过Ext.Writer 来提交某些数据的时候，较理想的方法是统一一个地方来进行数据字段验证的工作。假设有一个名为SettiongGrid ，我们可以这样关联事件(relay events) ，请注意relayEvents()方法的使用：

initComponent : function() { this.viewConfig = { forceFit: true }; this.relayEvents(this.store, ['destroy', 'save', 'update']); this.tbar = this.buildTopToolBar(); SettingsGrid.superclass.initComponent.call(this); }, … …

 

例子方面，Ext 发行包本身就有，我们可以去examples/resetful 和examples/writer 下面看看，简单演示了Rest 资源与MVC 框架是怎么映射其中的资源路径和操作行为的。如果谈到PHP 的框架，这就是一个特定的场合，基本上可以有以下几个类：

 

• Model         包含ORM 服务的对象
• Request      处理请求的参数
• Controller   根据已知url 派遣动作
• Response    输出符合格式的视图，如JSON

 

通过唯一的切入口来操作整个框架（博主听上去感觉有点好奇），而框架内部的类都是由Controller 来动态加载的，通过某一动作指明不同的类。不过url 就依据URL 映射的使用，表现得千变万化，而切入点就只有一个。

 

部分内容根据jacob.andresen@gmail.com的“CRUD_in_extjs_3_0.pdf”的来源而翻译。