WebService

第五章 Web Service

第一章 Web service简介

现在Internet正在不断地发展着，在互联网应用刚开始的时候，我们浏览的网页只是静态的，不可交互的。而现在随着技术的日益发展，将提供给网页浏览者一个可编程的Web 站点。这些站点将在组织、应用、服务、驱动上更加紧密的结合在一起，这些站点将通过一些应用软件直接连接到另一个Web 站点，这些可编程的Web 站点相比传统的web站点来说，将变得更加能重复使用，也更加智能化！

平台给我们提供了一种运行环境，即公用语言运行环境（CLR，Common Language Runtime）。对 CLR来说，它提供了一种内置机制来创建一个可编程的站点，、对于Web 程序开发者和VB 程序员来说，这将是一致、熟悉的。这种模型是可以重复使用，也可以再扩展。它包含了开放的Internet标准（HTTP, XML, SOAP, SDL）。以便它能被网页浏览者访问。

ASP.NET 使用.asmx 文件来对Web Services的支持。.asmx 文件和.aspx文件一样都属于文本文件。它包含在.aspx文件之中，成为ASP.NET应用程序的一部分。

下面我们将举一个简单的例子来介绍.asmx文件，我们还是从“Hello，World”这个经典的例子说起，代码如下：

中国劳动和社会保障部

<%@ WebService Language="VB" Class="HelloWorld" %>

Imports System.Web.Services

Public Class HelloWorld :Inherits WebService

Public Function <WebMethod( )> SayHelloWorld( ) As String

Return("Hello World")

End Function

End Class

说明：

1．编码最开始必须进行WebService声明，从而定义这个文件为一个Web Service。而且，在同一行中设置好编程语言的类型。

2．然后，引入名字空间System.Web.Services。注意，这个名字空间属于最基本的元素，必须要包含它。

3．接着，声明service中的功能模块，也就是类模块，这里的类名叫HelloWorld。这个类来源于基类WebService，而且应该是public类型。

4．最后，定义service的可访问方法。在表示方法的符号前面，要设置好自定义属性。对应于C#语言，属性值就是[WebMethod]；对应于VB，就是。如果没有设置这个属性，那么这个方法就不能从service中访问。一个局部应用可以使用任何的public类型的类，但是只有具备[WebMethod]的类才可以通过SOAP被远程地访问。

当对service的请求发生时，.asmx文件将自动地被ASP.NET运行环境所编译。随后的请求就可以由缓冲的预编译类型对象执行。

为了测试编写好的代码，我们需用一个支持ASP.NET的Web服务器。假设这个Web服务器的名称叫做server1，其上有一个虚拟目录test。请跟随下面步骤开始测试：

1．将代码保存为HelloWorld.asmx

2．放到Web服务器Foo的虚拟目录Bar下

3．打开Internet Explorer5，在地址栏输入server1/test/HelloWorld.asmx

这时，我们将看到关于这个Web Service的公用方法－也就是那些标记为WebMethod属性的字符，并得知调用这些方法可以使用的协议，比如SOAP或者HTTP GET。

在Internet Explorer的地址栏中输入Foo/Bar/HelloWorld.asmx?SDL后，将产生基于服务描述语言（Service Description Language ：SDL）语法的具备相同信息的XML文件。这个SDL文件非常重要，客户端就是使用它来访问service。

我们来看一下程序运行的效果：

从客户端进行访问：

除了允许开发者使用的创建Web Services的技术以外，Microsoft的.NET框架给客户端提供

了一套访问并使用Web Services的精致且高深的工具和代码。由于Web Services是基于如简单对象访问协议SOAP（Simple Object Access Protocol）和HTTP这样的开放协议标准的，从而，我们就可以使用这种客户端技术使用非ASP.NET的Web Services。当然，这也需用高水平地合成ASP.NET Web Services和这种客户端技术。

SDK中有一个工具叫做，我们可以使用它来下载一个Web Services的SDL描述语言，并创建表达这个Service的代理类。比如，当我们输入以下命令，就可以创建一个叫做HelloWorld.cs的代理类：

WebServiceUtil /c:proxy /pa:someDomain/someFolder/HelloWorld.asmx?SDL圣雅伦

这个类看起来与前面创建的类非常相似。它包含一个方法SayHelloWorld，该方法返回一个字符串。将这个代理类编译到一个应用程序中，然后调用这个代理类的方法，结果就是：通过HTTP，这个代理类包装SOAP请求，然后接收SOAP编码响应，最后汇集成为一个字符串。

从客户端来看，代码是很简单的，返回的结果也很简单，就是一个字符串"Hello World"。同样为了对照方便，我们列出了使用VB、C#以及JScript三种语言编写的代码：

HelloWorld myHelloWorld = new HelloWorld();

String sReturn = myHelloWorld.SayHelloWorld();

Dim myHelloWorld As New HelloWorld()

Dim sReturn As String = myHelloWorld.SayHelloWorld()

JScript

var myHelloWorld:HelloWorld = new HelloWorld();

var sReturn:String = myHelloWorld.SayHelloWorld();

通过上面的例程，你可能对Web Services有了初步的印象。下面，我们将介绍Web Services中涉及到的各种数据类型，也就是Web Services方法的输入/输出参数类型。因为

Web Services的执行是建立在XML架构之上的，所以它能够支持丰富的数据类型。下表列出了使用SOAP协议时Web Services支持的数据类型：

类型	描述
基础类型	也即标准基础类型，包括： String、Int32、Byte、Boolean、Int16、Int64、Single、Double、Decimal、DateTime(类似XML中的timeInstant)、 DateTime(类似XML中的date)、DateTime(类似XML中的time)以及XmlQualifiedName(类似XML中的QName)。
枚举类型	枚举类型。例如：. "public enum color { red=1, blue=2 }"
基础，枚举数组	上面提到的类型数组。例如：string[] 和 int[]
类和结构	带有公用域或属性的类和结构，公用域和属性是串行结构的
类和结构体数组	上述类型的数组
DataSet	ADO.NET DataSet 类型。DataSets能在类和结构体作为字段来使用。
胞二磷胆碱DataSet数组	上述类型的数组
XmlNode	XmlNode是XML文档片断的内存表示，就好像一个轻量级的XML文档对象模型。比如说，"" 就可以存储在一个XmlNode类型变量中。我们可以将XmlNodes作为参数传递，以SOAP兼容方式附加到传递给Web Services的XML文档上。返回值也是同样原理。XmlNode也可看成是类或结构中的字段。
XmlNode数组	上述类型的数组

当通过SOAP或者HTTP GET/POST调用Web Services时，返回值可以是上述提到的任何一种数据类型。

参数的数据类型

使用SOAP协议时，"通过值"以及"通过引用"这两种输入/输出参数形式都可被支持。如果是"通过引用"的参数类型，就会产生两种方式的数据发送效果：到服务器的以及返回到客户端的。但是，当通过HTTP GET/POST传递输入参数给Web Services时，就只支持有限的数据类型了，而且还必须是"通过值"形式的参数。这些类型如下：

类型	描述
pamam基础类型 (有限的)	支持大多数标准基础类型，包括： Int32、String、Int16、Int64、Boolean、Single、Double、Decimal、DateTime、TimeSpan、UInt16、UInt32、UInt64和Currency。从客户端来看，所有这些类型都转变为string。
枚举类型	比如： "public enum color { red=1, blue=2 }"。
基础类型数组，枚举类型数组	上述类型的数组，比如 string[]和int[]