C#操作webservice经典入门教程及实例Word格式.docx
《C#操作webservice经典入门教程及实例Word格式.docx》由会员分享,可在线阅读,更多相关《C#操作webservice经典入门教程及实例Word格式.docx(17页珍藏版)》请在冰豆网上搜索。
是一个客户端和服务器端请求和应答的标准(TCP)。
http协议其目的是为了提供一种发布和接收htttp页面的方法
一http协议的客户端与服务器的交互:
由HTTP客户端发起一个请求,建立一个到服务器指定端口(默认是80端口)的TCP连接。
HTTP服务器则在那个端口监听客户端发送过来的请求。
一旦收到请求,服务器(向客户端)发回一个状态行,比如"
HTTP/1.1200OK"
,和(响应的)消息,消息的消息体可能是请求的文件、错误消息、或者其它一些信息。
soap协议:
它描述了一种在分散或分布式的环境中如何交换信息的轻量级协议。
soap在http协议的基础上,一个基于XML的协议。
不同:
都是底层的通信协议,请求包的格式不同而已,soap包是XML格式,http纯文本格式。
关系:
SOAP是个通信协议,SOAP在HTTP协议的基础上,把编写成XML的REQUEST参数,放在HTTPBODY上提交个WEBSERVICE服务器(SERVLET,ASP什么的)处理完成后,结果也写成XML作为RESPONSE送回用户端,
为了使用户端和WEBSERVICE可以相互对应,可以使用WSDL作为这种通信方式的描述文件,利用WSDL工具可以自动生成WS和用户端的框架文件,SOAP具备把复杂对象序列化捆绑到XML里去的能力。
MembraneSOAPMonitor,这个soap监听工具。
这是德国的一家在线web服务注册公司predic8做的开源soap监听工具,简单好用。
windows下最新的版本为1.1.2版,下载地址:
还有linux下的版本:
源码:
具体使用:
1)
运行exe文件(linux下可能是jar文件);
2)
点击菜单项membrane->
addrule,进入后默认选项即可,点next;
3)
设置端口号(不产生冲突的任意端口),点next;
4)
设置主机及端口(部署服务的地址及服务器的端口),完成。
当调用网上发布的服务时,如检查qq是否在线的服务:
可将4)中的host设为远端服务的网址,如,端口设为服务的端口,上面就是80端口。
当我们监听soap消息时,只要访问了web服务,即可在membrane的界面显示发送及接受的soap消息
XMLWebService的特点
二、WebService开发
.net平台内建了对WebService的支持,包括WebService的构建和使用。
与其它开发平台不同,使用.net平台,你不需要其他的工具或者SDK就可以完成WebService的开发了。
.netFramework本身就全面支持WebService,包括服务器端的请求处理器和对客户端发送和接受SOAP消息的支持。
下来我们就一步一步的用MicrosoftVisualStudio.net20058(后面简称VS.Net2008)创建和使用一个简单的WebService。
2.1、用创建一个最简单的WebService
首先,打开VS2005,打开"
文件-新建-网站"
,选择"
ASP.NETWeb服务"
查看Service.cs代码,你会发现VS.Net2005已经为WebService文件建立了缺省的框架。
原始代码为:
?
默认工程里面已经有一个HelloWorld的方法了,
namespaceWebService1
{
///<
summary>
///Service1的摘要说明
/summary>
[WebService(Namespace="
//tempuri.org/"
)]
//用于向XMLWebservices添加附加信息,如描述其功能的字符串。
//对于将要发布和执行的XMLWebservices来说,WebServiceAttribute不是必需的。
//可以使用WebServiceAttribute为XMLWebservices指定不受公共语言运行库标识符(用于XMLWebservices的“服务说明”和“服务帮助”页)规则限制的名称。
//XMLWebservices在成为公共之前,应该更改其默认的XML命名空间。
//每个XMLWebservices都需要唯一的XML命名空间来标识它,以便客户端应用程序能够将它与网络上的其他服务区分开来。
//tempuri.org/可用于正在开发中的XMLWebservices,
//但是已发布的XMLWebservices应该使用更具永久性的命名空间。
例如,可以将公司的Internet域名作为XML命名空间的一部分。
//虽然很多XMLWebservices的XML命名空间与URL很相似,但是,它们无需指向Web上的某一实际资源。
(XMLWebservices的XML命名空间是URI。
)对于使用ASP.NET创建的XMLWebservices,可以使用Namespace属性更改默认的XML命名空间。
[WebServiceBinding(ConformsTo=WsiProfiles.BasicProfile1_1)]//ConformsTo
获取或设置绑定声称所符合的Web服务互操作性(WSI)规范。
//声明定义一个或多个XMLWebservices方法的绑定。
无法继承此类。
//按Web服务描述语言(WSDL)的定义,绑定类似于一个接口,原因是它定义一组具体的操作。
//每个XMLWebservices方法都是特定绑定中的一项操作。
XMLWebservices方法是XMLWebservices的默认绑定的成员,
//或者是在应用于实现XMLWebservices的类的WebServiceBindingAttribute中指定的绑定的成员。
//XMLWebservices可以通过将多个WebServiceBindingAttribute属性应用于XMLWebservices来实现多个绑定。
//将一个或多个WebServiceAttribute属性应用到XMLWebservices之后,可以将SoapDocumentMethodAttribute或SoapRpcMethodAttribute应用到各个XMLWebservices方法
//以指示由特定的XMLWebservices方法实现的绑定操作。
//设置SoapDocumentMethodAttribute或SoapRpcMethodAttribute的Binding属性以指定XMLWebservices方法正在为其实现操作的绑定。
[System.ComponentModel.ToolboxItem(false)]//提供工具箱项的基实现。
//若要允许使用ASP.NETAJAX从脚本中调用此Web服务,请取消对下行的注释。
//[System.Web.Script.Services.ScriptService]
publicclassService1:
System.Web.Services.WebService//
//表示此网站项目实现的一个Web服务,如同将此网站引用添加到项目时以VisualStudio生成的.asmx文件表示一样。
[WebMethod]//向使用ASP.NET创建的XMLWebservices中的某个方法添加此属性(Attribute)后,就可以从远程Web客户端调用该方法。
//初始化WebMethodAttribute类的新实例。
publicstringHelloWorld()
return"
HelloWorld"
;
}
直接运行看看效果,
点击显示页面上图中的"
HelloWorld"
超链接,跳转到下一页面:
点击"
调用"
按钮,就可以看到用XML格式返回的WebService结果下图。
说明我们的WebService环境没有问题,而且还初步接触了一下最简单的WebService。
2.2、创建一个简单带有功能的WebService
上面我们宏观的了解了webservice,其实它就是个对外的接口,里面有函数可供外部客户调用(注意:
里面同样有客户不可调用的函数).假若我们是服务端,我们写好了个webservice,然后把它给了客户(同时我们给了他们调用规则),客户就可以在从服务端获取信息时处于一个相对透明的状态.即是客户不了解(也不需要)其过程,他们只获取数据.在代码文件里,如果我们写了一个函数后,希望此函数成为外部可调用的接口函数,我们必须在函数上面添上一行代码[WebMethod(Description="
函数的描述信息"
)],如果你的函数没有这个申明,它将不能被用户引用.下来我们开始编写一个简单的WebService的例子。
先把默认的HelloWorld方法注释掉,简单的写了求加减乘除运算的四个方法;
viewplaincopytoclipboardprint?
usingSystem;
usingSystem.Linq;
usingSystem.Web;
usingSystem.Web.Services;
usingSystem.Web.Services.Protocols;
usingSystem.Xml.Linq;
)]
[WebServiceBinding(ConformsTo=WsiProfiles.BasicProfile1_1)]
//[System.Web.Script.Services.ScriptService]
publicclassService:
System.Web.Services.WebService
{
publicService(){
//如果使用设计的组件,请取消注释以下行
//InitializeComponent();
}
//[WebMethod]
//publicstringHelloWorld()
//{
//
return"
//}
[WebMethod(Description="
求和的方法"
publicdoubleaddition(doublei,doublej)
{
returni+j;
求差的方法"
publicdoublesubtract(doublei,doublej)
returni-j;
求积的方法"
publicdoublemultiplication(doublei,doublej)
returni*j;
求商的方法"
publicdoubledivision(doublei,doublej)
if(j!
=0)
returni/j;
else
return0;
}
[WebServiceBinding(ConformsTo=WsiProfiles.BasicProfile1_1)]
System.Web.Services.WebService
publicService(){
}
//[WebMethod]
//publicstringHelloWorld()
//{
//}
publicdoubleaddition(doublei,doublej)
{
publicdoublesubtract(doublei,doublej)
publicdoublemultiplication(doublei,doublej)
publicdoubledivision(doublei,doublej)
=0)
else
运行可以看到我们自己写的可以被调用的方法,如下图:
同样点击addition方法,进入addition方法的调用页。
在参数上面输入参数i=3,j=3,如上图,点击调用,就可以看到用XML格式返回的WebService结果(i与j相加的结果)下图
到这里,我们会发现,其实webservice并不是那么的神秘,它也不过只是个接口,对我们而言,侧重点就是是接口函数的编写.
2.3、用ASP.NET调用WebService
ASP.NET网站"
。
选好存储位置,语言后点击确定,进入默认页面。
然后先添加Web引用,把WebService引到当前的工程里面。
方法是:
在资源管理器中点击右键,选择添加Web引用,调出对话框:
在URL中填入,前面写好的WebService运行后浏览器上面显示的地址(即:
WebService发布后的访问地址),点击"
前往"
按钮,如上图,就会显示出所引用的WebService中可以调用的方法,然后点击"
添加引用"
,就将webservice引用到了当前的工程里面,如下图,解决方案中会出现引进来的WebService文件
我们在这就练习调用webservice的四个方法,做一个简单的调用的例子,先在网站的前台添加几个控件,代码如下:
<
%@PageLanguage="
C#"
AutoEventWireup="
true"
CodeFile="
Default.aspx.cs"
Inherits="
_Default"
%>
!
DOCTYPEhtmlPUBLIC"
-//W3C//DTDXHTML1.0Transitional//EN"
"
//www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"
>
htmlxmlns="
//www.w3.org/1999/xhtml"
headrunat="
server"
<
title>
无标题页<
/title>
/head>
body>
formid="
form1"
runat="
div>
asp:
TextBoxID="
Num1"
/asp:
TextBox>
selectid="
selectOper"
runat="
option>
+<
/option>
-<
*<
/<
/select>
Num2"
ButtonID="
Button1"
Text="
="
onclick="
Button1_Click"
/>
Result"
/div>
/form>
/body>
/html>