DWR对象构造,深入分析dwr中的DWRUtil.getValues
当你需要通过dwr完成类似提交form的操作,了解DWRUtil.getValues是必须的
/**
* Given a map, call getValue() for all the entries in the map using the entry key as an element id.
* Given a string or element that refers to a form, create an object from the elements of the form.
* @see http://getahead.ltd.uk/dwr/browser/util/getvalues
*/
DWRUtil.getValues = function(data) {
//定义ele变量,
var ele;
//如果ele是一个字符串通过 $函数转化一下,$函数的使用见我的上个帖子 深入分析dwr中的DWRUtil.$
if (typeof data == "string") ele = $(data);
//如果ele是个HTML元素对象,通常应该是一个form对象
if (DWRUtil._isHTMLElement(data)) ele = data;
if (ele != null) {
//如果ele不是form对象,返回,只有form对象才有elements 属性
if (ele.elements == null) {
alert("getValues() requires an object or reference to a form element.");
return null;
}
//定义一个空对象reply
var reply = {};
//定义一个对象放key
var value;
//遍历form,将表单key-value放入reply,忽略<input type="image"/>
for (var i = 0; i < ele.elements.length; i++) {
if (ele[i].id != null) value = ele[i].id;
else if (ele[i].value != null) value = ele[i].value;
else value = "element" + i;
reply[value] = DWRUtil.getValue(ele[i]);
}
return reply;
}
//如果传入的参数对象不是表单对象,通常应该是与领域对象对应js对象
else {
//遍历对象属性,将与属性对应的页面元素值拷到js对象中
for (var property in data) {
// Are there any elements with that id or name
if ($(property) != null || document.getElementsByName(property).length >= 1) {
data[property] = DWRUtil.getValue(property);
}
}
return data;
}
};
总结
1)如果你需要使用ajax完成表单提交的操作,那么你应该使用DWRUtil.getValues,参数或者是个form对象,或者是个与领域对象对应的js对象
2)应该看到第二种用法的局限性,如果存在多个相同的表单或者是个复合的js对象,那么第二种用法是不合适的
3)第一种用法看似复杂,但更具灵活性
到底改如何选择取决于具体的应用
====================================================
背景:需要使用ajax完成表单提交操作
核心代码如下:
function addReply(frm){
。。。。
//利用dwr自动将frm提交的数据植入js对象,
//DWRUtil.getValues的使用见我的上篇帖子
var commentForm = DWRUtil.getValues(frm);
//调用服务器端的服务
CommentService.writeComment(writecallback,commentForm );
。。。。。
}
注意以下几点
1)传给服务的js对象最好严格与领域对象对应不能有key为""的属性否则会报错,可以有多余 的属性,但后台会出现一些烦人日志信息告诉你无法匹配
2)对于领域对象来说,dwr在转换时会遍历所有get方法(根据传入的js对象属性进行反射不就好了,为什么要遍历get方法,真是奇怪啊),所以注意你的get方法要健壮避免后台会出很多日志信息汇报空指针之类的错误
3)关于本地传递的js对象,必须结构与领域对象对应。从抽象的角度看多数情况领域对象完 全可以用数组和hash结构描述,何况所谓的对应只是属性的对应,所以合理的使用Array和Object完全可以实现js对象和领域对象的匹配
4)必须配置合适的转化器让dwr知道如何将你传入的js对象转化为领域对象
5)使用DWRUtil.getValues(frm)或者DWRUtil.getValues(obj)收集提交的数据
方式的区别详见该文上半部分