在使用使用FormPanel时我们通常需要使用它的form对象来加载数据或提交数据。FormPanel中的 form对象为Ext.form.BasicForm类型的对象,它有load和submit方法分别用于加载数据和提交数据。而这两个方法都是通过调用 Ext.form.BasicForm中的doAction方法来操作的。doAction方法带有两个参数,其中第二个参数为从load或submit 方法传递过来的Ext.form.Action对象的配置数据(Config Options)。其中的success和failure属性是用于处理请求成功或失败的函数。但需要注意的是,文档中的说明是这个success或 failure取决于Http请求过程是否出错。实际情况却并非这样,我在开发过程中发现HTTP响应代码一直都是200,但被调用的函数却一直都是 failure属性对应的函数。通过查看Action.js可以发现响应过来的数据是需要符合一定格式的,Ext.form.Action.Load的 API文档开头就说明了响应数据包必须类似下面的格式:
{ success: true, data: { clientName: "Fred. Olsen Lines", portOfLoading: "FXT", portOfDischarge: "OSL" } }
这个说明在我使用ExtJS的时候再次误导了我。我认为只需要响应的数据为类似的格式就可以了。结果仍然出错,查看Action.js中的 handleResponse方法可以看出,返回的数据为上面代码的格式,但并不是说从服务端发送过来的数据就是这样的格式,而是需要将 Ext.form.Action.Load的result属性设置成上面的格式的数据。从handleResponse也可以看出,Action.js使用了form.reader属性来处理服务端数据。这个属性也可以在初始化FormPanel的时候传递给FormPanel,FormPanel将会把这个属性传递给它内置的BasicForm对象。怎样使用JsonReader来使提取响应数据来使它满足PanelForm的要求呢?再看 handleResponse中的代码,在reader存在的情况下,它返回的是所需要的格式的数据,一个包含success属性和data属性的对象,而data属性来自于JsonReader的read方法处理后的结果。再查看JsonReader.js中的read方法,它调用的是 readRecords来读取数据,而返回的值是由reader的root属性决定的,从JsonReader.js中还可以看出,root属性对应的 JSON对象必须是集合类型的,因此我们在后台发送过来的数据必须也是集合类型,我在这里也出了错。一直认为加载数据到Form里,一次只加载一条,所以从服务端传递过来的数据都是单个的对象,而将JsonReader对象的root设置为单个对象的名称,结果Form中一直都加载不上数据。后来将服务端传递过来的数据修改为集合数型问题解决了。
小结:
- ExtJS中JsonReader对于数据的处理总是一致的,不管你需要的是单条记录还是多条记录,它总是通过total属性判断记录数,通过root属性对应的名称来取记录集合。
- FormPanel中处理数据的为内置的BasicForm类型的对象,它通过load和submit方法来加载或提交数据。而这两个方法是通过 Ext.form.Action的两个子类Ext.form.Action.Load、Ext.form.Action.Submit来提交请求和调用用户的success和failure方法。决定调用success和failure的并非Http请求是否出错,而是决定于Action.js中 handleResponse的处理结果。我们可以通过设置FormPanel的reader配置对象来干预handleResponse对数据的处理。而这个reader也可设置响应数据与FormPanel中字段的对应关系。
- 多看源码,可以获取更多。
附:
表格中双击进行编辑的JS源码,这个代码比官方文档中的处理方式简单一些,觉得官方文档中的edit中加载数据的处理是一种hack的方式,并不太适合实际应用。
ExtJS网站上的CRUD的文章,其中包含有加载数据进行编辑的例子
Ext.onReady(function(){ var newFormWin; var form1; //表格处理 //Ext.BLANK_IMAGE_URL = 'extjs/resources/images/default/s.gif'; Ext.QuickTips.init(); var sm = new Ext.grid.CheckboxSelectionModel(); //CheckBox选择列 var cm = new Ext.grid.ColumnModel([ new Ext.grid.RowNumberer(), //行号列 sm, {header:'编号',dataIndex:'id'}, {header:'性别',dataIndex:'sex',renderer:function(value){ if(value=='1'){ return "男"; }else{ return "女"; } }}, //增加性别,自定义renderer,即显示的样式,可以加html代码,来显示图片等。 {header:'名称',dataIndex:'name'}, {header:'描述',dataIndex:'memo'} ]); var ds = new Ext.data.Store({ proxy: new Ext.data.HttpProxy({url:ACTION_URL}),//调用的动作 reader: new Ext.data.JsonReader({ totalProperty: 'total', root: 'list', successProperty :'success' }, [{name: 'id',mapping:'id',type:'string'}, {name: 'sex',mapping:'sex',type:'string'}, {name: 'name',mapping:'name',type:'string'}, {name: 'memo',mapping:'memo',type:'string'} //列的映射 ]) }); var grid = new Ext.grid.GridPanel({ id: 'grid', el: 'center', region:'center', title:'用户', ds: ds, sm: sm, cm: cm, bbar: new Ext.PagingToolbar({ pageSize: 10, store: ds, displayInfo: true, displayMsg: '显示第 {0} 条到 {1} 条记录,一共 {2} 条', emptyMsg: "没有记录" }) //页脚显示分页 }); //布局处理 Ext.state.Manager.setProvider(new Ext.state.CookieProvider()); new Ext.Viewport({ layout:'border', items:[ { xtype:'box', region:'north', el: 'north', height:32, title:'north' },{ region:'south', contentEl: 'south', split:true, height: 100, minSize: 100, maxSize: 200, collapsible: true, title:'South', margins:'0 0 0 0' }, grid ] }); //el:指定html元素用于显示grid grid.render();//Ext.getCmp('grid').render();//渲染表格 ds.load({params:{start:0, limit:10}}); //加载数据 grid.on("rowdblclick", function(grid) { loadFormData(grid); //alert(form1.reader); }); // 载入被选择的数据行的表单数据 var loadFormData = function(grid) { var _record = grid.getSelectionModel().getSelected(); if (!_record) { Ext.example.msg('修改操作', '请选择要修改的一项!'); } else { myFormWin(); form1.form.load( { url : EDIT_ACTION_URL+'?sid='+ _record.get('id'), waitMsg : '正在载入数据...', success : function(form,action) { Ext.example.msg('编辑', '载入成功!'); }, failure : function(form,action) { Ext.example.msg('编辑', '载入失败'); } }); } }; var myFormWin = function() { // create the window on the first click and reuse on subsequent // clicks if (!newFormWin) { newFormWin = new Ext.Window( { el : 'topic-win', layout : 'fit', width : 400, height : 300, closeAction : 'hide', plain : true, title : '窗口', items : form1 }); } newFormWin.show('New1'); }; form1 = new Ext.FormPanel( { // collapsible : true,// 是否可以展开 labelWidth : 75, // label settings here cascade unless overridden url : 'AddLevel.action', frame : true, title : '修改', bodyStyle : 'padding:5px 5px 0', width : 350, waitMsgTarget : true, //这个属性决定了load和submit中对数据的处理,list必须是一个集合类型,json格式应该是[]包含的一个数组 reader: new Ext.data.JsonReader({root:'list'}, [{name: 'id',mapping:'id',type:'string'}, {name: 'sex',mapping:'sex',type:'string'}, {name: 'memo',mapping:'memo',type:'string'} ]), defaults : { width : 230 }, defaultType : 'textfield', items : [ { fieldLabel : '编号', name : 'id', allowBlank : false }, { fieldLabel : '性别', name : 'sex', allowBlank : false }, new Ext.form.TextArea( { fieldLabel : '备注', name : 'memo', growMin : 234 })], buttons : [ { text : '保存', disabled : false, handler : function() { if (form1.form.isValid()) { form1.form.submit( { url : 'AddLevel.action', success : function(from, action) { Ext.example.msg('保存成功', '添加级别成功!'); ds.load( { params : { start : 0, limit : 30, forumId : 4 } }); }, failure : function(form, action) { Ext.example.msg('保存失败', '添加级别失败!'); }, waitMsg : '正在保存数据,稍后...' }); dialog.hide(); } else { Ext.Msg.alert('信息', '请填写完成再提交!'); } } }, { text : '取消', handler : function() { newFormWin.hide(); } }] }); });
<script type="text/javascript"></script>