首页 > 代码库 > Web Service基本概念

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 协议:它描述了一种在分散或分布式的环境中如何交换信息的轻量级协议。soaphttp协议的基础上,一个基于XML的协议。

不同:都是底层的通信协议,请求包的格式不同而已,soap包是XML格式,http纯文本格式。

关系:SOAP是个通信协议, SOAPHTTP协议的基础上,把编写成XMLREQUEST参数, 放在HTTP BODY上提交个WEB SERVICE服务器(SERVLETASP什么的) 处理完成后,结果也写成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.NETWeb服务"

 

查看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 Web services 在成为公共之前,应该更改其默认的 XML 命名空间。

    //每个 XML Web services 都需要唯一的 XML 命名空间来标识它,以便客户端应用程序能够将它与网络上的其他服务区分开来。http://tempuri.org/ 可用于正在开发中的 XML Web services,

    //但是已发布的 XML Web services 应该使用更具永久性的命名空间。例如,可以将公司的 Internet 域名作为 XML 命名空间的一部分。

    //虽然很多 XML Web services 的 XML 命名空间与 URL 很相似,但是,它们无需指向 Web 上的某一实际资源。(XML Web services 的 XML 命名空间是 URI。)对于使用 ASP.NET 创建的 XML Web services,可以使用 Namespace 属性更改默认的 XML 命名空间。

 

 

    [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]//ConformsTo  获取或设置绑定声称所符合的 Web 服务互操作性 (WSI) 规范。

 

    //声明定义一个或多个 XML Web services 方法的绑定。无法继承此类。

    //按 Web 服务描述语言 (WSDL) 的定义,绑定类似于一个接口,原因是它定义一组具体的操作。

    //每个 XML Web services 方法都是特定绑定中的一项操作。XML Web services 方法是 XML Web services 的默认绑定的成员,

    //或者是在应用于实现 XML Web services 的类的 WebServiceBindingAttribute 中指定的绑定的成员。

    //XML Web services 可以通过将多个 WebServiceBindingAttribute 属性应用于 XML Web services 来实现多个绑定。

    //将一个或多个 WebServiceAttribute 属性应用到 XML Web services 之后,可以将 SoapDocumentMethodAttribute 或 SoapRpcMethodAttribute 应用到各个 XML Web services 方法

//以指示由特定的 XML Web services 方法实现的绑定操作。

//设置 SoapDocumentMethodAttribute 或 SoapRpcMethodAttribute 的 Binding 属性以指定 XML Web services 方法正在为其实现操作的绑定。

 

    [System.ComponentModel.ToolboxItem(false)]//提供工具箱项的基实现。

    // 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务,请取消对下行的注释。

    // [System.Web.Script.Services.ScriptService]

    public class Service1 : System.Web.Services.WebService//

//表示此网站项目实现的一个 Web 服务,如同将此网站引用添加到项目时以 Visual Studio 生成的 .asmx 文件表示一样。

    {

 

        [WebMethod]//向使用 ASP.NET 创建的 XML Web services 中的某个方法添加此属性 (Attribute) 后,就可以从远程 Web 客户端调用该方法。无法继承此类。

//初始化 WebMethodAttribute 类的新实例。

        public string HelloWorld()

        {

            return "Hello World";

        }

    }

}

 

直接运行看看效果,

 

点击显示页面上图中的"HelloWorld"超链接,跳转到下一页面:

 

点击"调用"按钮,就可以看到用XML格式返回的Web Service结果下图。说明我们的Web Service环境没有问题,而且还初步接触了一下最简单的Web Service。

2.2、创建一个简单带有功能的Web Service

上面我们宏观的了解了webservice,其实它就是个对外的接口,里面有函数可供外部客户调用(注意:里面同样有客户不可调用的函数).假若我们是服务端,我们写好了个webservice,然后把它给了客户(同时我们给了他们调用规则),客户就可以在从服务端获取信息时处于一个相对透明的状态.即是客户不了解(也不需要)其过程,他们只获取数据.在代码文件里,如果我们写了一个函数后,希望此函数成为外部可调用的接口函数,我们必须在函数上面添上一行代码[WebMethod(Description="函数的描述信息")],如果你的函数没有这个申明,它将不能被用户引用.下来我们开始编写一个简单的Web Service 的例子。

先把默认的HelloWorld方法注释掉,简单的写了求加减乘除运算的四个方法;

view plaincopy to clipboardprint?
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 "HelloWorld";   
    //}   
    [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, doublej)   
    {   
        return i * j;   
    }   
    [WebMethod(Description = "求商的方法")]   
    public double division(double i, double j)   
    {   
        if (j != 0)   
            return i /j;   
        else  
            return0;   
    }   
}  
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;
    }
}

运行可以看到我们自己写的可以被调用的方法,如下图:

 

同样点击addition方法,进入addition方法的调用页。

 

在参数上面输入参数i=3,j=3,如上图,点击调用,就可以看到用XML格式返回的Web Service结果(i与j相加的结果)下图

到这里,我们会发现,其实webservice并不是那么的神秘,它也不过只是个接口,对我们而言,侧重点就是是接口函数的编写.

2.3、用ASP.NET调用Web Service
首先,打开VS2005,打开"文件-新建-网站",选择"ASP.NET网站"。

 

