世界软件巨擘微软公司提出的.NET概念给全世界的IT产业指明了新的发展方向,无论是IT业内人士、还是企业决策者,快速领会这个新概念的含义及深远影响,都显得非常必要。
本文通过一个经典学习例程讲述.NET之ASP Web Services的编程、测试及使用,并介绍Web Services中涉及到的数据类型,旨在带领你快速理解其相关概念、含义及作用。全文包括:
概 要
编写代码、领会含义
例程测试
从客户端进行访问
Web Services中的数据类型
结 语
概 要
Internet进化得飞快,Web站点从仅仅提交给浏览器一个用户界面页面,到现在已经转变为能够将组织、应用、服务以及设备迅速联结在一起的可设计Web站点。Web站点不再处于被动的地位,它们变成了可再用的智能化Web Services,即Web服务。
通用语言执行环境(Common Language Runtime,简称CLR)本身就支持创建及使用Web Services。它使用可编程抽象概念,无论对于ASP.NET Web Form开发人员还是VB用户,这都是一致的且熟悉的。而且,结果模型可升级、可扩展,支持开放的Internet标准,比如HTTP、XML、SOAP、SD,因此,它可以被任何客户端或者具备Internet功能的设备访问和使用。
为了更快更好地理解.NET的ASP Web Service应用,下面我们举一个例子来说明。例子就是经典的Hello World应用,也就是简单地返回一个"Hello World"字符串信息。
编写代码、领会含义
ASP.NET通过.asmx文件来支持Web Services,一个.asmx文件就是一个文本文件,类似于.aspx文件。这些文件可以属于包含.aspx文件的ASP.NET
应用程序的一部分。同时,与.aspx文件一样,它们是按照URI方式寻址的。
可以使用最简单的文本编辑器来编写.asmx文件。下面就是.asmx 文件的全部代码。为对照方便,我们列出了使用VB、C#以及JScript三种语言编写的代码:
C#
using System;
using System.Web.Services;
public class HelloWorld : WebService {
[WebMethod] public String SayHelloWorld() {
return "Hello World";
}
}
VB
<% WebService Language="VB" Class="HelloWorld" %>
Imports System.Web.Services
Public Class HelloWorld :Inherits WebService
Public Function SayHelloWorld() As String
Return("Hello World")
End Function
End Class
JScript
import System;
import System.Web.Services;
public class HelloWorld extends WebService {
WebMethodAttribute public function SayHelloWorld() : String {
return "Hello World";
}
}
上面的代码包含了以下几个含义:
代码最开始必须进行WebService声明,从而定义这个文件为一个Web Service。而且,在同一行中设置好编程语言的类型。
然后,引入名字空间System.Web.Services。注意,这个名字空间属于最基本的元素,必须要包含它。
接着,声明service中的功能模块,也就是类模块,这里的类名叫HelloWorld。这个类来源于基类WebService,而且应该是public类型。
最后,定义service的可访问方法。在表示方法的符号前面,要设置好自定义属性。对应于C#语言,属性值就是[WebMethod];对应于VB,就是。如果没有设置这个属性,那么这个方法就不能从service中访问。一个局部应用可以使用任何的public类型的类,但是只有具备[WebMethod]的类才可以通过SOAP被远程地访问。
例程测试
当对service的请求发生时,.asmx文件将自动地被ASP.NET运行环境所编译。随后的请求就可以由缓冲的预编译类型对象执行。
为了测试编写好的代码,我们需用一个支持ASP.NET的Web服务器。假设这个Web服务器的名称叫做Foo,其上有一个虚拟目录Bar。请跟随下面步骤开始测试:
将代码保存为HelloWorld.asmx
放到Web服务器Foo的虚拟目录Bar下
打开Internet Explorer5,在地址栏输入
这时,我们将看到关于这个Web Service的公用方法-也就是那些标记为WebMethod属性的字符,并得知调用这些方法可以使用的协议,比如SOAP或者HTTP GET。
在Internet Explorer的地址栏中输入后,将产生基于服务描述语言(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中有一个工具叫做WebServiceUtil.exe,我们可以使用它来下载一个Web Services的SDL描述语言,并创建表达这个Service的代理类。比如,当我们输入以下命令,就可以创建一个叫做HelloWorld.cs的代理类:
WebServiceUtil /c:proxy /pa:http://someDomain.com/someFolder/HelloWorld.asmx?SDL
这个类看起来与前面创建的类非常相似。它包含一个方法SayHelloWorld,该方法返回一个字符串。将这个代理类编译到一个应用程序中,然后调用这个代理类的方法,结果就是:通过HTTP,这个代理类包装SOAP请求,然后接收SOAP编码响应,最后汇集成为一个字符串。
从客户端来看,代码是很简单的,返回的结果也很简单,就是一个字符串"Hello World"。同样为了对照方便,我们列出了使用VB、C#以及JScript三种语言编写的代码:
C# HelloWorld myHelloWorld = new HelloWorld();
String sReturn = myHelloWorld.SayHelloWorld();
VB
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方法的输入/输出参数类型。因为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类型,可看成是类或结构中的字段。 |
DataSet数组 | 上述类型的数组 |
XmlNode | XmlNode是XML文档片断的内存表示,就好像一个轻量级的XML文档对象模型。比如说," |
XmlNode数组 | 上述类型的数组 |
返回值的数据类型
当通过SOAP或者HTTP GET/POST调用Web Services时,返回值可以是上述提到的任何一种数据类型。
参数的数据类型
使用SOAP协议时,"通过值"以及"通过引用"这两种输入/输出参数形式都可被支持。如果是"通过引用"的参数类型,就会产生两种方式的数据发送效果:到服务器的以及返回到客户端的。但是,当通过HTTP GET/POST传递输入参数给Web Services时,就只支持有限的数据类型了,而且还必须是"通过值"形式的参数。这些类型如下:
类 型 | 含 义 |
基础类型 (有限的) | 支持大数标准基础类型,包括: Int32、String、Int16、Int64、Boolean、Single、Double、Decimal、DateTime、TimeSpan、UInt16、UInt32、UInt64和Currency。从客户端来看,所有这些类型都转变为string。 |
枚举类型 | 比如: "public enum color { red=1, blue=2 }"。 |
基础类型数组,枚举类型数组 | 上述类型的数组,比如 string[]和int[] |
数据类型应用举例
下面的例子利用WebServiceUtil.exe建立的SOAP代理来使用上面列出的数据类型。注意:因为在.asmx文件中定义了多于一个的公用类,所以,我们必须要指定哪一个作为WebService类,这可以通过设置WebService标识的Class属性来实现,代码如下:
请看看下面的例子:
DataTypes.asmx
DataTypes.sdl
从上例中我们看到:
· SayHello方法显示从service中返回的一个字符串信息。
· SayHelloName方法返回一个字符串,并接受一个字符串参数。
· GetIntArray方法显示了如何返回一个整数数组。
· GetMode方法返回一个枚举数值。
· GetOrder方法返回一个类。
· GetOrders方法返回定单对象数组。
对于使用客户端应用程序而言,使用WebServiceUtil代理生成工具配置这些数据类型是透明的。请看关于上述Web Service的一个客户端例程:
DataTypesClient.aspx
结 语
以上通过一个简单例程讲述了.NET之ASP Web Services的概念及使用,并说明了WebServices中的数据类型。我们看到了如何使用三种不同的编程语言达到目的。你会发现,我们正在慢慢地触及.NET的神奇思想,领会.NET的震撼力量。我们有理由相信,凭借如此强大的工具,开发人员将更具创造力!