.net web service实例

.net web service实例

首先,我们们必须了解什么是webservice.就概念上来说,可能比较复杂,不过我们们可以有个宏观(的)了解:webservice就是个对外(的)接口,里面有 函数可供外部客户调用(注意:里面同样有客户不可调用(的)函数).假若我们们是服务端,我们们写好了个webservice,然后把它们给了客户(同时我们们给了他们 们调用规则),客户就可以在从服务端获取信息时处于一个相对透明(的)状态.即是客户不了解(也不需要)其过程,他们们只获取数据.

　　webservice传递(的)数据只能是序列化(的)数据,典型(的)就是xml数据,这里我们们也只讨论xml数据(的)传输.

　　有了一些对xml webservice(的)初步了解后,我们们将切入正题,即是用一个具体(的)webservice事例(的)形式来讲解具体(的)webservice用法,用具体(的)事例来讲解一个概念我们想怎么也要比单纯(的)说理能让人容易理解吧.

　　这里,我们们将以一个简单(的)分布式课件搜索系统为例来讲解.使用VS2003为编译环境,C#为语言,SqlServcer2000为数据库.(这个例子来 源于一位网上朋友(的)文章(的)启发,觉(得)很能代表webservice(的)特点,就按那个想法做了这么个系统来示例了)

　　首先,明确我们们要做什么.我们们需要一个对客户(的)接口,也就是个站点,我们们把它们称做ServiceGatherSite,它们是何种形式都无所谓,甚至它们本身 并不需要数据库,它们只是提供给用户一个查询(的)接口,真正(的)服务,普通用户是不接触到(的).然后,这里我们们还需要若干个提供服务(的)站点,我们们可以称它们们为资源 站,这里为简单起见,假设有两个资源站,分别叫WebSiteA,WebSiteB,它们们可以是不对外公布(的),只是为了丰富查询数据而存在.最后,是我们们 最需要关注(的)东西---资源站提供给ServiceGatherSite(的)服务.两个资源站,就有两个服务,我们们称为SiteAService和 SiteBService.两个服务间没有任何关系,内部提供(的)技巧也完全没关联,只是需要把技巧如何使用告诉ServiceGatherSite,意思 是,服务只提供查询接口,返回(的)数据如何处理,服务本身并不管,全由使用服务(的)站点分配.

　　写了这么多,算是简要(的)介绍了下有关xml webservice(的)概念和我们们这个例子(的)结构,下篇文章,我们们将开始真正进入代码(的)设计阶段.

　　上篇文章介绍了些webservice(的)基本特性和我们们例子(的)结构,这篇文章我们们将开始具体(的)代码编写工作.

　　这个专题主要讲述(的)是webservice,因此这里我们们(的)代码以Webservice相关为主,而其他们工程,例如:ServiceGatherSite,WebSiteA等,只将简略介绍.

