web service

首先,我们必须了解什么是webservice.就概念上来说,可能比较复杂,不过我们

可以有个宏观的了解:webservice就是个对外的接口,里面有函数可供外部客

户调用(注意:里面同样有客户不可调用的函数).假若我们是服务端,我们写好了

个webservice,然后把它给了客户(同时我们给了他们调用规则),客户就可以

在从服务端获取信息时处于一个相对透明的状态.即是客户不了解(也不需要)其

过程,他们只获取数据.

webservice传递的数据只能是序列化的数据,典型的就是xml数据,这里我们也

只讨论xml数据的传输.

有了一些对xmlwebservice的初步了解后,我们将切入正题,即是用一个具体的

webservice事例的形式来讲解具体的webservice用法,用具体的事例来讲解一

个概念我想怎么也要比单纯的说理能让人容易理解吧.

这里,我们将以一个简单的分布式课件搜索系统为例来讲解.使用VS2003为编译

环境,C#为语言,SqlServcer2000为数据库.(这个例子来源于一位网上朋友的

文章的启发,觉得很能代表webservice的特点,就按那个想法做了这么个系统来

示例了)

首先,明确我们要做什么.我们需要一个对客户的接口,也就是个站点,我们把它

称做ServiceGatherSite,它是何种形式都无所谓,甚至它本身并不需要数据

库,它只是提供给用户一个查询的接口,真正的服务,普通用户是不接触到的.然

后,这里我们还需要若干个提供服务的站点,我们可以称它们为资源站,这里为

简单起见,假设有两个资源站,分别叫WebSiteA,WebSiteB,它们可以是不对外公

布的,只是为了丰富查询数据而存在.最后,是我们最需要关注的东西—资源站

提供给ServiceGatherSite的服务.两个资源站,就有两个服务,我们称为

SiteAService和SiteBService.两个服务间没有任何关系,内部提供的方法也

完全没关联,只是需要把方法如何使用告诉ServiceGatherSite,意思是,服务

只提供查询接口,返回的数据如何处理,服务本身并不管,全由使用服务的站点分

配.

写了这么多,算是简要的介绍了下有关xmlwebservice的概念和我们这个例子的

结构,下篇文章,我们将开始真正进入代码的设计阶段.

上篇文章介绍了些webservice的基本特性和我们例子的结构,这篇文章我们将

开始具体的代码编写工作.

这个专题主要讲述的是webservice,因此这里我们的代码以Webservice相关为

主,而其他工程,例如:ServiceGatherSite,WebSiteA等,只将简略介绍.

在VS2003中,开发一个webservice并不是件困难的事,首先,我们新建一个

