深入Atlas系列之客户端支持

第一种是：

　　this.invoke第一种调用方式：

1 this.invoke( 2 { 3 　param1 : value1, 4 　param2 : value2, 5 　…… 6 }, 7 { 8 　onMethodComplete : ……, 9 　onMethodTimeout : ……, 10　 onMethodError : ……, 11　 onMethodAborted : ……, 12　 userContext : ……, 13　 timeoutInterval : ……, 14　 priority : ……, 15　 useGetMethod : …… 16 });

　　第二种是：

　　this.invoke第二种调用方式：

1 this.invoke( 2 { 3 　param1 : value1, 4 　param2 : value2, 5 　…… 6 }, 7 onMethodComplete, 8 onMethodTimeout, 9 onMethodError, 10 onMethodAborted, 11 userContext, 12 timeoutInterval, 13 priority, 14 useGetMethod);

　　关于参数的含义，请参照this._invoke函数的分析。

　　接下来分析this._invoke的代码，这才是真正工作的代码。

　　this._invoke函数分析：

1 // 参数定义： 2 // params：一个Dictionary，用key - value的方式保存即将传递给Web Services的参数 3 // onMethodComplete：调用完成时使用的回调函数 4 // onMethodTimeout：请求超时时使用的回调函数 5 // onMethodError：Web Services发生错误（例如抛出异常）时使用的回调函数 6 // onMethodAborted：请求被取消是使用得回调函数 7 // userContext：用户提供的任意参数，会在回调函数被执行时作为参数使用 8 // timeoutInterval：超时前所等待的时间，Number类型 9 // priority：优先级，Sys.Net.WebRequestPriority枚举类型 10 // useGetMethod：是否使用HTTP GET方法，Boolean类型 11 this._invoke = function(params, onMethodComplete, 12 onMethodTimeout, onMethodError, onMethodAborted, userContext, 13 timeoutInterval, priority, useGetMethod) { 14 15 // 检测参数类型是否正确 16 window.debug.validateParameters("WebMethod.Invoke", arguments, 17 [ 18 ['params', Object, true], 19 ['onMethodComplete', Function, true], 20 ['onMethodTimeout', Function, true], 21 ['onMethodError', Function, true], 22 ['onMethodAborted', Function, true], 23 ['timeoutInterval', Number, true], 24 ['priority', Number, true], 25 ['useGetMethod', Boolean, true] 26 ]); 27 28 // 使用Sys.Net.WebRequest对象进行AJAX请求 29 var request = new Sys.Net.WebRequest(); 30 31 // 使用子类的addHeaders实现添加Header 32 this.addHeaders(request.get_headers()); 33 // 使用子类的实现set_url实现设置url 34 request.set_url(this.get_url(params, useGetMethod)); 35 // 使用子类的实现set_appUrl实现设置appUrl 36 request.set_appUrl(this.get_appUrl()); 37 38 // 为了添加body，param不能为null 39 if (params == null) { 40 　params = {}; 41 } 42 43 // 使用子类的set_body实现设置body 44 request.set_body(this.get_body(params, useGetMethod)); 45 // 将onComplete函数注册给Sys.Net.WebRequest的complete事件 46 request.completed.add(onComplete); 47 // 将onTimeout函数注册给Sys.Net.WebRequest的timeout事件 48 request.timeout.add(onTimeout); 49 // 将onAborted函数注册给Sys.Net.WebRequest的aborted事件 50 request.aborted.add(onAborted); 51 52 // 如果提供了timeoutInterval那么设置它 53 if (timeoutInterval) { 54 　request.set_timeoutInterval(timeoutInterval); 55 } 56 57 // 如果priority不是Sys.Net.WebRequestPriority.High的话， 58 // 则设置WebRequest的Priority属性 59 if (priority ＞= 0) { 60 　request.set_priority(priority); 61 } 62 63 // 获得methodName，为后面的onXXXX方法提供信息 64 var methodName = this.get_methodName(); 65 66 request.invoke(); 67 68 function onComplete(response, eventArgs) { 69 　…… 70 } 71 72 function onTimeout(request, eventArgs) { 73 　…… 74 } 75 76 function onAborted(request, eventArgs) { 77 　…… 78 } 79 80 //返回Sys.Net.WebRequest对象，一般没有什么作用 81 return request; 82 }

　　可以看出，Sys.Net.WebMethod是使用Sys.Net.WebReqeust来发出AJAX请求的。在Atlas应用中如果需要使用AJAX请求的话，应该全部使用Sys.Net.WebRequest，这个类不仅对于XMLHttpRequest进行了良好的封装，另外它使用了Sys.Net._WebRequestManager对于所有请求进行了全局地控制，使用了浏览器和HTTP协议的特性，提高了请求的效率。这一点几乎是微软介绍Atlas时都会着重强调的一点。