选好存储位置,语言后点击确定,进入默认页面。然后先添加Web引用,把WebService引到当前的工程里面。方法是:在资源管理器中点击右键,选择添加Web 引用,调出对话框:

 

在URL中填入,前面写好的WebService运行后浏览器上面显示的地址(即:WebService发布后的访问地址 ),点击"前往"按钮,如上图,就会显示出所引用的WebService中可以调用的方法,然后点击"添加引用",就将webservice引用到了当前的工程里面 ,如下图,解决方案中会出现引进来的WebService文件

 

我们在这就练习调用webservice的四个方法,做一个简单的调用的例子,先在网站的前台添加几个控件,代码如下:

view plaincopy to clipboardprint?
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default"%>   
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">   
<html xmlns="http://www.w3.org/1999/xhtml">   
<head runat="server">   
    <title>无标题页</title>   
</head>   
<body>   
    <form id="form1"runat="server">   
    <div>   
        <asp:TextBox ID="Num1"runat="server"></asp:TextBox>   
            <select id="selectOper" runat ="server">   
                <option>+</option>   
                <option>-</option>   
                <option>*</option>   
                <option>/</option>   
            </select>   
            <asp:TextBox ID="Num2"runat="server"></asp:TextBox>   
        <asp:ButtonID="Button1" runat="server" Text="="onclick="Button1_Click" />   
            <asp:TextBox ID="Result"runat="server"></asp:TextBox>   
    </div>   
    </form>   
</body>   
</html>  
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>无标题页</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:TextBox ID="Num1"runat="server"></asp:TextBox>
            <select id="selectOper" runat = "server">
                <option>+</option>
                <option>-</option>
                <option>*</option>
                <option>/</option>
            </select>
            <asp:TextBox ID="Num2"runat="server"></asp:TextBox>
        <asp:ButtonID="Button1" runat="server" Text="="onclick="Button1_Click" />
            <asp:TextBox ID="Result" runat="server"></asp:TextBox>
    </div>
    </form>
</body>
</html>

然后在后台写调用的代码,调用之前和使用其它的对象一样,要先实例化,实例化的方法是localhost.Service a = new localhost.Service();然后就可以通过a来访问WebService里面提供的方法了。在这个例子里面,动态的创建了一个button控件来触发WebService的调用,后台代码如下:
运行后可以看到效果,如下图所示,在前面两个Textbox里面输入两个操作数,在中间的下拉列表中选择操作符,然后点击"="号,将计算的结果输出到第三个Textbox里面。

 

而整个计算并不是在本地进行的,是在Web服务端进行计算的然后将结果通过XML返还给了调用方的,所以,在运行该程序的时候,WebService程序还必须启动,否则会报无法连接远程服务器的异常,如下图:

 

后台代码如下:

view plaincopy to clipboardprint?
using System;   
using System.Configuration;   
using System.Data;   
using System.Linq;   
using System.Web;   
using System.Web.Security;   
using System.Web.UI;   
using System.Web.UI.HtmlControls;   
using System.Web.UI.WebControls;   
using System.Web.UI.WebControls.WebParts;   
using System.Xml.Linq;   
public partial class _Default : System.Web.UI.Page    
{   
    protected void Page_Load(object sender, EventArgse)   
    {   
    }   
    protected void Button1_Click(object sender, EventArgse)   
    {   
        string selectFlag =selectOper.Value;   
        localhost.Service web = new localhost.Service();   
        if(selectFlag.Equals("+"))   
        {   
            Result.Text=(web.addition(double.Parse(Num1.Text),double.Parse(Num2.Text))).ToString();   
        }   
        else if(selectFlag.Equals("-"))   
        {   
            Result.Text= (web.subtract(double.Parse(Num1.Text),double.Parse(Num2.Text))).ToString();   
        }   
        else if(selectFlag.Equals("*"))   
        {   
            Result.Text= (web.multiplication(double.Parse(Num1.Text), double.Parse(Num2.Text))).ToString();   
        }   
        else if(selectFlag.Equals("/"))   
        {   
            Result.Text= (web.division(double.Parse(Num1.Text),double.Parse(Num2.Text))).ToString();   
        }   
    }   
}  
using System;
using System.Configuration;
using System.Data;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Xml.Linq;
public partial class _Default : System.Web.UI.Page 
{
    protected void Page_Load(object sender, EventArgs e)
    {
    }
    protected void Button1_Click(object sender, EventArgs e)
    {
        string selectFlag =selectOper.Value;
        localhost.Service web = newlocalhost.Service();
        if(selectFlag.Equals("+"))
        {
            Result.Text=(web.addition(double.Parse(Num1.Text),double.Parse(Num2.Text))).ToString();
        }
        else if(selectFlag.Equals("-"))
        {
            Result.Text= (web.subtract(double.Parse(Num1.Text), double.Parse(Num2.Text))).ToString();
        }
        else if(selectFlag.Equals("*"))
        {
            Result.Text= (web.multiplication(double.Parse(Num1.Text),double.Parse(Num2.Text))).ToString();
        }
        else if(selectFlag.Equals("/"))
        {
            Result.Text= (web.division(double.Parse(Num1.Text), double.Parse(Num2.Text))).ToString();
        }
    }
}

到此一个一个简单的WebService的开发和调用就已经完成了,在实际应用中可以根据自己的需要,写一些功能强大的,复杂的WebService,不管多么复杂,整个流程都是这样的

 

Web Service基本概念