webservice项目(文件->新建->项目->C#->Web服务应用程序)

建完这个工程,我们将看到一个叫的文件,这就是webservice的

标准文件,它也有UI的概念,不过我们一般不关注,因此,我们查看其cs代码文

件.如果你什么都还没做的话,将看见一个被注释掉的helloworld的WebMethod,

把注释去掉,在运行,你就可以得到最简单的webservice运行实例了.点

击”helloworld”将执行其方法.显然,这个函数对我们的意义只在于宏观的了

解了下web服务的写法.

下面,我们将开始具体介绍webservice的写法.在代码文件里,如果我们写了一

个函数后,希望此函数成为外部可调用的接口函数,我们必须在函数上面添上

一行代码[WebMethod(Description="函数的描述信息")],如果你的函数没有这

个申明,它将不能被用户引用.如:

以下是引用片段：

[WebMethod(Description="最简单的方法")]publicstringHelloWorld()

{

return“HelloWorld”;

}

这个函数就是外部可调用的接口函数,对用户来说相当于一个API.如果某用户

在引用了这个服务后,他调用HelloWorld()方法,他就将获得”HelloWorld”这

个返回值.

看到这里,我们是不是发现,其实webservice并不是那么的神秘,它也不过只是

个接口,对我们而言,侧重点依然是接口函数的编写.下面,我将给出我们的例子

所需要的接口函数.

[WebMethod(Description="查询以获取需要的课件信息")]public

XmlDataDocumentGetSiteAData(stringAssignName)

{

XmlDataDocumentxd=newXmlDataDocument();//

DataSetds=newDataSet();

CStoreProccp=newCStoreProc(“SearchAssign”);

In(“@keywords”,r,30,AssignName);

Out(“@res”,);

if(Proc())//如果执行成功,存储过程

{

eConstraints=false;//不进行格式严格检查

if((int)urnValue(“@res”)==-1)

{

stringxml=”";

l(xml);

returnxd;

}

xd=newXmlDataDocument();

XmlNoderoot1=ntElement;

XmlNodeListroots=Nodes(“list”);

foreach(XmlNoderootainroots)//为所有元素加上站点名称标记

{

XmlElementLink=Element(“SiteName”);

ext=tings["SiteName"].ToString

();

Child(Link);

}

returnxd;

}

elsereturnnull;

}

这是获取资源站点信息的一个接口函数.里面大部分的代码,我想对于有一定

基础的朋友来说,都应该是一看就明白,这里只说明下CStoreProc,这是

我封装的一个存储过程类,主要功能是执行各种类型的存储过程.

细心的朋友可能会发现这个函数的返回类型似乎比较特殊,是个xml的文档.我

们在前面已经说过,webservice只能传输序列化数据,xml显然满足条件,但比

如hash表之类的非序列化数据,是不能传输的,xml使用最为广泛,而且考虑到跨

平台应用,所以这里我们只以xml数据的传输来示例.

接上篇文章,我们先简单解释下GetSiteAData(stringAssignName)函数.

函数功能很简单,只是要返回查询结果,其数据格式是XmlDataDocument.当查询

失败时(无匹配查询结果),我们构造一个xml,返回一个空记录.否则,我们把

查询后的dataset生成一个XmlDataDocument,接下来,由于该项目的需要,我加

入了一个循环,添加dataset里所没有的节点,站点名称.在这之后,算是完成了

一个符合我们期望格式的xml数据文档,我们把它返回.

好了,webservice的方法函数介绍完了(这里还有个web服务方法,稍后介绍),接

下来我们的任务是怎么调用它了.首先把webservice的项目编译完成,假定我

们这个服务是针对资源站点A的,我们不妨称其为ServiceA.先单独运行asmx文

件,执行GetSiteAData(stringAssignName)方法,将提示你输入参数,你输入要

搜索的内容,点确认,将返回给你一个xml数据,并在ie上显示出来,这就是你搜

索到的内容拉.

这里对ServiceA的工作再做点介绍,在我们这个项目里,它是资源站点A提供的

服务,意思是,它查询的数据将全来源于站点A,而站点A资源添加在本项目也有

专门的工程实现.

好了,回到正题.这里我介绍vs调用webservice的方法,其实其他平台的调用方

法也是大同小异.首先我们介绍web引用方式,这种方式我强烈建议调试时使

用,非常方便.右击引用,点添加web引用,输入你的webservice地址,如:http:

//localhost/aspxproject/WebServiceSolution/SiteBService/,

你必须保证你输入的webservice存在.然后引用即可,注意:web引用名将作为

你加入的webservice的名字空间.比如你输入了:SiteA,那服务的实例化将是

这样:e1serviceA=e1();(Service1是服务的类

名).

完成了这一步,service的调用似乎变的那么简单,我们已经实现了远程实例化,

接下来的远程调用也是一样的容易.下面给出资源采集站ServiceGatherSite的

绑定代码(只采集A站点的信息)

以下是引用片段：

//绑定数据publicvoidBindData()

{

serviceA=e1();

DataSetds=newDataSet();

XmlNodexmlNode1;

XmlDataDocumentxd=newXmlDataDocument();

StringBuilderxmlString1;

xmlNode1=eAData(strSearch);

if(xmlNode1==null)//–存储过程执行失败

return;

xmlString1=newStringBuilder(ml);

if(ng().Equals(“”))

return;

l(ng());

l(newXmlNodeReader(xd));

urce=["list"].DefaultView;

nd();

}

此段代码给出了xml转化成dataset的解决方案,虽然这不是必须的,但毕竟在

里,dataset占的作用之重,谁都知道的.其他的请朋友们先看(呵呵,

个中高手就免了),在下篇文章中将会有对它的一些解释与及多服务分布调用的

解决方案,写了三篇了,发现似乎还是有些朋友看的,那我就献丑继续写下去好

了,大家有什么意见也希望提出,在下的理解存在偏驳也再所难免,希望谅解:)

接上篇文章,我们先简单说明下绑定函数.首先实例化ServiceA,这个和一般类

的实例化并没有不同..接下来用xmlNode1来接受函数的返回值,接下来是构造

xml,并将其转化为dataset,这是通用的方法,如果是刚接触不久的朋友,最好能

记下这种方法.

接下来给出异步调用两个服务的代码

以下是引用片段：

//绑定数据publicvoidBindData()

{

IAsyncResultar1;

IAsyncResultar2;

serviceA=e1();

serviceB=e1();

DataSetds=newDataSet();

XmlNodexmlNode1,xmlNode2;

XmlDataDocumentxd=newXmlDataDocument();

StringBuilderxmlString1,xmlString2;

//–简单的异步调用

ar1=etSiteAData(strSearch,null,null);

ar2=etSiteAData(strSearch,null,null);

xmlNode1=SiteAData(ar1);

xmlNode2=SiteAData(ar2);

//———-

if(xmlNode1==null&&xmlNode2==null)//–存储过程执行失败

return;

xmlString1=newStringBuilder(ml);

xmlString2=newStringBuilder(ml);

xmlString1=MakeNewXmlString(xmlString1,xmlString2);//生成新的xml

if(ng().Equals(“”))

return;

l(ng());

l(newXmlNodeReader(xd));

urce=["list"].DefaultView;

nd();

}

