运用C#创建一个.Net下的Web Service
2024-07-10 13:01:49
供稿:网友
 
微软在其.net战略中,对其主推的web service做了大肆的宣扬。现在,web service正如火如荼地发展着,相关的各项新技术层出不穷。web service的发展正构筑着互联网时代美好的明天。在本文中,我将向大家介绍web service的一些基本知识、如何用c#建立一个web service。通过文章,我们还将对wsdl、uddi以及未来的web service有一个大致的了解。 
 
为什么需要web service? 
以前,分布式的应用程序逻辑需要使用分布式的对象模型,通过使用dcom、corba、rmi之类的基本结构,开发人员仍可拥有使用本地模型所提供的丰富资源和精确性,并可将服务置于远程系统中。 
当已经有中意的中间件平台(rmi、jini、corba、dcom 等等)时,我们为什么还要为web而烦恼呢?中间件确实提供了强大的服务实现手段,但是,这些系统有一个共同的缺陷,那就是它们无法扩展到互联网上:它们要求服务客户端与系统提供的服务本身之间必须进行紧密耦合,即要求一个同类基本结构。然而这样的系统往往十分脆弱:如果一端的执行机制发生变化,那么另一端便会崩溃。例如,如果服务器应用程序的接口发生更改,那么客户端便会崩溃。为了能扩展到互联网运用,我们需要一种松散偶合的基本结构来解决这个问题。如此的情况下就迎来了web service的诞生。 
 
什么是web service? 
web service 是一种新的web应用程序分支,他们是自包含、自描述、模块化的应用,可以发布、定位、通过web调用。web service可以执行从简单的请求到复杂商务处理的任何功能。一旦部署以后,其他web service应用程序可以发现并调用它部署的服务。 
web service是一种应用程序,它运用了web网络技术和基于组件开发的精华成分。可以使用标准的互联网协议,像超文本传输协议(http)和xml,将功能纲领性地体现在互联网和企业内部网上。像dcom、rmi、iiop等基于组件的对象模型已经流行了较长一段时间了。然而这些模型都是依赖于一个特定的对象模型协议。web service扩展了这些模型,使之可以和简单对象访问协议(simple object access protocol,soap)以及xml通信以根除特定对象模型协议带来的障碍。可将webservice视作web上的组件编程。(参见如图1) 
web service基本上是利用超文本传送协议(http)和soap来使商业数据可以在网上获得。它将商业对象(com对象、java beans等)显露给在http上的soap调用并执行远程功能调用。因此,web service的使用者可以在远程对象上通过soap和http在web上进行方法调用。 
 
 
图1
 
soap调用是一类能引起在位置b上的web service组件程序执行的调用。之后,程序执行的结果就以xml文档的形式返回给在位置a上的用户。 
在图1中,在位置a的用户怎么知道在位置b的用户的一些情况的呢?这个就要涉及到一个通用标准。服务描述语言(service description language, sdl),soap契约语言(soap contract language,scl)以及网络可访问性规格语言(network accessible specification language,nassl)都是为了这个目的而建立的xml类语言。然而,ibm和微软最近同意将web服务描述语言(web service description language,wsdl)作为web service的标准。 
web service组件的结构是通过web服务描述语言来显露的。wsdl1.1是一个用来描述web service的属性以及界面的xml文档。目前已经有了新的规格书,该规格书可以在http://msdn.microsoft.com/xml/general/wsdl.asp上获得。 
 
面临的任务 
学会web service的最好方法就是自己动手做一个实例。我们都熟悉股票报价服务,纳斯达克、道琼斯都是很著名的例子。它们都提供一个输入公司代号并取得最新的股票价格的接口。本文我们就设法设计出同样的功能。 
 
创建web service的工具 
本文我们通过ms.net framework sdk来实现这个程序。 
创建web service的比较好的集成开发环境(ide)是visual studio.net。然而,你也可以很容易的用任何文本编辑器(记事本、写字板、visual studio 6.0)来创建一个web service文件。 
还有,你必须熟悉以下概念: 
net平台的基础知识 
c#的基础知识 
面向对象概念的基础知识 
 