　　在VS2003中,开发一个webservice并不是件困难(的)事,首先,我们们新建一个webservice项目(文件->新建->项目->C#->Web服务应用程序)

　　建完这个工程,我们们将看到一个叫Service1.asmx(的)文件,这就是webservice(的)标准文件,它们也有UI(的)概念,不过我们们一般不关注,因 此,我们们查看其cs代码文件.如果你们什么都还没做(的)话,将看见一个被注释掉(的)helloworld(的)WebMethod,把注释去掉,在运行,你们就可以(得) 到最简单(的)webservice运行实例了.点击"helloworld"将执行其技巧.显然,这个函数对我们们(的)意义只在于宏观(的)了解了下web服务(的)写 法.

　　下面,我们们将开始具体介绍webservice(的)写法.在代码文件里,如果我们们写了一个函数后,希望此函数成为外部可调用(的)接口函数,我们们必须在函数上面 添上一行代码[WebMethod(Description="函数(的)描述信息")],如果你们(的)函数没有这个申明,它们将不能被用户引用.如:

　　[WebMethod(Description="最简单(的)技巧")]
　　public string HelloWorld()
　　{
　　return "Hello World";
　　}
　　这个函数就是外部可调用(的)接口函数,对用户来说相当于一个API.如果某用户在引用了这个服务后,他们调用HelloWorld()技巧,他们就将获(得)"HelloWorld"这个返回值.
　　看到这里,我们们是不是发现,其实webservice并不是那么(的)神秘,它们也不过只是个接口,对我们们而言,侧重点依然是接口函数(的)编写.下面,我们将给出我们们(的)例子所需要(的)接口函数.
　　[WebMethod(Description="查询以获取需要(的)课件信息")]
　　public XmlDataDocument GetSiteAData(string AssignName)
　　{
　　XmlDataDocument xd=new XmlDataDocument(); //
　　DataSet ds=new DataSet();
　　CStoreProc cp=new CStoreProc("SearchAssign");
　　cp.AddParIn("@keywords",SqlDbType.VarChar,30,AssignName);
　　cp.AddParOut("@res",SqlDbType.Int);
　　if(cp.SelectProc()) //如果执行成功,存储过程
　　{
　　cp.myData.EnforceConstraints=false; //不进行格式严格检查
　　if((int)cp.GetReturnValue("@res")==-1)
　　{
　　string xml="";
　　xd.LoadXml(xml);
　　return xd;
　　}
　　xd=new XmlDataDocument(cp.myData);
　　XmlNode root1=xd.DocumentElement;
　　XmlNodeList roots=root1.SelectNodes("list");
　　foreach(XmlNode roota in roots) //为所有元素加上站点名称标记
　　{
　　XmlElement Link=xd.CreateElement("SiteName");
　　Link.InnerText=ConfigurationSettings.AppSettings["SiteName"].ToString();
　　roota.AppendChild(Link);
　　}
　　return xd;
　　}
　　else return null;
　　}

　　这是获取资源站点信息(的)一个接口函数.里面大部分(的)代码,我们想对于有一定asp.net基础(的)朋友来说,都应该是一看就明白,这里只说明下CStoreProc,这是我们封装(的)一个存储过程类,主要功能是执行各种类型(的)存储过程.

　　细心(的)朋友可能会发现这个函数(的)返回类型似乎比较特殊,是个xml(的)文档.我们们在前面已经说过,webservice只能传输序列化数据,xml显然满足 条件,但比如hash表之类(的)非序列化数据,是不能传输(的),xml使用最为广泛,而且考虑到跨平台应用,所以这里我们们只以xml数据(的)传输来示例.

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

　　函数功能很简单,只是要返回查询结果,其数据格式是XmlDataDocument.当查询失败时(无匹配查询结果),我们们构造一个xml,返回一个空记 录.否则,我们们把查询后(的)dataset生成一个XmlDataDocument,接下来,由于该项目(的)需要,我们加入了一个循环,添加dataset里所 没有(的)节点,站点名称.在这之后,算是完成了一个符合我们们期望格式(的)xml数据文档,我们们把它们返回.

　　好了,webservice(的)技巧函数介绍完了(这里还有个web服务技巧,稍后介绍),接下来我们们(的)任务是怎么调用它们了.首先把webservice(的) 项目编译完成,假定我们们这个服务是针对资源站点A(的),我们们不妨称其为ServiceA.先单独运行asmx文件,执行GetSiteAData (string AssignName)技巧,将提示你们输入参数,你们输入要搜索(的)内容,点确认,将返回给你们一个xml数据,并在ie上显示出来,这就是你们搜索到(的)内容拉.

　　这里对ServiceA(的)工作再做点介绍,在我们们这个项目里,它们是资源站点A提供(的)服务,意思是,它们查询(的)数据将全来源于站点A,而站点A资源添加在本项目也有专门(的)工程实现.

　　好了,回到正题.这里我们介绍vs调用webservice(的)技巧,其实其他们平台(的)调用技巧也是大同小异.首先我们们介绍web引用方式,这种方式我们强烈建议 调试时使用,非常方便.右击引用,点添加web引用,输入你们(的)webservice(地)址,如:http: //localhost/aspxproject/WebServiceSolution/SiteBService/service1.asmx,你们必 须保证你们输入(的)webservice存在.然后引用即可,注意:web引用名将作为你们加入(的)webservice(的)名字空间.比如你们输入了:SiteA, 那服务(的)实例化将是这样:SiteA.Service1 serviceA=new SiteA.Service1();(Service1是服务(的)类名).

　　完成了这一步,service(的)调用似乎变(的)那么简单,我们们已经实现了远程实例化,接下来(的)远程调用也是一样(的)容易.下面给出资源采集站ServiceGatherSite(的)绑定代码(只采集A站点(的)信息)

　　//绑定数据
　　public void BindData()
　　{
　　serviceA=new SiteA.Service1();
　　DataSet ds=new DataSet();
　　XmlNode xmlNode1;
　　XmlDataDocument xd=new XmlDataDocument();
　　StringBuilder xmlString1;
　　xmlNode1=serviceA.GetSiteAData(strSearch);
　　if(xmlNode1==null) //--存储过程执行失败
　　return;
　　xmlString1=new StringBuilder(xmlNode1.OuterXml);
　　if(xmlString1.ToString().Equals(""))
　　return ;
　　xd.LoadXml(xmlString1.ToString());
　　ds.ReadXml(new XmlNodeReader(xd));
　　DataGrid1.DataSource=ds.Tables["list"].DefaultView;
　　DataGrid1.DataBind();
　　}

　　此段代码给出了xml转化成dataset(的)解决方案,虽然这不是必须(的),但毕竟在asp.net里,dataset占(的)作用之重,谁都知道(的).其他们(的)请 朋友们先看(呵呵,个中高手就免了),在下篇文章中将会有对它们(的)一些解释与及多服务分布调用(的)解决方案,写了三篇了,发现似乎还是有些朋友看(的),那我们就献 丑继续写下去好了,大家有什么意见也希望提出,在下(的)理解存在偏驳也再所难免,希望谅解:)