//生成新XML

publicStringBuilderMakeNewXmlString(StringBuilder

str1,StringBuilderstr2)

{

str1=e(“”,”");

str2=e(“”,”");

(ng());

returnstr1;

}

这有两个需要注意的地方,一个是xml构造,还有就是异步调用的实现,请读者,

自己理解

下面讲下通过dll来引用webservice的方法,我只把流程介绍下.

首先,在ie输入服务的地址,如:/

然后写输入/?wsdl

打开后,另存为

然后用vs的命令提示符来编译:wsdl/namespace:

生成名字空间为sitea的代理类

最后csc/out:/t:,其中为

代理类文件

最后引用dll就可以了.

从表面上看，Webservice就是一个应用程序，它向外界暴露出一个能够通过

Web进行调用的API。也就是说，可以利用编程的方法通过Web来调用这个应用

程序。

对Webservice更精确的解释:Webservices是建立可互操作的分布式应用程

序的新平台。Webservice平台是一套标准，它定义了应用程序如何在Web上实

现互操作性。你可以用任何你喜欢的语言，在任何你喜欢的平台上写Web

service，只要我们可以通过Webservice标准对这些服务进行查询和访问。

不管你的Webservice是用什么工具，什么语言写出来的，只要你用SOAP协议

通过HTTP来调用它，总体结构都一致。通常，你用你自己喜欢的语言(如VB6

或者)来构建你的Webservice，然后用SOAPToolkit或者.NET的内建

支持来把它暴露给Web客户。于是，任何语言，任何平台上的客户都可以阅读其

WSDL文档，以调用这个Webservice。客户根据WSDL描述文档，会生成一个SOAP

请求消息。Webservice都是放在Web服务器(如IIS)后面的，客户生成的SOAP

请求会被嵌入在一个HTTPPOST请求中，发送到Web服务器来。Web服务器再把

这些请求转发给Webservice请求处理器。请求处理器的作用在于，解析收到的

SOAP请求，调用Webservice，然后再生成相应的SOAP应答。Web服务器得到

SOAP应答后，会再通过HTTP应答的方式把它送回到客户端。

中国网管论坛

基本概念

SOAP

XML和XSD

WSDL(WebServicesDescriptionLanguage)

WSML(WebServicesMetaLanguage)

什么时候使用WebServices

Webservice是创建可互操作的分布式应用程序的新平台。Webservice的主要

目标是跨平台的可互操作性。为了达到这一目标，Webservice是完全基于XML、

XSD等独立于平台、独立于软件供应商的标准的。

Webservice在应用程序跨平台和跨网络进行通信的时候是非常有用的。Web

service适用于应用程序集成、B2B集成、代码和数据重用，以及通过Web进行

客户端和服务器的通信的场合。

当然，Webservice也不是万能的，你不能到处滥用Webservice。在有些情况

下，Webservice会降低应用程序的性能，而不会带来任何好处。例如，一台机

器或一个局域网里面运行的同构应用程序就不应该用Webservice进行通信。

如何调用WebServices

客户端:取得服务端的服务描述文件WSDL，解析该文件的内容，了解服务端的服

务信息，以及调用方式。根据需要，生成恰当的SOAP请求消息(指定调用的方

法，已经调用的参数)，发往服务端。等待服务端返回的SOAP回应消息，解析得

到返回值。

服务端:生成服务描述文件，以供客户端获取。接收客户端发来的SOAP请求消息，

解析其中的方法调用和参数格式。根据WSDL和WSML的描述，调用相应的COM

对象来完成指定功能，并把返回值放入SOAP回应消息返回给用户。

高层接口

使用高层接口，不需要知道SOAP和XML的任何信息，就可以生成和使用一个

WebService。SoapToolkit2.0通过提供两个COM对象――SoapClient和

SoapServer，来完成这些功能。

在客户端，只需要生成一个SoapClient实例，并用WSDL作为参数来调用其中的

mssoapinit方法。SoapClient对象会自动解析WSDL文件，并在内部生成所有

WebService的方法和参数信息。之后，你就可以像调用IDispatch接口里的方

法一样，调用里面所有的方法。在VB或是脚本语言里，你甚至可以直接在

SoapClient对象名后面直接加上.方法(参数„)进行调用。

低层接口

要使用低层接口，你必须对SOAP和XML有所了解。你可以对SOAP的处理过程进

行控制，特别是要做特殊处理的时候。

在客户端，首先要创建一个HttpConnector对象，负责HTTP连接。设定Connector

的一些头部信息，比如EndPoinURL和SoapAction等。如果网络连接需要使用

代理服务器，那也要在这里设定相关的信息。接着创建SoapSerializer对象，

用于生成Soap消息。按照WSDL里定义，把所有参数按顺序序列化，得到一个

完整的SOAP请求消息。该Soap消息，作为Payload通过HttpConnector被发

送到服务端。最后，生成一个SoapReader对象，负责读取服务端返回的SOAP

消息，取得其中的返回值。