.NET之ASP Web Services 快速入门

80酷酷网    80kuku.com

   世界软件巨擘微软公司提出的.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文档对象模型。比如说,"This ispretty neat" 就可以存储在一个XmlNode类型变量中。我们可以将XmlNodes作为参数传递,以SOAP兼容方式附加到传递给Web Services的XML文档上。返回值也是同样原理。XmlNode也可看成是类或结构中的字段。
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的震撼力量。我们有理由相信,凭借如此强大的工具,开发人员将更具创造力!

分享到
  • 微信分享
  • 新浪微博
  • QQ好友
  • QQ空间
点击: