深入Atlas系列：Web Sevices Access in Atlas（1） - 客户端支持
Atlas提供了强大而灵活的服务器端Web Services访问能力。这对于客户端AJAX开发提供了绝好的条件，这几乎也是任何AJAX框架必备的功能。因为只要有了它，就能轻松地以AJAX方 式与服务器端进行交互，而其他多样的页面操作自然可以由开发人员尽情开发。对于部分喜欢自己动手的开发人员来说，这甚至是他们仅仅需要的支持。
从这篇文章开始，我会从实现角度剖析Atlas对于Web Services的支持，希望能够帮助大家更深入地理解，更灵活地使用Atlas提供的这一功能。
在Atlas中，对于Web Services的访问，其实都是通过Sys.Net.ServiceMethod类来实现的。我们先通过UML来看一下Sys.Net.ServiceMethod以及其其他一些类的关系。
Sys.Net.WebMethod类是Sys.Net.ServiceMethod和Sys.Net.PageMethod的父类。后者用于访问写于 页面中使用WebMethodAttribute标注的方法，不在这篇文章的讨论范围内。Sys.Net.WebMethod内定义了五个抽象函数： get_methodName、addHeaders、get_url、get_body和get_appUrl，其作用应该相当地显而易见。而继承 Sys.Net.WebMethod的类，例如Sys.Net.ServiceMethod，则提供了这五个抽象函数的实现。
Sys.Net.WebMethod类有一个非常有趣的函数“invoke”。从UML图中会发现，它居然提供了一个Javascript中没有的功能：“函数重载（overload）”！至于它是如何实现，该如何使用，稍后将结合代码进行详细介绍。
那么就进入代码分析阶段，先从Sys.Net.WebMethod的结构看起，从一个Atlas类的大致结构可以看出该类的成员定义和“构造函数”的实现。
Sys.Net.WebMethod结构
可以见到五个抽象函数定义，在this._invoke函数是真正产生请求的地方，里面还有数个用于引发事件的方法。整个类的结构非常简单。
接下来我们来仔细分析一下this.invoke函数。
this.invoke函数分析
可以看到，这就是就是this.invoke“函数重载（overload）”的实现方式。到底是故意如此设计还是在后续开发时为了兼容，可能就不得而知了。不过也就是说，我们现在有中参数传递可以使用。
第一种是：
this.invoke第一种调用方式
第二种是：
this.invoke第二种调用方式
关于参数的含义，请参照this._invoke函数的分析。
接下来分析this._invoke的代码，这才是真正工作的代码。
this._invoke函数分析
可以看出，Sys.Net.WebMethod是使用Sys.Net.WebReqeust来发出AJAX请求的。在Atlas应用中如果需 要使用AJAX请求的话，应该全部使用Sys.Net.WebRequest，这个类不仅对于XMLHttpRequest进行了良好的封装，另外它使用 了Sys.Net._WebRequestManager对于所有请求进行了全局地控制，使用了浏览器和HTTP协议的特性，提高了请求的效率。这一点几 乎是微软介绍Atlas时都会着重强调的一点。
在创建了Sys.Net.WebRequest对象后，并不是将用户传入的那些回调函数直接注册给它的事件，而是使用了Sys.Net.WebMethod里的onXXXX，进行了进一步的处理，代码如下：
onXXX函数分析
在onComplete方法中，会查看status code。在HTTP 1.x中，2xx代表了Success（关于完整Status Code的描述，请参考[url]http://www.w3.org/Protocols/HTTP/HTRESP.html[/url]）。由此可以得知该如何调用用户提供的回调函数。在调用回调函数时会将用户提供的userContext作为参数传入，这种做法在异步调用中被经常使用，例如.NET Framework中Delegate的异步调用。
至此，Sys.Net.WebMethod就被解释完了，并不复杂，甚至我觉得我的解释有些累赘。不过它提供的方法非常重要，是客户端访问服务器端函数 的核心（客户端方面）。而调用Web Services，则需要Sys.Net.ServiceMethod这个Sys.Net.WebMethod的子类来提供那五个抽象函数的具体实现，分 析如下：
Sys.Net.ServiceMethod代码分析
对于传入参数url和appUrl，可能需要重新解释一下。如果url传入的是相对路径，则appUrl可以为null。
为了有更深的理解，我们来看一个例子：
ws.asmx代码：
ws.asmx文件代码
HelloWorld函数接受一个整数作为参数，返回一个数组。第一个元素为一个字符串，第二个元素为服务器当前时间。
Default.aspx文件代码：
Default.aspx文件代码
在这里使用的是invoke函数的第二种调用方法，传入一个随机数作为参数，并将信息显示在页面上。效果如下：
我们打开Fiddler，看看具体的请求如何，请注意红色框出的地方：
Request：
Request Body：
Response Body：
是不是和我们预料的完全相同？有了JSON，我们可以非常方便地构造和表示一个客户端对象，Atlas在客户端和服务器端都提供了非常强大的JSON Serializer。这些方法可以应用在任何需要场合，即使脱离了Atlas。
到现在为止，已经将Atlas以AJAX方式调用Web Services的客户端基础代码分析完了。但是这其实还远远不够，有了客户端代码，至少还需要服务器端的支持。那么在服务器端Atlas又是如何提供以AJAX方式调用Web Services方法的功能呢？
我们将在下一篇文章中讨论这个问题。
点击这里查看范例。
从这篇文章开始，我会从实现角度剖析Atlas对于Web Services的支持，希望能够帮助大家更深入地理解，更灵活地使用Atlas提供的这一功能。
在Atlas中，对于Web Services的访问，其实都是通过Sys.Net.ServiceMethod类来实现的。我们先通过UML来看一下Sys.Net.ServiceMethod以及其其他一些类的关系。
Sys.Net.WebMethod类是Sys.Net.ServiceMethod和Sys.Net.PageMethod的父类。后者用于访问写于 页面中使用WebMethodAttribute标注的方法，不在这篇文章的讨论范围内。Sys.Net.WebMethod内定义了五个抽象函数： get_methodName、addHeaders、get_url、get_body和get_appUrl，其作用应该相当地显而易见。而继承 Sys.Net.WebMethod的类，例如Sys.Net.ServiceMethod，则提供了这五个抽象函数的实现。
Sys.Net.WebMethod类有一个非常有趣的函数“invoke”。从UML图中会发现，它居然提供了一个Javascript中没有的功能：“函数重载（overload）”！至于它是如何实现，该如何使用，稍后将结合代码进行详细介绍。
那么就进入代码分析阶段，先从Sys.Net.WebMethod的结构看起，从一个Atlas类的大致结构可以看出该类的成员定义和“构造函数”的实现。
可以见到五个抽象函数定义，在this._invoke函数是真正产生请求的地方，里面还有数个用于引发事件的方法。整个类的结构非常简单。
接下来我们来仔细分析一下this.invoke函数。
可以看到，这就是就是this.invoke“函数重载（overload）”的实现方式。到底是故意如此设计还是在后续开发时为了兼容，可能就不得而知了。不过也就是说，我们现在有中参数传递可以使用。
第一种是：
第二种是：
关于参数的含义，请参照this._invoke函数的分析。
接下来分析this._invoke的代码，这才是真正工作的代码。
可以看出，Sys.Net.WebMethod是使用Sys.Net.WebReqeust来发出AJAX请求的。在Atlas应用中如果需 要使用AJAX请求的话，应该全部使用Sys.Net.WebRequest，这个类不仅对于XMLHttpRequest进行了良好的封装，另外它使用 了Sys.Net._WebRequestManager对于所有请求进行了全局地控制，使用了浏览器和HTTP协议的特性，提高了请求的效率。这一点几 乎是微软介绍Atlas时都会着重强调的一点。
在创建了Sys.Net.WebRequest对象后，并不是将用户传入的那些回调函数直接注册给它的事件，而是使用了Sys.Net.WebMethod里的onXXXX，进行了进一步的处理，代码如下：
在onComplete方法中，会查看status code。在HTTP 1.x中，2xx代表了Success（关于完整Status Code的描述，请参考[url]http://www.w3.org/Protocols/HTTP/HTRESP.html[/url]）。由此可以得知该如何调用用户提供的回调函数。在调用回调函数时会将用户提供的userContext作为参数传入，这种做法在异步调用中被经常使用，例如.NET Framework中Delegate的异步调用。
至此，Sys.Net.WebMethod就被解释完了，并不复杂，甚至我觉得我的解释有些累赘。不过它提供的方法非常重要，是客户端访问服务器端函数 的核心（客户端方面）。而调用Web Services，则需要Sys.Net.ServiceMethod这个Sys.Net.WebMethod的子类来提供那五个抽象函数的具体实现，分 析如下：
对于传入参数url和appUrl，可能需要重新解释一下。如果url传入的是相对路径，则appUrl可以为null。
为了有更深的理解，我们来看一个例子：
ws.asmx代码：
HelloWorld函数接受一个整数作为参数，返回一个数组。第一个元素为一个字符串，第二个元素为服务器当前时间。
Default.aspx文件代码：
在这里使用的是invoke函数的第二种调用方法，传入一个随机数作为参数，并将信息显示在页面上。效果如下：
我们打开Fiddler，看看具体的请求如何，请注意红色框出的地方：
Request：
Request Body：
Response Body：
是不是和我们预料的完全相同？有了JSON，我们可以非常方便地构造和表示一个客户端对象，Atlas在客户端和服务器端都提供了非常强大的JSON Serializer。这些方法可以应用在任何需要场合，即使脱离了Atlas。
到现在为止，已经将Atlas以AJAX方式调用Web Services的客户端基础代码分析完了。但是这其实还远远不够，有了客户端代码，至少还需要服务器端的支持。那么在服务器端Atlas又是如何提供以AJAX方式调用Web Services方法的功能呢？
我们将在下一篇文章中讨论这个问题。
点击这里查看范例。
点击这里下载范例。
本文转自 jeffz 51CTO博客，原文链接：http://blog.51cto.com/jeffz/60933，如需转载请自行联系原作者