　　接上篇文章,我们们先简单说明下绑定函数.首先实例化ServiceA,这个和一般类(的)实例化并没有不同..接下来用xmlNode1来接受函数(的)返回值,接下来是构造xml,并将其转化为dataset,这是通用(的)技巧,如果是刚接触不久(的)朋友,最好能记下这种技巧.

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

　　//绑定数据
　　public void BindData()
　　{
　　IAsyncResult ar1;
　　IAsyncResult ar2;
　　serviceA=new SiteA.Service1();
　　serviceB=new SiteB.Service1();
　　DataSet ds=new DataSet();
　　XmlNode xmlNode1,xmlNode2;
　　XmlDataDocument xd=new XmlDataDocument();
　　StringBuilder xmlString1,xmlString2;
　　//--简单(的)异步调用
　　ar1=serviceA.BeginGetSiteAData(strSearch,null,null);
　　ar2=serviceB.BeginGetSiteAData(strSearch,null,null);
　　xmlNode1=serviceA.EndGetSiteAData(ar1);
　　xmlNode2=serviceB.EndGetSiteAData(ar2);
　　//----------
　　if(xmlNode1==null&&xmlNode2==null) //--存储过程执行失败
　　return;
　　xmlString1=new StringBuilder(xmlNode1.OuterXml);
　　xmlString2=new StringBuilder(xmlNode2.OuterXml);
　　xmlString1=MakeNewXmlString(xmlString1,xmlString2); //生成新(的)xml
　　if(xmlString1.ToString().Equals(""))
　　return ;
　　xd.LoadXml(xmlString1.ToString());
　　ds.ReadXml(new XmlNodeReader(xd));
　　DataGrid1.DataSource=ds.Tables["list"].DefaultView;
　　DataGrid1.DataBind();
　　}
　　//生成新XML
　　public StringBuilder MakeNewXmlString(StringBuilder str1,StringBuilder str2)
　　{
　　str1=str1.Replace("","");
　　str2=str2.Replace("","");
　　str1.Append(str2.ToString());
　　return str1;
　　}

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

　　下面讲下通过dll来引用webservice(的)技巧,我们只把流程介绍下.

　　首先,在ie输入服务(的)(地)址,如:http://www.xxx.com/service.asmx

　　然后写输入http://www.xxx.com/service.asmx?wsdl

　　打开后,另存为xxx.wsdl

　　然后用vs(的)命令提示符来编译:wsdl /namespace:SiteA ServiceA.wsdl

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

　　最后csc /out:ServiceA.dll /t:library Service1.cs ,其中service1.cs为代理类文件

　　最后引用dll就可以了.

本文来自: 华军天空软件园(www.m888888.com) 详细出处参考：http://www.m888888.com/dirss/html/169597.html