运用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技术起步比国外有晚了一步,所以更要抓紧时间、迎接挑战。