创建一个web service 
下面,我们将用c#建立一个名为“securitywebservice”的web service。一个web service文件将含有形式为.asmx的扩展名。(就像asp.net的文件扩展名为.aspx) 
 
<%@ webservice language="c#" class="securitywebservice" %> 
这条语句将告诉编译器程序将运行在web service模式下以及c#类的名称。同时我们要访问web service的名字空间。还有,最好添加一个对system名字空间的引用。 
using system; 
using system.web.services; 
该securitywebservice的类应该继承web service类的功能。因此,我们添加了下面这行代码: 
public class securitywebservice : webservice 
现在我们来运用我们的面向对象的技巧编写一个c#类。c#的类和c++、java的类非常相象,如果你有c++和java的基础,这个就是小菜一碟了。 
.net下的web service能够设定一些基本的数据类型。因此,如果我们返回“int”、“float”或是“string”等数据类型的话,它能自动将它们转化为标准的xml输出。然而不巧的是在大多数的情况下,我们需要同一个实体的一类数据集。下面我先举个例子。我们的securitywebservice股票报价服务要求用户输入一个公司的代号,然后它会给出公司的全名以及当前的股票价格。由此,我们需要一个公司的三条信息: 
公司代号(数据类型:string) 
公司全名(数据类型:string) 
股票价格(数据类型:double) 
我们需要将单个股票报价的数据信息分解开。可以有很多方法完成此项工作,我们这里用了最好的枚举数据类型。我们在c#中用了“structs”,和c++中的structs一样。代码如下: 
public struct securityinfo 
{ 
public string code; 
public string companyname; 
public double price; 
} 
 
现在我们已经完成所有建立web service所需的模块了。因此,所有的代码如下: 
 
<%@ webservice language="c#" class="securitywebservice" %> 
 
using system; 
using system.web.services; 
 
public struct securityinfo 
{ 
public string code; 
public string companyname; 
public double price; 
} 
 
public class securitywebservice : webservice 
{ 
private securityinfo security; 
 
public securitywebservice() 
{ 
security.code = ""; 
security.companyname = ""; 
security.price = 0; 
} 
 
private void assignvalues(string code) 
{ 
// 在这里使用商业组件 
// 方法调用就是用来获得所需的数据的 
// 本程序中我给相应的代码添加了一个对应的字符串以方便显示 
// 同时,我使用了随机数产生器来生成股票价格 
 
security.code = code; 
security.companyname = code + " pty ltd"; 
random randomnumber = new system.random(); 
security.price = double.parse(new system.random(randomnumber.next(1,10)).nextdouble().tostring("##.##")); 
} 
 
[webmethod(description="this method call will get the company name and the price for a given security code.",enablesession=false)] 
public securityinfo getsecurityinfo(string code) 
{ 
assignvalues(code); 
securityinfo securitydetails = new securityinfo(); 
securitydetails.code = security.code; 
securitydetails.companyname = security.companyname; 
securitydetails.price = security.price; 
return securitydetails; 
} 
} 
 
请记住,这个web service能通过http做任何使用。我们也许会在代码中涉及到一些很敏感的商业数据,但是却不想它落入他人之手。那解决的方案就是保护一些逻辑函数,使用户只能访问到一些用来显示数据的函数。为了达到这个目的,我们使用了关键字“[web method]”。下面就是示例代码: 
[webmethod(description="this......",enablesession=false)] 
public securityinfo getsecurityinfo(string code) 
这个函数的访问类型是公有型的。标签“description”是用来描述这个web service的功能的。因为我们不必储存任何session数据,所以我们将session状态设置为false。 
private void assignvalues(string code) 
这是一个应该被逻辑保护的函数。因为我们不希望我们的商业机密数据能在web被轻易的获得,所以我们将函数的访问类型设为private(注:在这里,即使你将函数的访问类型设为public,这个函数还是不能被公共地访问到,原因是关键字“[web method]”没有被用到)。 
到此,我们可以用getsecurityinfo(string)函数来获得最新的股票价格。同时,为了方便起见,我给公司代码添加了相应公司的名字。还有,股票的价格是随机产生的。 
最后,我们将该文件保存在一个由iis控制的目录下,文件名为“sampleservice.asmx”。运行后的图示如下: 
 
 
图2
 
