C#操作webservice(经典入门教程及实例)
2016-09-18 10:08
946 查看
Web Service基本概念
Web Service也叫XML Web Service WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求,轻量级的独立的通讯技术。是:通过SOAP在Web上提供的软件(服务),使用WSDL文件进行(说明),并通过(UDDI)进行注册。
XML:(Extensible Markup Language)扩展型可标记语言。面向短期的临时数据处理、面向万维网络,是Soap的基础。
Soap:(Simple Object Access Protocol)简单对象存取协议。是XML Web Service 的通信协议。当用户通过UDDI找到你的WSDL描述文档后,他通过可以SOAP调用你建立的Web服务中的一个或多个操作。SOAP是XML文档形式的调用方法的规范,它可以支持不同的底层接口,像HTTP(S)或者SMTP。
WSDL:(Web Services Description Language) WSDL 文件是一个 XML 文档,用于说明一组 SOAP 消息以及如何交换这些消息。大多数情况下由软件自动生成和使用。
UDDI (Universal Description, Discovery, and Integration) 是一个主要针对Web服务供应商和使用者的新项目。在用户能够调用Web服务之前,必须确定这个服务内包含哪些商务方法,找到被调用的接口定义,还要在服务端来编制软件,UDDI是一种根据描述文档来引导系统查找相应服务的机制。UDDI利用SOAP消息机制(标准的XML/HTTP)来发布,编辑,浏览以及查找注册信息。它采用XML格式来封装各种不同类型的数据,并且发送到注册中心或者由注册中心来返回需要的数据。
概念补充:
http soap关系
http:是一个客户端和服务器端请求和应答的标准(TCP)。http协议其目的是为了提供一种发布和接收htttp页面的方法
一http协议的客户端与服务器的交互:由HTTP客户端发起一个请求,建立一个到服务器指定端口(默认是80端口)的TCP连接。HTTP服务器则在那个端口监听客户端发送过来的请求。一旦收到请求,服务器(向客户端)发回一个状态行,比如"HTTP/1.1 200 OK",和(响应的)消息,消息的消息体可能是请求的文件、错误消息、或者其它一些信息。
soap 协议:它描述了一种在分散或分布式的环境中如何交换信息的轻量级协议。soap在http协议的基础上,一个基于XML的协议。 不同:都是底层的通信协议,请求包的格式不同而已,soap包是XML格式,http纯文本格式。
关系:SOAP是个通信协议, SOAP在HTTP协议的基础上,把编写成XML的REQUEST参数, 放在HTTP BODY上提交个WEB SERVICE服务器(SERVLET,ASP什么的) 处理完成后,结果也写成XML作为RESPONSE送回用户端, 为了使用户端和WEB SERVICE可以相互对应,可以使用WSDL作为这种通信方式的描述文件,利用WSDL工具可以自动生成WS和用户端的框架文件,SOAP具备把复杂对象序列化捆绑到XML里去的能力。 Membrane SOAP Monitor,这个soap监听工具。这是德国的一家在线web服务注册公司predic8做的开源soap监听工具,简单好用。
windows下最新的版本为1.1.2版,下载地址:
http://mirror.predic8.com/membrane/monitor/win86/membrane-monitor-win86-1.1.2.zip
还有linux下的版本:
http://download.predic8.com/membrane/monitor/linux-x86/membrane-monitor-linux-x86-0.9.4.tgz
源码:
http://download.predic8.com/membrane/monitor/src/membrane-monitor-src-0.9.4.zip
具体使用:
1) 运行exe文件(linux下可能是jar文件);
2) 点击菜单项membrane->add rule ,进入后默认选项即可,点next;
3) 设置端口号(不产生冲突的任意端口),点next;
4) 设置主机及端口(部署服务的地址及服务器的端口),完成。 当调用网上发布的服务时,如检查qq是否在线的服务: http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?wsdl
可将4)中的host设为远端服务的网址,如www.webxml.com.cn,端口设为服务的端口,上面就是80端口。
当我们监听soap消息时,只要访问了web服务,即可在membrane的界面显示发送及接受的soap消息
XML Web Service的特点
二、Web Service开发
.net平台内建了对Web Service的支持,包括Web Service的构建和使用。与其它开发平台不同,使用.net平台,你不需要其他的工具或者SDK就可以完成Web Service的开发了。.net Framework本身就全面支持Web Service,包括服务器端的请求处理器和对客户端发送和接受SOAP消息的支持。下来我们就一步一步的用Microsoft Visual Studio .net 20058(后面简称VS.Net 2008)创建和使用一个简单的Web Service。
2.1、用创建一个最简单的Web Service
首先,打开VS2005,打开"文件-新建-网站",选择"ASP.NET Web服务"查看Service.cs代码,你会发现VS.Net 2005已经为Web Service文件建立了缺省的框架。原始代码为:
默认工程里面已经有一个Hello World的方法了
namespace WebService1 {
/// <summary>
/// Service1 的摘要说明 /// </summary>
[WebService(Namespace = "http://tempuri.org/")]
//用于向 XML Web services 添加附加信息,如描述其功能的字符串。
//对于将要发布和执行的 XML Web services 来说,WebServiceAttribute 不是
//可以使用 WebServiceAttribute 为 XML Web services 指定不受公共语言运 //XML Web services 在成为公共之前,应该更改其默认的 XML 命名空间。
//每个 XML Web services 都需要唯一的 XML 命名空间来标识它,以便客户端的 XML Web services,
//但是已发布的 XML Web services 应该使用更具永久性的命名空间。例如,可
//虽然很多 XML Web services 的 XML 命名空间与 URL 很相似,但是,它们无
用 ASP.NET 创建的 XML Web services,可以使用 Namespace 属性更改默认的[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]//Confor
//声明定义一个或多个 XML Web services 方法的绑定。无法继承此类。
//按 Web 服务描述语言 (WSDL) 的定义,绑定类似于一个接口,原因是它定义
//每个 XML Web services 方法都是特定绑定中的一项操作。XML Web service
//或者是在应用于实现 XML Web services 的类的 WebServiceBindingAttribu
//XML Web services 可以通过将多个 WebServiceBindingAttribute 属性应用
//将一个或多个 WebServiceAttribute 属性应用到 XML Web services 之后,services 方法
//以指示由特定的 XML Web services 方法实现的绑定操作。
//设置 SoapDocumentMethodAttribute 或 SoapRpcMethodAttribute 的 Binding 属
[System.ComponentModel.ToolboxItem(false)]//提供工具箱项的基实现。
// 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务,请取消对下行的注 // [System.Web.Script.Services.ScriptService]
public class Service1 : System.Web.Services.WebService//
//表示此网站项目实现的一个 Web 服务,如同将此网站引用添加到项目时以 Visua {
[WebMethod]//向使用 ASP.NET 创建的 XML Web services 中的某个方法添//初始化 WebMethodAttribute 类的新实例。
public string HelloWorld()
{
return "Hello World"; } } }
点击"调用"按钮,就可以看到用XML格式返回的Web Service结果下图。说明我们的Web Service环境没有问题,而且还初步接触了一下最简单的Web Service。
2.2、创建一个简单带有功能的Web Service
上面我们宏观的了解了webservice,其实它就是个对外的接口,里面有函数可供外部客户调用(注意:里面同样有客户不可调用的函数).假若我们是服务端,我们写好了个webservice,然后把它给了客户(同时我们给了他们调用规则),客户就可以在从服务端获取信息时处于一个相对透明的状态.即是客户不了解(也不需要)其过程,他们只获取数据.在代码文件里,如果我们写了一个函数后,希望此函数成为外部可调用的接口函数,我们必须在函数上面添上一行代码
[WebMethod(Description="函数的描述信息")],如果你的函数没有这个申明,它将不能被用户引用.下来我们开始编写一个简单的Web Service 的例子。
if (j != 0) return i / j; else return 0; } }
using System; using System.Linq; using System.Web; using System.Web.Services;
using System.Web.Services.Protocols; using System.Xml.Linq;
[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)] // 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务,请取消对下行的注释。
// [System.Web.Script.Services.ScriptService] public class Service : System.Web.Services.WebService {
public Service () {
//如果使用设计的组件,请取消注释以下行 //InitializeComponent();
}
//[WebMethod]
//public string HelloWorld() //{
// return "Hello World"; //}
[WebMethod(Description = "求和的方法")] public double addition(double i, double j) {
return i + j; }
[WebMethod(Description = "求差的方法")] public double subtract(double i, double j) {
return i - j; }
[WebMethod(Description = "求积的方法")] public double multiplication(double i, double j) {
return i * j; }
[WebMethod(Description = "求商的方法")]
public double division(double i, double j) {
if (j != 0) return i / j; else return 0; } }
运行可以看到我们自己写的可以被调用的方法
Web Service也叫XML Web Service WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求,轻量级的独立的通讯技术。是:通过SOAP在Web上提供的软件(服务),使用WSDL文件进行(说明),并通过(UDDI)进行注册。
XML:(Extensible Markup Language)扩展型可标记语言。面向短期的临时数据处理、面向万维网络,是Soap的基础。
Soap:(Simple Object Access Protocol)简单对象存取协议。是XML Web Service 的通信协议。当用户通过UDDI找到你的WSDL描述文档后,他通过可以SOAP调用你建立的Web服务中的一个或多个操作。SOAP是XML文档形式的调用方法的规范,它可以支持不同的底层接口,像HTTP(S)或者SMTP。
WSDL:(Web Services Description Language) WSDL 文件是一个 XML 文档,用于说明一组 SOAP 消息以及如何交换这些消息。大多数情况下由软件自动生成和使用。
UDDI (Universal Description, Discovery, and Integration) 是一个主要针对Web服务供应商和使用者的新项目。在用户能够调用Web服务之前,必须确定这个服务内包含哪些商务方法,找到被调用的接口定义,还要在服务端来编制软件,UDDI是一种根据描述文档来引导系统查找相应服务的机制。UDDI利用SOAP消息机制(标准的XML/HTTP)来发布,编辑,浏览以及查找注册信息。它采用XML格式来封装各种不同类型的数据,并且发送到注册中心或者由注册中心来返回需要的数据。
概念补充:
http soap关系
http:是一个客户端和服务器端请求和应答的标准(TCP)。http协议其目的是为了提供一种发布和接收htttp页面的方法
一http协议的客户端与服务器的交互:由HTTP客户端发起一个请求,建立一个到服务器指定端口(默认是80端口)的TCP连接。HTTP服务器则在那个端口监听客户端发送过来的请求。一旦收到请求,服务器(向客户端)发回一个状态行,比如"HTTP/1.1 200 OK",和(响应的)消息,消息的消息体可能是请求的文件、错误消息、或者其它一些信息。
soap 协议:它描述了一种在分散或分布式的环境中如何交换信息的轻量级协议。soap在http协议的基础上,一个基于XML的协议。 不同:都是底层的通信协议,请求包的格式不同而已,soap包是XML格式,http纯文本格式。
关系:SOAP是个通信协议, SOAP在HTTP协议的基础上,把编写成XML的REQUEST参数, 放在HTTP BODY上提交个WEB SERVICE服务器(SERVLET,ASP什么的) 处理完成后,结果也写成XML作为RESPONSE送回用户端, 为了使用户端和WEB SERVICE可以相互对应,可以使用WSDL作为这种通信方式的描述文件,利用WSDL工具可以自动生成WS和用户端的框架文件,SOAP具备把复杂对象序列化捆绑到XML里去的能力。 Membrane SOAP Monitor,这个soap监听工具。这是德国的一家在线web服务注册公司predic8做的开源soap监听工具,简单好用。
windows下最新的版本为1.1.2版,下载地址:
http://mirror.predic8.com/membrane/monitor/win86/membrane-monitor-win86-1.1.2.zip
还有linux下的版本:
http://download.predic8.com/membrane/monitor/linux-x86/membrane-monitor-linux-x86-0.9.4.tgz
源码:
http://download.predic8.com/membrane/monitor/src/membrane-monitor-src-0.9.4.zip
具体使用:
1) 运行exe文件(linux下可能是jar文件);
2) 点击菜单项membrane->add rule ,进入后默认选项即可,点next;
3) 设置端口号(不产生冲突的任意端口),点next;
4) 设置主机及端口(部署服务的地址及服务器的端口),完成。 当调用网上发布的服务时,如检查qq是否在线的服务: http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?wsdl
可将4)中的host设为远端服务的网址,如www.webxml.com.cn,端口设为服务的端口,上面就是80端口。
当我们监听soap消息时,只要访问了web服务,即可在membrane的界面显示发送及接受的soap消息
XML Web Service的特点
二、Web Service开发
.net平台内建了对Web Service的支持,包括Web Service的构建和使用。与其它开发平台不同,使用.net平台,你不需要其他的工具或者SDK就可以完成Web Service的开发了。.net Framework本身就全面支持Web Service,包括服务器端的请求处理器和对客户端发送和接受SOAP消息的支持。下来我们就一步一步的用Microsoft Visual Studio .net 20058(后面简称VS.Net 2008)创建和使用一个简单的Web Service。
2.1、用创建一个最简单的Web Service
首先,打开VS2005,打开"文件-新建-网站",选择"ASP.NET Web服务"查看Service.cs代码,你会发现VS.Net 2005已经为Web Service文件建立了缺省的框架。原始代码为:
默认工程里面已经有一个Hello World的方法了
namespace WebService1 {
/// <summary>
/// Service1 的摘要说明 /// </summary>
[WebService(Namespace = "http://tempuri.org/")]
//用于向 XML Web services 添加附加信息,如描述其功能的字符串。
//对于将要发布和执行的 XML Web services 来说,WebServiceAttribute 不是
//可以使用 WebServiceAttribute 为 XML Web services 指定不受公共语言运 //XML Web services 在成为公共之前,应该更改其默认的 XML 命名空间。
//每个 XML Web services 都需要唯一的 XML 命名空间来标识它,以便客户端的 XML Web services,
//但是已发布的 XML Web services 应该使用更具永久性的命名空间。例如,可
//虽然很多 XML Web services 的 XML 命名空间与 URL 很相似,但是,它们无
用 ASP.NET 创建的 XML Web services,可以使用 Namespace 属性更改默认的[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]//Confor
//声明定义一个或多个 XML Web services 方法的绑定。无法继承此类。
//按 Web 服务描述语言 (WSDL) 的定义,绑定类似于一个接口,原因是它定义
//每个 XML Web services 方法都是特定绑定中的一项操作。XML Web service
//或者是在应用于实现 XML Web services 的类的 WebServiceBindingAttribu
//XML Web services 可以通过将多个 WebServiceBindingAttribute 属性应用
//将一个或多个 WebServiceAttribute 属性应用到 XML Web services 之后,services 方法
//以指示由特定的 XML Web services 方法实现的绑定操作。
//设置 SoapDocumentMethodAttribute 或 SoapRpcMethodAttribute 的 Binding 属
[System.ComponentModel.ToolboxItem(false)]//提供工具箱项的基实现。
// 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务,请取消对下行的注 // [System.Web.Script.Services.ScriptService]
public class Service1 : System.Web.Services.WebService//
//表示此网站项目实现的一个 Web 服务,如同将此网站引用添加到项目时以 Visua {
[WebMethod]//向使用 ASP.NET 创建的 XML Web services 中的某个方法添//初始化 WebMethodAttribute 类的新实例。
public string HelloWorld()
{
return "Hello World"; } } }
点击"调用"按钮,就可以看到用XML格式返回的Web Service结果下图。说明我们的Web Service环境没有问题,而且还初步接触了一下最简单的Web Service。
2.2、创建一个简单带有功能的Web Service
上面我们宏观的了解了webservice,其实它就是个对外的接口,里面有函数可供外部客户调用(注意:里面同样有客户不可调用的函数).假若我们是服务端,我们写好了个webservice,然后把它给了客户(同时我们给了他们调用规则),客户就可以在从服务端获取信息时处于一个相对透明的状态.即是客户不了解(也不需要)其过程,他们只获取数据.在代码文件里,如果我们写了一个函数后,希望此函数成为外部可调用的接口函数,我们必须在函数上面添上一行代码
[WebMethod(Description="函数的描述信息")],如果你的函数没有这个申明,它将不能被用户引用.下来我们开始编写一个简单的Web Service 的例子。
if (j != 0) return i / j; else return 0; } }
using System; using System.Linq; using System.Web; using System.Web.Services;
using System.Web.Services.Protocols; using System.Xml.Linq;
[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)] // 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务,请取消对下行的注释。
// [System.Web.Script.Services.ScriptService] public class Service : System.Web.Services.WebService {
public Service () {
//如果使用设计的组件,请取消注释以下行 //InitializeComponent();
}
//[WebMethod]
//public string HelloWorld() //{
// return "Hello World"; //}
[WebMethod(Description = "求和的方法")] public double addition(double i, double j) {
return i + j; }
[WebMethod(Description = "求差的方法")] public double subtract(double i, double j) {
return i - j; }
[WebMethod(Description = "求积的方法")] public double multiplication(double i, double j) {
return i * j; }
[WebMethod(Description = "求商的方法")]
public double division(double i, double j) {
if (j != 0) return i / j; else return 0; } }
运行可以看到我们自己写的可以被调用的方法
相关文章推荐
- c# 操作webservice(经典入门教程+MSDN必胜)(有自己修改的部分)
- MongoDB入门教程之C#驱动操作实例
- MongoDB入门教程之C#驱动操作实例
- MongoDB入门教程之C#驱动操作实例
- bpel 经典实例入门教程
- bpel 经典实例入门教程
- Photoshop完全自学入门与经典实例全视频教程(更新完毕)
- C#使用MySQLDriverCS操作MySQL实例教程代码
- Webservice入门简单实例 教程
- 简明教程 C# Webservice实例
- WebService入门系列教程-简单的WebSercice实例
- WebService入门实例项目详细教程(图)
- WebService入门实例项目详细教程(图)
- Spring Batch入门实例教程实现对CVS文件的操作
- 从零开始学习 webservice第一集,java webservice简单实例入门教程
- c#经典编程实例(ado.net基本操作)
- Pylons 入门实例教程 – 数据库操作
- Javascript教程,javascript入门,javascript学习笔记(经典实例)
- C#操作XML简要教程(经典文章值的一读)
- Photoshop完全自学入门与经典实例全视频教程(更新完毕)