以上是一个由.net framework生成的web页面,我们并没有创建这个页面(它是由系统自动产生的,所以我并不需要写任何代码来创建该页面)。这个功能使我们的工作量相对减轻了不少。同样,你也可以通过运用asp.net的pagelets功能或修改网页文件使页面以不同的方式显示其中的内容。你可以在http://www.ibuyspy.com/store/instantorder.asmx获得一个很好的例子。 
 
如何使用这个web service? 
现在我们来使用这个web service。我们先输入一些值来获得股票示例价格。 
 
 
图3
 
按下invoke按钮,我们就可以获得以下的xml文档: 
 
 
图4
 
这样,这个web service就给用户提供了其所需的信息了。因为是xml格式的文档,我们需要写客户端来析取这个xml文档。客户端可以为以下几类: 
1.一个web页面 
2.一个控制台或是windows下的运用程序 
3.一个用wml语言描述的手机程序 
4.一个运用在pda上的palm或win ce程序 
你可以直接用http get方法来调用这个web service。这样的话就不会出现第一个页面了,也不需要用户去点击invoke按钮了。具体方法: 
http://server/webservicename.asmx/functionname?parameter=parametervalue 
调用我们的web service的方法就是: 
http://localhost/work/aspx/sampleservice.asmx/getsecurityinfo?code=ibm 
 
到此为止,我们已经知道如何用c#创建并使用一个web service,但是任务并没有完全完成。我们需要知道如何在internet上找到我们的web service,我们的web service能不能也被收入在个大搜索引擎。为了解决这个问题,我们就需要建立一个“discovery”文件。 
 
创建发现文件 
在访问一个已有的web service以前,你必须先得找到并整合这个web service,这个过程就是web service的发现过程。通过这个发现过程,你才知道这个web service能为你提供什么样的服务以及你怎么和它实现互动。发现文件是一个以.disco为扩展名的xml文件。在实际运用中,你是不必为每一个web service创建发现文件的。以下就是一个发现文件的例子: 
<?xml version="1.0" ?> 
<disco:discovery xmlns:disco="http://schemas.xmlsoap.org/disco/"> 
<scl:contractref ref="http://localhost/work/aspx/sampleservice.asmx?sdl"/> 
</disco:discovery> 
我们先将这个文件命名为“sampleservice.disco”,并将它保存在该web service的目录下。如果我们是在“/work/aspx”目录下创建web service的话,我们就可以运用更灵活的“动态发现”了。“动态发现”能自动为我们检测“/work/aspx”目录以及子目录下的所有*.disco文件的,这样就省了我们不少功夫。 
<?xml version="1.0" ?> 
<dynamicdiscovery xmlns="urn:schemas-dynamicdiscovery:disco.2000-03-17"> 
</dynamicdiscovery>  
你可以在http://services3.xmethods.net/dotnet/default.disco获得一份能使用的发现文件。通过分析发现文件,我们可以找到所需的web service。然而,在得到发现文件前你必须知道这个发现文件的确切的url。否则你还是找不到你要的发现文件的,那么你当然就不能找到你要的web service了。这样,我们现在就要用到一项新技术了――通用发现,描述和整合(universal description,discovery,and integration,uddi)来为已存在的web service做宣传了。uddi是公开的,基于internet的。这项技术目前还处于起初阶段,所以正不断发展着。你可以在http://uddi.microsoft.com/ 获得有关uddi的参考。 
 
发布这个web service 
发布web service是很简单的。和asp.net的程序差不多,你只要将.asmx文件和.disco文件拷贝到相应的目录,这样如果一切正常,这个web service就可以工作了。 
 
展望web service的未来 
web service技术的前途是相当光明的。在推动web service技术向前发展的道路上,不仅微软注入了很大的投资,sun、ibm等也表示很大的兴趣。同时,网上还有为apache和java 的soap工具包。然而,web service起步不久,还需要很多的工作要做。特别在国内,web service技术起步比国外有晚了一步,所以更要抓紧时间、迎接挑战。